diff --git a/.travis.yml b/.travis.yml index 0b34640df16..518d4d4437c 100644 --- a/.travis.yml +++ b/.travis.yml @@ -26,6 +26,9 @@ matrix: - os: linux sudo: required go: 1.10.x + - os: linux + sudo: required + go: 1.11.x - os: linux sudo: required go: tip @@ -37,6 +40,8 @@ matrix: go: 1.9.x - os: osx go: 1.10.x + - os: osx + go: 1.11.x - os: osx go: tip diff --git a/CHANGELOG.md b/CHANGELOG.md index e5f3f8f1ba7..0b327cc05f3 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,3 +1,48 @@ +Release v1.15.55 (2018-10-15) +=== + +### Service Client Updates +* `service/lambda`: Updates service API and documentation + * Documentation updates for lambda +* `service/rds`: Updates service API and documentation + * This release adds a new parameter to specify the DB instance or cluster parameter group for restore from DB snapshot and restore to point int time operations. For more information, see Amazon RDS Documentation. +* `service/servicecatalog`: Updates service API, documentation, and paginators + * AWS Service Catalog enables you to reduce administrative maintenance and end-user training while adhering to compliance and security measures. With service actions, you as the administrator can enable end users to perform operational tasks, troubleshoot issues, run approved commands, or request permissions within Service Catalog. Service actions are defined using AWS Systems Manager documents, where you have access to pre-defined actions that implement AWS best practices, such asEC2 stop and reboot, as well as the ability to define custom actions. + +Release v1.15.54 (2018-10-12) +=== + +### Service Client Updates +* `service/cloudtrail`: Updates service API and documentation + * The LookupEvents API now supports two new attribute keys: ReadOnly and AccessKeyId + +### SDK Enhancements +* `aws/session`: Add support for credential source(#2201) + * Allows for shared config file to contain `credential_source` with any of the given values `EcsContainer`, `Environment` or `Ec2InstanceMetadata` + +Release v1.15.53 (2018-10-11) +=== + +### Service Client Updates +* `service/athena`: Updates service API and documentation + * 1. GetQueryExecution API changes to return statementType of a submitted Athena query. 2. GetQueryResults API changes to return the number of rows added to a table when a CTAS query is executed. +* `service/directconnect`: Updates service API and documentation + * This release adds support for Jumbo Frames over AWS Direct Connect. You can now set MTU value when creating new virtual interfaces. This release also includes a new API to modify MTU value of existing virtual interfaces. +* `service/ec2`: Updates service API + * You can now launch the smaller-sized G3 instance called g3s.xlarge. G3s.xlarge provides 4 vCPU, 30.5 GB RAM and a NVIDIA Tesla M60 GPU. It is ideal for remote workstations, engineering and architectural applications, and 3D visualizations and rendering for visual effects. +* `service/mediaconvert`: Updates service paginators + * Added Paginators for all the MediaConvert list operations +* `service/transcribe`: Updates service API and documentation + +Release v1.15.52 (2018-10-10) +=== + +### Service Client Updates +* `service/comprehend`: Updates service API +* `service/es`: Updates service API and documentation + * Amazon Elasticsearch Service now supports customer-scheduled service software updates. When new service software becomes available, you can request an update to your domain and benefit from new features more quickly. If you take no action, we update the service software automatically after a certain time frame. +* `service/transcribe`: Updates service API and documentation + Release v1.15.51 (2018-10-09) === diff --git a/Makefile b/Makefile index 1eeb817b755..70d3a52d8e7 100644 --- a/Makefile +++ b/Makefile @@ -85,7 +85,7 @@ ci-test-generate-validate: integration: get-deps-tests integ-custom smoke-tests performance integ-custom: - go test -tags "integration" ./awstesting/integration/customizations/... + go test -tags "integration" -v ./awstesting/integration/customizations/... cleanup-integ: go run -tags "integration" ./awstesting/cmd/bucket_cleanup/main.go "aws-sdk-go-integration" @@ -134,19 +134,26 @@ sandbox-test-go18: sandbox-build-go18 docker run -t aws-sdk-go-1.8 sandbox-build-go19: - docker build -f ./awstesting/sandbox/Dockerfile.test.go1.8 -t "aws-sdk-go-1.9" . + docker build -f ./awstesting/sandbox/Dockerfile.test.go1.9 -t "aws-sdk-go-1.9" . sandbox-go19: sandbox-build-go19 docker run -i -t aws-sdk-go-1.9 bash sandbox-test-go19: sandbox-build-go19 docker run -t aws-sdk-go-1.9 sandbox-build-go110: - docker build -f ./awstesting/sandbox/Dockerfile.test.go1.8 -t "aws-sdk-go-1.10" . + docker build -f ./awstesting/sandbox/Dockerfile.test.go1.10 -t "aws-sdk-go-1.10" . sandbox-go110: sandbox-build-go110 docker run -i -t aws-sdk-go-1.10 bash sandbox-test-go110: sandbox-build-go110 docker run -t aws-sdk-go-1.10 +sandbox-build-go111: + docker build -f ./awstesting/sandbox/Dockerfile.test.go1.11 -t "aws-sdk-go-1.11" . +sandbox-go111: sandbox-build-go111 + docker run -i -t aws-sdk-go-1.11 bash +sandbox-test-go111: sandbox-build-go111 + docker run -t aws-sdk-go-1.11 + sandbox-build-gotip: @echo "Run make update-aws-golang-tip, if this test fails because missing aws-golang:tip container" docker build -f ./awstesting/sandbox/Dockerfile.test.gotip -t "aws-sdk-go-tip" . @@ -193,7 +200,7 @@ get-deps-tests: get-deps-verify: @echo "go get SDK verification utilities" - @if [ \( -z "${SDK_GO_1_4}" \) -a \( -z "${SDK_GO_1_5}" \) ]; then go get github.com/golang/lint/golint; else echo "skipped getting golint"; fi + @if [ \( -z "${SDK_GO_1_4}" \) -a \( -z "${SDK_GO_1_5}" \) ]; then go get golang.org/x/lint/golint; else echo "skipped getting golint"; fi bench: @echo "go bench SDK packages" diff --git a/README.md b/README.md index 3200765ead7..49517bb9cbe 100644 --- a/README.md +++ b/README.md @@ -1,4 +1,4 @@ -[![API Reference](http://img.shields.io/badge/api-reference-blue.svg)](http://docs.aws.amazon.com/sdk-for-go/api) [![Join the chat at https://gitter.im/aws/aws-sdk-go](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/aws/aws-sdk-go?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge) [![Build Status](https://img.shields.io/travis/aws/aws-sdk-go.svg)](https://travis-ci.org/aws/aws-sdk-go) [![Apache V2 License](http://img.shields.io/badge/license-Apache%20V2-blue.svg)](https://github.com/aws/aws-sdk-go/blob/master/LICENSE.txt) +[![API Reference](https://img.shields.io/badge/api-reference-blue.svg)](https://docs.aws.amazon.com/sdk-for-go/api) [![Join the chat at https://gitter.im/aws/aws-sdk-go](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/aws/aws-sdk-go?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge) [![Build Status](https://img.shields.io/travis/aws/aws-sdk-go.svg)](https://travis-ci.org/aws/aws-sdk-go) [![Apache V2 License](https://img.shields.io/badge/license-Apache%20V2-blue.svg)](https://github.com/aws/aws-sdk-go/blob/master/LICENSE.txt) # AWS SDK for Go diff --git a/aws/csm/metric.go b/aws/csm/metric.go index 4b0d630e4c1..6f57024d743 100644 --- a/aws/csm/metric.go +++ b/aws/csm/metric.go @@ -48,4 +48,6 @@ type metric struct { DNSLatency *int `json:"DnsLatency,omitempty"` TCPLatency *int `json:"TcpLatency,omitempty"` SSLLatency *int `json:"SslLatency,omitempty"` + + MaxRetriesExceeded *int `json:"MaxRetriesExceeded,omitempty"` } diff --git a/aws/csm/reporter.go b/aws/csm/reporter.go index 691f8513a46..11861844246 100644 --- a/aws/csm/reporter.go +++ b/aws/csm/reporter.go @@ -112,15 +112,16 @@ func (rep *Reporter) sendAPICallMetric(r *request.Request) { now := time.Now() m := metric{ - ClientID: aws.String(rep.clientID), - API: aws.String(r.Operation.Name), - Service: aws.String(r.ClientInfo.ServiceID), - Timestamp: (*metricTime)(&now), - Type: aws.String("ApiCall"), - AttemptCount: aws.Int(r.RetryCount + 1), - Region: r.Config.Region, - Latency: aws.Int(int(time.Now().Sub(r.Time) / time.Millisecond)), - XAmzRequestID: aws.String(r.RequestID), + ClientID: aws.String(rep.clientID), + API: aws.String(r.Operation.Name), + Service: aws.String(r.ClientInfo.ServiceID), + Timestamp: (*metricTime)(&now), + Type: aws.String("ApiCall"), + AttemptCount: aws.Int(r.RetryCount + 1), + Region: r.Config.Region, + Latency: aws.Int(int(time.Now().Sub(r.Time) / time.Millisecond)), + XAmzRequestID: aws.String(r.RequestID), + MaxRetriesExceeded: aws.Int(boolIntValue(r.RetryCount >= r.MaxRetries())), } // TODO: Probably want to figure something out for logging dropped @@ -230,3 +231,12 @@ func (rep *Reporter) InjectHandlers(handlers *request.Handlers) { handlers.AfterRetry.PushFrontNamed(apiCallAttemptHandler) } + +// boolIntValue return 1 for true and 0 for false. +func boolIntValue(b bool) int { + if b { + return 1 + } + + return 0 +} diff --git a/aws/csm/reporter_internal_test.go b/aws/csm/reporter_internal_test.go new file mode 100644 index 00000000000..43978d25fdc --- /dev/null +++ b/aws/csm/reporter_internal_test.go @@ -0,0 +1,72 @@ +package csm + +import ( + "net/http" + "testing" + + "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/credentials" + "github.com/aws/aws-sdk-go/aws/defaults" + "github.com/aws/aws-sdk-go/aws/request" +) + +func TestMaxRetriesExceeded(t *testing.T) { + md := metadata.ClientInfo{ + Endpoint: "http://127.0.0.1", + } + + cfg := aws.Config{ + Region: aws.String("foo"), + Credentials: credentials.NewStaticCredentials("", "", ""), + } + + op := &request.Operation{} + cases := []struct { + name string + httpStatusCode int + expectedMaxRetriesValue int + expectedMetrics int + }{ + { + name: "max retry reached", + httpStatusCode: http.StatusBadGateway, + expectedMaxRetriesValue: 1, + }, + { + name: "status ok", + httpStatusCode: http.StatusOK, + expectedMaxRetriesValue: 0, + }, + } + + for _, c := range cases { + r := request.New(cfg, md, defaults.Handlers(), client.DefaultRetryer{NumMaxRetries: 2}, op, nil, nil) + reporter := newReporter("", "") + r.Handlers.Send.Clear() + reporter.InjectHandlers(&r.Handlers) + + r.Handlers.Send.PushBack(func(r *request.Request) { + r.HTTPResponse = &http.Response{ + StatusCode: c.httpStatusCode, + } + }) + r.Send() + + for { + m := <-reporter.metricsCh.ch + + if *m.Type != "ApiCall" { + // ignore non-ApiCall metrics since MaxRetriesExceeded is only on ApiCall events + continue + } + + if val := *m.MaxRetriesExceeded; val != c.expectedMaxRetriesValue { + t.Errorf("%s: expected %d, but received %d", c.name, c.expectedMaxRetriesValue, val) + } + + break + } + } +} diff --git a/aws/csm/reporter_test.go b/aws/csm/reporter_test.go index 4a1001983f8..eb804d0f21d 100644 --- a/aws/csm/reporter_test.go +++ b/aws/csm/reporter_test.go @@ -2,7 +2,6 @@ package csm_test import ( "fmt" - "net" "net/http" "net/http/httptest" "strings" @@ -18,41 +17,6 @@ import ( "github.com/aws/aws-sdk-go/private/protocol/jsonrpc" ) -func startUDPServer(done chan struct{}, fn func([]byte)) (string, error) { - addr, err := net.ResolveUDPAddr("udp", "127.0.0.1:0") - if err != nil { - return "", err - } - - conn, err := net.ListenUDP("udp", addr) - if err != nil { - return "", err - } - - buf := make([]byte, 1024) - i := 0 - go func() { - defer conn.Close() - for { - i++ - select { - case <-done: - return - default: - } - - n, _, err := conn.ReadFromUDP(buf) - fn(buf[:n]) - - if err != nil { - panic(err) - } - } - }() - - return conn.LocalAddr().String(), nil -} - func TestReportingMetrics(t *testing.T) { reporter := csm.Get() if reporter == nil { diff --git a/aws/defaults/defaults.go b/aws/defaults/defaults.go index 6cd84cd96de..23bb639e018 100644 --- a/aws/defaults/defaults.go +++ b/aws/defaults/defaults.go @@ -24,6 +24,7 @@ import ( "github.com/aws/aws-sdk-go/aws/ec2metadata" "github.com/aws/aws-sdk-go/aws/endpoints" "github.com/aws/aws-sdk-go/aws/request" + "github.com/aws/aws-sdk-go/internal/shareddefaults" ) // A Defaults provides a collection of default values for SDK clients. @@ -114,7 +115,6 @@ func CredProviders(cfg *aws.Config, handlers request.Handlers) []credentials.Pro const ( httpProviderAuthorizationEnvVar = "AWS_CONTAINER_AUTHORIZATION_TOKEN" httpProviderEnvVar = "AWS_CONTAINER_CREDENTIALS_FULL_URI" - ecsCredsProviderEnvVar = "AWS_CONTAINER_CREDENTIALS_RELATIVE_URI" ) // RemoteCredProvider returns a credentials provider for the default remote @@ -124,8 +124,8 @@ func RemoteCredProvider(cfg aws.Config, handlers request.Handlers) credentials.P return localHTTPCredProvider(cfg, handlers, u) } - if uri := os.Getenv(ecsCredsProviderEnvVar); len(uri) > 0 { - u := fmt.Sprintf("http://169.254.170.2%s", uri) + if uri := os.Getenv(shareddefaults.ECSCredsProviderEnvVar); len(uri) > 0 { + u := fmt.Sprintf("%s%s", shareddefaults.ECSContainerCredentialsURI, uri) return httpCredProvider(cfg, handlers, u) } diff --git a/aws/defaults/defaults_test.go b/aws/defaults/defaults_test.go index 8a0e491f276..8c1319c43bb 100644 --- a/aws/defaults/defaults_test.go +++ b/aws/defaults/defaults_test.go @@ -10,6 +10,7 @@ import ( "github.com/aws/aws-sdk-go/aws/credentials/ec2rolecreds" "github.com/aws/aws-sdk-go/aws/credentials/endpointcreds" "github.com/aws/aws-sdk-go/aws/request" + "github.com/aws/aws-sdk-go/internal/shareddefaults" ) func TestHTTPCredProvider(t *testing.T) { @@ -90,7 +91,7 @@ func TestHTTPCredProvider(t *testing.T) { func TestECSCredProvider(t *testing.T) { defer os.Clearenv() - os.Setenv(ecsCredsProviderEnvVar, "/abc/123") + os.Setenv(shareddefaults.ECSCredsProviderEnvVar, "/abc/123") provider := RemoteCredProvider(aws.Config{}, request.Handlers{}) if provider == nil { diff --git a/aws/session/session.go b/aws/session/session.go index 51f30556301..5d7b289501b 100644 --- a/aws/session/session.go +++ b/aws/session/session.go @@ -19,8 +19,26 @@ import ( "github.com/aws/aws-sdk-go/aws/defaults" "github.com/aws/aws-sdk-go/aws/endpoints" "github.com/aws/aws-sdk-go/aws/request" + "github.com/aws/aws-sdk-go/internal/shareddefaults" ) +const ( + // ErrCodeSharedConfig represents an error that occurs in the shared + // configuration logic + ErrCodeSharedConfig = "SharedConfigErr" +) + +// ErrSharedConfigSourceCollision will be returned if a section contains both +// source_profile and credential_source +var ErrSharedConfigSourceCollision = awserr.New(ErrCodeSharedConfig, "only source profile or credential source can be specified, not both", nil) + +// ErrSharedConfigECSContainerEnvVarEmpty will be returned if the environment +// variables are empty and Environment was set as the credential source +var ErrSharedConfigECSContainerEnvVarEmpty = awserr.New(ErrCodeSharedConfig, "EcsContainer was specified as the credential_source, but 'AWS_CONTAINER_CREDENTIALS_RELATIVE_URI' was not set", nil) + +// ErrSharedConfigInvalidCredSource will be returned if an invalid credential source was provided +var ErrSharedConfigInvalidCredSource = awserr.New(ErrCodeSharedConfig, "credential source values must be EcsContainer, Ec2InstanceMetadata, or Environment", nil) + // A Session provides a central location to create service clients from and // store configurations and request handlers for those services. // @@ -436,6 +454,57 @@ func mergeConfigSrcs(cfg, userCfg *aws.Config, envCfg envConfig, sharedCfg share // Configure credentials if not already set if cfg.Credentials == credentials.AnonymousCredentials && userCfg.Credentials == nil { + + // inspect the profile to see if a credential source has been specified. + if envCfg.EnableSharedConfig && len(sharedCfg.AssumeRole.CredentialSource) > 0 { + + // if both credential_source and source_profile have been set, return an error + // as this is undefined behavior. + if len(sharedCfg.AssumeRole.SourceProfile) > 0 { + return ErrSharedConfigSourceCollision + } + + // valid credential source values + const ( + credSourceEc2Metadata = "Ec2InstanceMetadata" + credSourceEnvironment = "Environment" + credSourceECSContainer = "EcsContainer" + ) + + switch sharedCfg.AssumeRole.CredentialSource { + case credSourceEc2Metadata: + cfgCp := *cfg + p := defaults.RemoteCredProvider(cfgCp, handlers) + cfgCp.Credentials = credentials.NewCredentials(p) + + if len(sharedCfg.AssumeRole.MFASerial) > 0 && sessOpts.AssumeRoleTokenProvider == nil { + // AssumeRole Token provider is required if doing Assume Role + // with MFA. + return AssumeRoleTokenProviderNotSetError{} + } + + cfg.Credentials = assumeRoleCredentials(cfgCp, handlers, sharedCfg, sessOpts) + case credSourceEnvironment: + cfg.Credentials = credentials.NewStaticCredentialsFromCreds( + envCfg.Creds, + ) + case credSourceECSContainer: + if len(os.Getenv(shareddefaults.ECSCredsProviderEnvVar)) == 0 { + return ErrSharedConfigECSContainerEnvVarEmpty + } + + cfgCp := *cfg + p := defaults.RemoteCredProvider(cfgCp, handlers) + creds := credentials.NewCredentials(p) + + cfg.Credentials = creds + default: + return ErrSharedConfigInvalidCredSource + } + + return nil + } + if len(envCfg.Creds.AccessKeyID) > 0 { cfg.Credentials = credentials.NewStaticCredentialsFromCreds( envCfg.Creds, @@ -445,32 +514,14 @@ func mergeConfigSrcs(cfg, userCfg *aws.Config, envCfg envConfig, sharedCfg share cfgCp.Credentials = credentials.NewStaticCredentialsFromCreds( sharedCfg.AssumeRoleSource.Creds, ) + if len(sharedCfg.AssumeRole.MFASerial) > 0 && sessOpts.AssumeRoleTokenProvider == nil { // AssumeRole Token provider is required if doing Assume Role // with MFA. return AssumeRoleTokenProviderNotSetError{} } - cfg.Credentials = stscreds.NewCredentials( - &Session{ - Config: &cfgCp, - Handlers: handlers.Copy(), - }, - sharedCfg.AssumeRole.RoleARN, - func(opt *stscreds.AssumeRoleProvider) { - opt.RoleSessionName = sharedCfg.AssumeRole.RoleSessionName - - // Assume role with external ID - if len(sharedCfg.AssumeRole.ExternalID) > 0 { - opt.ExternalID = aws.String(sharedCfg.AssumeRole.ExternalID) - } - - // Assume role with MFA - if len(sharedCfg.AssumeRole.MFASerial) > 0 { - opt.SerialNumber = aws.String(sharedCfg.AssumeRole.MFASerial) - opt.TokenProvider = sessOpts.AssumeRoleTokenProvider - } - }, - ) + + cfg.Credentials = assumeRoleCredentials(cfgCp, handlers, sharedCfg, sessOpts) } else if len(sharedCfg.Creds.AccessKeyID) > 0 { cfg.Credentials = credentials.NewStaticCredentialsFromCreds( sharedCfg.Creds, @@ -493,6 +544,30 @@ func mergeConfigSrcs(cfg, userCfg *aws.Config, envCfg envConfig, sharedCfg share return nil } +func assumeRoleCredentials(cfg aws.Config, handlers request.Handlers, sharedCfg sharedConfig, sessOpts Options) *credentials.Credentials { + return stscreds.NewCredentials( + &Session{ + Config: &cfg, + Handlers: handlers.Copy(), + }, + sharedCfg.AssumeRole.RoleARN, + func(opt *stscreds.AssumeRoleProvider) { + opt.RoleSessionName = sharedCfg.AssumeRole.RoleSessionName + + // Assume role with external ID + if len(sharedCfg.AssumeRole.ExternalID) > 0 { + opt.ExternalID = aws.String(sharedCfg.AssumeRole.ExternalID) + } + + // Assume role with MFA + if len(sharedCfg.AssumeRole.MFASerial) > 0 { + opt.SerialNumber = aws.String(sharedCfg.AssumeRole.MFASerial) + opt.TokenProvider = sessOpts.AssumeRoleTokenProvider + } + }, + ) +} + // AssumeRoleTokenProviderNotSetError is an error returned when creating a session when the // MFAToken option is not set when shared config is configured load assume a // role with an MFA token. diff --git a/aws/session/session_test.go b/aws/session/session_test.go index 9612b315003..bd0f54e0052 100644 --- a/aws/session/session_test.go +++ b/aws/session/session_test.go @@ -16,6 +16,7 @@ import ( "github.com/aws/aws-sdk-go/aws/defaults" "github.com/aws/aws-sdk-go/aws/endpoints" "github.com/aws/aws-sdk-go/awstesting" + "github.com/aws/aws-sdk-go/internal/shareddefaults" "github.com/aws/aws-sdk-go/service/s3" ) @@ -437,6 +438,228 @@ func TestSessionAssumeRole_InvalidSourceProfile(t *testing.T) { assert.Nil(t, s) } +func TestSharedConfigCredentialSource(t *testing.T) { + cases := []struct { + name string + profile string + expectedError error + expectedAccessKey string + expectedSecretKey string + init func(*aws.Config, string) func() error + }{ + { + name: "env var credential source", + profile: "env_var_credential_source", + expectedAccessKey: "access_key", + expectedSecretKey: "secret_key", + init: func(cfg *aws.Config, profile string) func() error { + os.Setenv("AWS_SDK_LOAD_CONFIG", "1") + os.Setenv("AWS_CONFIG_FILE", "testdata/credential_source_config") + os.Setenv("AWS_PROFILE", profile) + os.Setenv("AWS_ACCESS_KEY", "access_key") + os.Setenv("AWS_SECRET_KEY", "secret_key") + + return func() error { + os.Unsetenv("AWS_SDK_LOAD_CONFIG") + os.Unsetenv("AWS_CONFIG_FILE") + os.Unsetenv("AWS_PROFILE") + os.Unsetenv("AWS_ACCESS_KEY") + os.Unsetenv("AWS_SECRET_KEY") + + return nil + } + }, + }, + { + name: "credential source and source profile", + profile: "invalid_source_and_credential_source", + expectedError: ErrSharedConfigSourceCollision, + init: func(cfg *aws.Config, profile string) func() error { + os.Setenv("AWS_SDK_LOAD_CONFIG", "1") + os.Setenv("AWS_CONFIG_FILE", "testdata/credential_source_config") + os.Setenv("AWS_PROFILE", profile) + os.Setenv("AWS_ACCESS_KEY", "access_key") + os.Setenv("AWS_SECRET_KEY", "secret_key") + + return func() error { + os.Unsetenv("AWS_SDK_LOAD_CONFIG") + os.Unsetenv("AWS_CONFIG_FILE") + os.Unsetenv("AWS_PROFILE") + os.Unsetenv("AWS_ACCESS_KEY") + os.Unsetenv("AWS_SECRET_KEY") + + return nil + } + }, + }, + { + name: "ec2metadata credential source", + profile: "ec2metadata", + expectedAccessKey: "AKID", + expectedSecretKey: "SECRET", + init: func(cfg *aws.Config, profile string) func() error { + os.Setenv("AWS_REGION", "us-east-1") + os.Setenv("AWS_SDK_LOAD_CONFIG", "1") + os.Setenv("AWS_CONFIG_FILE", "testdata/credential_source_config") + os.Setenv("AWS_PROFILE", "ec2metadata") + + const ec2MetadataResponse = `{ + "Code": "Success", + "Type": "AWS-HMAC", + "AccessKeyId" : "access-key", + "SecretAccessKey" : "secret-key", + "Token" : "token", + "Expiration" : "2100-01-01T00:00:00Z", + "LastUpdated" : "2009-11-23T0:00:00Z" + }` + + ec2MetadataCalled := false + ec2MetadataServer := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) { + if r.URL.Path == "/meta-data/iam/security-credentials/RoleName" { + ec2MetadataCalled = true + w.Write([]byte(ec2MetadataResponse)) + } else if r.URL.Path == "/meta-data/iam/security-credentials/" { + w.Write([]byte("RoleName")) + } else { + w.Write([]byte("")) + } + })) + + stsServer := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) { + w.Write([]byte(fmt.Sprintf(assumeRoleRespMsg, time.Now().Add(15*time.Minute).Format("2006-01-02T15:04:05Z")))) + })) + + cfg.EndpointResolver = endpoints.ResolverFunc( + func(service, region string, opts ...func(*endpoints.Options)) (endpoints.ResolvedEndpoint, error) { + if service == "ec2metadata" { + return endpoints.ResolvedEndpoint{ + URL: ec2MetadataServer.URL, + }, nil + } + + return endpoints.ResolvedEndpoint{ + URL: stsServer.URL, + }, nil + }, + ) + + return func() error { + os.Unsetenv("AWS_SDK_LOAD_CONFIG") + os.Unsetenv("AWS_CONFIG_FILE") + os.Unsetenv("AWS_PROFILE") + os.Unsetenv("AWS_REGION") + + ec2MetadataServer.Close() + stsServer.Close() + + if !ec2MetadataCalled { + return fmt.Errorf("expected ec2metadata to be called") + } + + return nil + } + }, + }, + { + name: "ecs container credential source", + profile: "ecscontainer", + expectedAccessKey: "access-key", + expectedSecretKey: "secret-key", + init: func(cfg *aws.Config, profile string) func() error { + os.Setenv("AWS_REGION", "us-east-1") + os.Setenv("AWS_SDK_LOAD_CONFIG", "1") + os.Setenv("AWS_CONFIG_FILE", "testdata/credential_source_config") + os.Setenv("AWS_PROFILE", "ecscontainer") + os.Setenv("AWS_CONTAINER_CREDENTIALS_RELATIVE_URI", "/ECS") + + const ecsResponse = `{ + "Code": "Success", + "Type": "AWS-HMAC", + "AccessKeyId" : "access-key", + "SecretAccessKey" : "secret-key", + "Token" : "token", + "Expiration" : "2100-01-01T00:00:00Z", + "LastUpdated" : "2009-11-23T0:00:00Z" + }` + + ecsCredsCalled := false + ecsMetadataServer := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) { + if r.URL.Path == "/ECS" { + ecsCredsCalled = true + w.Write([]byte(ecsResponse)) + } else { + w.Write([]byte("")) + } + })) + + shareddefaults.ECSContainerCredentialsURI = ecsMetadataServer.URL + + stsServer := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) { + w.Write([]byte(fmt.Sprintf(assumeRoleRespMsg, time.Now().Add(15*time.Minute).Format("2006-01-02T15:04:05Z")))) + })) + + cfg.Endpoint = aws.String(stsServer.URL) + + cfg.EndpointResolver = endpoints.ResolverFunc( + func(service, region string, opts ...func(*endpoints.Options)) (endpoints.ResolvedEndpoint, error) { + fmt.Println("SERVICE", service) + return endpoints.ResolvedEndpoint{ + URL: stsServer.URL, + }, nil + }, + ) + + return func() error { + os.Unsetenv("AWS_SDK_LOAD_CONFIG") + os.Unsetenv("AWS_CONFIG_FILE") + os.Unsetenv("AWS_PROFILE") + os.Unsetenv("AWS_REGION") + os.Unsetenv("AWS_CONTAINER_CREDENTIALS_RELATIVE_URI") + + ecsMetadataServer.Close() + stsServer.Close() + + if !ecsCredsCalled { + return fmt.Errorf("expected ec2metadata to be called") + } + + return nil + } + }, + }, + } + + for _, c := range cases { + cfg := &aws.Config{} + clean := c.init(cfg, c.profile) + sess, err := NewSession(cfg) + if e, a := c.expectedError, err; e != a { + t.Errorf("expected %v, but received %v", e, a) + } + + if c.expectedError != nil { + continue + } + + creds, err := sess.Config.Credentials.Get() + if err != nil { + t.Errorf("expected no error, but received %v", err) + } + + if e, a := c.expectedAccessKey, creds.AccessKeyID; e != a { + t.Errorf("expected %v, but received %v", e, a) + } + + if e, a := c.expectedSecretKey, creds.SecretAccessKey; e != a { + t.Errorf("expected %v, but received %v", e, a) + } + + if err := clean(); err != nil { + t.Errorf("expected no error, but received %v", err) + } + } +} + func initSessionTestEnv() (oldEnv []string) { oldEnv = awstesting.StashEnv() os.Setenv("AWS_CONFIG_FILE", "file_not_exists") diff --git a/aws/session/shared_config.go b/aws/session/shared_config.go index 298437723df..efe17ed366a 100644 --- a/aws/session/shared_config.go +++ b/aws/session/shared_config.go @@ -16,11 +16,12 @@ const ( sessionTokenKey = `aws_session_token` // optional // Assume Role Credentials group - roleArnKey = `role_arn` // group required - sourceProfileKey = `source_profile` // group required - externalIDKey = `external_id` // optional - mfaSerialKey = `mfa_serial` // optional - roleSessionNameKey = `role_session_name` // optional + roleArnKey = `role_arn` // group required + sourceProfileKey = `source_profile` // group required (or credential_source) + credentialSourceKey = `credential_source` // group required (or source_profile) + externalIDKey = `external_id` // optional + mfaSerialKey = `mfa_serial` // optional + roleSessionNameKey = `role_session_name` // optional // Additional Config fields regionKey = `region` @@ -32,11 +33,12 @@ const ( ) type assumeRoleConfig struct { - RoleARN string - SourceProfile string - ExternalID string - MFASerial string - RoleSessionName string + RoleARN string + SourceProfile string + CredentialSource string + ExternalID string + MFASerial string + RoleSessionName string } // sharedConfig represents the configuration fields of the SDK config files. @@ -124,6 +126,13 @@ func loadSharedConfigIniFiles(filenames []string) ([]sharedConfigFile, error) { func (cfg *sharedConfig) setAssumeRoleSource(origProfile string, files []sharedConfigFile) error { var assumeRoleSrc sharedConfig + if len(cfg.AssumeRole.CredentialSource) > 0 { + // setAssumeRoleSource is only called when source_profile is found. + // If both source_profile and credential_source are set, then + // ErrSharedConfigSourceCollision will be returned + return ErrSharedConfigSourceCollision + } + // Multiple level assume role chains are not support if cfg.AssumeRole.SourceProfile == origProfile { assumeRoleSrc = *cfg @@ -192,13 +201,16 @@ func (cfg *sharedConfig) setFromIniFile(profile string, file sharedConfigFile) e // Assume Role roleArn := section.String(roleArnKey) srcProfile := section.String(sourceProfileKey) - if len(roleArn) > 0 && len(srcProfile) > 0 { + credentialSource := section.String(credentialSourceKey) + hasSource := len(srcProfile) > 0 || len(credentialSource) > 0 + if len(roleArn) > 0 && hasSource { cfg.AssumeRole = assumeRoleConfig{ - RoleARN: roleArn, - SourceProfile: srcProfile, - ExternalID: section.String(externalIDKey), - MFASerial: section.String(mfaSerialKey), - RoleSessionName: section.String(roleSessionNameKey), + RoleARN: roleArn, + SourceProfile: srcProfile, + CredentialSource: credentialSource, + ExternalID: section.String(externalIDKey), + MFASerial: section.String(mfaSerialKey), + RoleSessionName: section.String(roleSessionNameKey), } } diff --git a/aws/session/shared_config_test.go b/aws/session/shared_config_test.go index 88eb71d3edf..3bb2f72856e 100644 --- a/aws/session/shared_config_test.go +++ b/aws/session/shared_config_test.go @@ -144,7 +144,6 @@ func TestLoadSharedConfigFromFile(t *testing.T) { if err != nil { t.Fatalf("failed to load test config file, %s, %v", filename, err) } - iniFile := sharedConfigFile{IniData: f, Filename: filename} cases := []struct { diff --git a/aws/session/testdata/credential_source_config b/aws/session/testdata/credential_source_config new file mode 100644 index 00000000000..58b66614ad3 --- /dev/null +++ b/aws/session/testdata/credential_source_config @@ -0,0 +1,16 @@ +[env_var_credential_source] +role_arn = arn +credential_source = Environment + +[invalid_source_and_credential_source] +role_arn = arn +credential_source = Environment +source_profile = env_var_credential_source + +[ec2metadata] +role_arn = assume_role_w_creds_role_arn +credential_source = Ec2InstanceMetadata + +[ecscontainer] +role_arn = assume_role_w_creds_role_arn +credential_source = EcsContainer diff --git a/aws/session/testdata/shared_config b/aws/session/testdata/shared_config index 8705608e10a..fe816fe201b 100644 --- a/aws/session/testdata/shared_config +++ b/aws/session/testdata/shared_config @@ -1,5 +1,5 @@ [default] -s3 = +s3 = unsupported_key=123 other_unsupported=abc diff --git a/aws/version.go b/aws/version.go index e32367f4c81..7a7b37f3734 100644 --- a/aws/version.go +++ b/aws/version.go @@ -5,4 +5,4 @@ package aws const SDKName = "aws-sdk-go" // SDKVersion is the version of this SDK -const SDKVersion = "1.15.51" +const SDKVersion = "1.15.55" diff --git a/awstesting/integration/customizations/s3/s3manager/integration_test.go b/awstesting/integration/customizations/s3/s3manager/integration_test.go index a217b6544e3..e0c280956de 100644 --- a/awstesting/integration/customizations/s3/s3manager/integration_test.go +++ b/awstesting/integration/customizations/s3/s3manager/integration_test.go @@ -7,13 +7,10 @@ import ( "bytes" "crypto/md5" "fmt" - "io" - "os" "regexp" "strings" "testing" - "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/awstesting/integration" @@ -23,120 +20,6 @@ import ( var integBuf12MB = make([]byte, 1024*1024*12) var integMD512MB = fmt.Sprintf("%x", md5.Sum(integBuf12MB)) -var bucketName *string - -func TestMain(m *testing.M) { - if err := setup(); err != nil { - panic(fmt.Sprintf("failed to setup integration test, %v", err)) - } - - var result int - - defer func() { - if err := teardown(); err != nil { - fmt.Fprintf(os.Stderr, "teardown failed, %v", err) - } - if r := recover(); r != nil { - fmt.Println("S3Manager integration test hit a panic,", r) - result = 1 - } - os.Exit(result) - }() - - result = m.Run() -} - -func setup() error { - svc := s3.New(integration.Session) - - // Create a bucket for testing - bucketName = aws.String( - fmt.Sprintf("aws-sdk-go-integration-%s", integration.UniqueID())) - - _, err := svc.CreateBucket(&s3.CreateBucketInput{Bucket: bucketName}) - if err != nil { - return fmt.Errorf("failed to create bucket %q, %v", *bucketName, err) - } - - err = svc.WaitUntilBucketExists(&s3.HeadBucketInput{Bucket: bucketName}) - if err != nil { - return fmt.Errorf("failed to wait for bucket %q to exist, %v", *bucketName, err) - } - - return nil -} - -// Delete the bucket -func teardown() error { - svc := s3.New(integration.Session) - - objs, err := svc.ListObjects(&s3.ListObjectsInput{Bucket: bucketName}) - if err != nil { - return fmt.Errorf("failed to list bucket %q objects, %v", *bucketName, err) - } - - for _, o := range objs.Contents { - svc.DeleteObject(&s3.DeleteObjectInput{Bucket: bucketName, Key: o.Key}) - } - - uploads, err := svc.ListMultipartUploads(&s3.ListMultipartUploadsInput{Bucket: bucketName}) - if err != nil { - return fmt.Errorf("failed to list bucket %q multipart objects, %v", *bucketName, err) - } - - for _, u := range uploads.Uploads { - svc.AbortMultipartUpload(&s3.AbortMultipartUploadInput{ - Bucket: bucketName, - Key: u.Key, - UploadId: u.UploadId, - }) - } - - _, err = svc.DeleteBucket(&s3.DeleteBucketInput{Bucket: bucketName}) - if err != nil { - return fmt.Errorf("failed to delete bucket %q, %v", *bucketName, err) - } - - return nil -} - -type dlwriter struct { - buf []byte -} - -func newDLWriter(size int) *dlwriter { - return &dlwriter{buf: make([]byte, size)} -} - -func (d dlwriter) WriteAt(p []byte, pos int64) (n int, err error) { - if pos > int64(len(d.buf)) { - return 0, io.EOF - } - - written := 0 - for i, b := range p { - if i >= len(d.buf) { - break - } - d.buf[pos+int64(i)] = b - written++ - } - return written, nil -} - -func validate(t *testing.T, key string, md5value string) { - mgr := s3manager.NewDownloader(integration.Session) - params := &s3.GetObjectInput{Bucket: bucketName, Key: &key} - - w := newDLWriter(1024 * 1024 * 20) - n, err := mgr.Download(w, params) - if err != nil { - t.Fatalf("expect no error, got %v", err) - } - if e, a := md5value, fmt.Sprintf("%x", md5.Sum(w.buf[0:n])); e != a { - t.Errorf("expect %s md5 value, got %s", e, a) - } -} func TestUploadConcurrently(t *testing.T) { key := "12mb-1" diff --git a/awstesting/integration/customizations/s3/s3manager/shared_test.go b/awstesting/integration/customizations/s3/s3manager/shared_test.go new file mode 100644 index 00000000000..09068c3a453 --- /dev/null +++ b/awstesting/integration/customizations/s3/s3manager/shared_test.go @@ -0,0 +1,79 @@ +// +build integration + +package s3manager + +import ( + "crypto/md5" + "fmt" + "io" + "os" + "testing" + + "github.com/aws/aws-sdk-go/aws" + "github.com/aws/aws-sdk-go/awstesting/integration" + s3integ "github.com/aws/aws-sdk-go/awstesting/integration/customizations/s3" + "github.com/aws/aws-sdk-go/service/s3" + "github.com/aws/aws-sdk-go/service/s3/s3manager" +) + +var bucketName *string + +func TestMain(m *testing.M) { + svc := s3.New(integration.Session) + bucketName = aws.String(s3integ.GenerateBucketName()) + if err := s3integ.SetupTest(svc, *bucketName); err != nil { + panic(err) + } + + var result int + defer func() { + if err := s3integ.CleanupTest(svc, *bucketName); err != nil { + fmt.Fprintln(os.Stderr, err) + } + if r := recover(); r != nil { + fmt.Fprintln(os.Stderr, "S3 integrationt tests paniced,", r) + result = 1 + } + os.Exit(result) + }() + + result = m.Run() +} + +type dlwriter struct { + buf []byte +} + +func newDLWriter(size int) *dlwriter { + return &dlwriter{buf: make([]byte, size)} +} + +func (d dlwriter) WriteAt(p []byte, pos int64) (n int, err error) { + if pos > int64(len(d.buf)) { + return 0, io.EOF + } + + written := 0 + for i, b := range p { + if i >= len(d.buf) { + break + } + d.buf[pos+int64(i)] = b + written++ + } + return written, nil +} + +func validate(t *testing.T, key string, md5value string) { + mgr := s3manager.NewDownloader(integration.Session) + params := &s3.GetObjectInput{Bucket: bucketName, Key: &key} + + w := newDLWriter(1024 * 1024 * 20) + n, err := mgr.Download(w, params) + if err != nil { + t.Fatalf("expect no error, got %v", err) + } + if e, a := md5value, fmt.Sprintf("%x", md5.Sum(w.buf[0:n])); e != a { + t.Errorf("expect %s md5 value, got %s", e, a) + } +} diff --git a/awstesting/integration/customizations/s3/shared.go b/awstesting/integration/customizations/s3/shared.go new file mode 100644 index 00000000000..cbcf3c122fc --- /dev/null +++ b/awstesting/integration/customizations/s3/shared.go @@ -0,0 +1,93 @@ +// +build integration + +package s3 + +import ( + "fmt" + + "github.com/aws/aws-sdk-go/awstesting/integration" + "github.com/aws/aws-sdk-go/service/s3" +) + +// BucketPrefix is the root prefix of integration test buckets. +const BucketPrefix = "aws-sdk-go-integration" + +// GenerateBucketName returns a unique bucket name. +func GenerateBucketName() string { + return fmt.Sprintf("%s-%s", + BucketPrefix, integration.UniqueID()) +} + +// SetupTest returns a test bucket created for the integration tests. +func SetupTest(svc *s3.S3, bucketName string) (err error) { + + fmt.Println("Setup: Creating test bucket,", bucketName) + _, err = svc.CreateBucket(&s3.CreateBucketInput{Bucket: &bucketName}) + if err != nil { + return fmt.Errorf("failed to create bucket %s, %v", bucketName, err) + } + + fmt.Println("Setup: Waiting for bucket to exist,", bucketName) + err = svc.WaitUntilBucketExists(&s3.HeadBucketInput{Bucket: &bucketName}) + if err != nil { + return fmt.Errorf("failed waiting for bucket %s to be created, %v", + bucketName, err) + } + + return nil +} + +// CleanupTest deletes the contents of a S3 bucket, before deleting the bucket +// it self. +func CleanupTest(svc *s3.S3, bucketName string) error { + errs := []error{} + + fmt.Println("TearDown: Deleting objects from test bucket,", bucketName) + err := svc.ListObjectsPages( + &s3.ListObjectsInput{Bucket: &bucketName}, + func(page *s3.ListObjectsOutput, lastPage bool) bool { + for _, o := range page.Contents { + _, err := svc.DeleteObject(&s3.DeleteObjectInput{ + Bucket: &bucketName, + Key: o.Key, + }) + if err != nil { + errs = append(errs, err) + } + } + return true + }, + ) + if err != nil { + return fmt.Errorf("failed to list objects, %s, %v", bucketName, err) + } + + fmt.Println("TearDown: Deleting partial uploads from test bucket,", bucketName) + err = svc.ListMultipartUploadsPages( + &s3.ListMultipartUploadsInput{Bucket: &bucketName}, + func(page *s3.ListMultipartUploadsOutput, lastPage bool) bool { + for _, u := range page.Uploads { + svc.AbortMultipartUpload(&s3.AbortMultipartUploadInput{ + Bucket: &bucketName, + Key: u.Key, + UploadId: u.UploadId, + }) + } + return true + }, + ) + if err != nil { + return fmt.Errorf("failed to list multipart objects, %s, %v", bucketName, err) + } + + if len(errs) != 0 { + return fmt.Errorf("failed to delete objects, %s", errs) + } + + fmt.Println("TearDown: Deleting test bucket,", bucketName) + if _, err = svc.DeleteBucket(&s3.DeleteBucketInput{Bucket: &bucketName}); err != nil { + return fmt.Errorf("failed to delete test bucket, %s", bucketName) + } + + return nil +} diff --git a/awstesting/integration/customizations/s3/shared_test.go b/awstesting/integration/customizations/s3/shared_test.go index 58ef0042bdc..1bb0628ec66 100644 --- a/awstesting/integration/customizations/s3/shared_test.go +++ b/awstesting/integration/customizations/s3/shared_test.go @@ -19,52 +19,25 @@ var bucketName *string var svc *s3.S3 func TestMain(m *testing.M) { - setup() - defer teardown() // only called if we panic - - result := m.Run() - teardown() - os.Exit(result) -} - -// Create a bucket for testing -func setup() { svc = s3.New(integration.Session) - bucketName = aws.String( - fmt.Sprintf("%s-%s", - integBucketPrefix, integration.UniqueID())) - - _, err := svc.CreateBucket(&s3.CreateBucketInput{Bucket: bucketName}) - if err != nil { - panic(fmt.Sprintf("failed to create bucket %s, %v", *bucketName, err)) - } - - err = svc.WaitUntilBucketExists(&s3.HeadBucketInput{Bucket: bucketName}) - if err != nil { - panic(fmt.Sprintf("failed waiting for bucket %s to be created", *bucketName)) - } -} - -// Delete the bucket -func teardown() { - resp, err := svc.ListObjects(&s3.ListObjectsInput{Bucket: bucketName}) - if err != nil { - panic(fmt.Sprintf("failed to list s3 bucket %s objects, %v", *bucketName, err)) + bucketName = aws.String(GenerateBucketName()) + if err := SetupTest(svc, *bucketName); err != nil { + panic(err) } - errs := []error{} - for _, o := range resp.Contents { - _, err = svc.DeleteObject(&s3.DeleteObjectInput{Bucket: bucketName, Key: o.Key}) - if err != nil { - errs = append(errs, err) + var result int + defer func() { + if err := CleanupTest(svc, *bucketName); err != nil { + fmt.Fprintln(os.Stderr, err) } - } - - if len(errs) != 0 { - panic(fmt.Sprintf("failed to delete objects, %s", errs)) - } + if r := recover(); r != nil { + fmt.Fprintln(os.Stderr, "S3 integrationt tests paniced,", r) + result = 1 + } + os.Exit(result) + }() - svc.DeleteBucket(&s3.DeleteBucketInput{Bucket: bucketName}) + result = m.Run() } func putTestFile(t *testing.T, filename, key string) { diff --git a/awstesting/sandbox/Dockerfile.test.go1.11 b/awstesting/sandbox/Dockerfile.test.go1.11 new file mode 100644 index 00000000000..0e6710e1773 --- /dev/null +++ b/awstesting/sandbox/Dockerfile.test.go1.11 @@ -0,0 +1,11 @@ +FROM ubuntu:12.04 +FROM golang:1.11 + +ADD . /go/src/github.com/aws/aws-sdk-go + +RUN apt-get update && apt-get install -y --no-install-recommends \ + vim \ + && rm -rf /var/list/apt/lists/* + +WORKDIR /go/src/github.com/aws/aws-sdk-go +CMD ["make", "unit"] diff --git a/internal/shareddefaults/ecs_container.go b/internal/shareddefaults/ecs_container.go new file mode 100644 index 00000000000..b63e4c2639b --- /dev/null +++ b/internal/shareddefaults/ecs_container.go @@ -0,0 +1,12 @@ +package shareddefaults + +const ( + // ECSCredsProviderEnvVar is an environmental variable key used to + // determine which path needs to be hit. + ECSCredsProviderEnvVar = "AWS_CONTAINER_CREDENTIALS_RELATIVE_URI" +) + +// ECSContainerCredentialsURI is the endpoint to retrieve container +// credentials. This can be overriden to test to ensure the credential process +// is behaving correctly. +var ECSContainerCredentialsURI = "http://169.254.170.2" diff --git a/models/apis/athena/2017-05-18/api-2.json b/models/apis/athena/2017-05-18/api-2.json index b0d7c07acd1..2daa16b7837 100644 --- a/models/apis/athena/2017-05-18/api-2.json +++ b/models/apis/athena/2017-05-18/api-2.json @@ -6,6 +6,7 @@ "jsonVersion":"1.1", "protocol":"json", "serviceFullName":"Amazon Athena", + "serviceId":"Athena", "signatureVersion":"v4", "targetPrefix":"AmazonAthena", "uid":"athena-2017-05-18" @@ -337,6 +338,7 @@ "GetQueryResultsOutput":{ "type":"structure", "members":{ + "UpdateCount":{"shape":"Long"}, "ResultSet":{"shape":"ResultSet"}, "NextToken":{"shape":"Token"} } @@ -446,6 +448,7 @@ "members":{ "QueryExecutionId":{"shape":"QueryExecutionId"}, "Query":{"shape":"QueryString"}, + "StatementType":{"shape":"StatementType"}, "ResultConfiguration":{"shape":"ResultConfiguration"}, "QueryExecutionContext":{"shape":"QueryExecutionContext"}, "Status":{"shape":"QueryExecutionStatus"}, @@ -553,6 +556,14 @@ "QueryExecutionId":{"shape":"QueryExecutionId"} } }, + "StatementType":{ + "type":"string", + "enum":[ + "DDL", + "DML", + "UTILITY" + ] + }, "StopQueryExecutionInput":{ "type":"structure", "required":["QueryExecutionId"], diff --git a/models/apis/athena/2017-05-18/docs-2.json b/models/apis/athena/2017-05-18/docs-2.json index fc6ef23eb7f..f6b5447259d 100644 --- a/models/apis/athena/2017-05-18/docs-2.json +++ b/models/apis/athena/2017-05-18/docs-2.json @@ -1,6 +1,6 @@ { "version": "2.0", - "service": "

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 in the Amazon Athena User Guide.

For code samples using the AWS SDK for Java, see Examples and Code Samples in the Amazon Athena User Guide.

", + "service": "

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 in the Amazon Athena User Guide.

If you connect to Athena using the JDBC driver, use version 1.1.0 of the driver or later with the Amazon Athena API. Earlier version drivers do not support the API. For more information and to download the driver, see Accessing Amazon Athena with JDBC.

For code samples using the AWS SDK for Java, see Examples and Code Samples in the Amazon Athena User Guide.

", "operations": { "BatchGetNamedQuery": "

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.

", "BatchGetQueryExecution": "

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.

", @@ -50,7 +50,7 @@ "ColumnInfoList": { "base": null, "refs": { - "ResultSetMetadata$ColumnInfo": "

Information about the columns in a query execution result.

" + "ResultSetMetadata$ColumnInfo": "

Information about the columns returned in a query result metadata.

" } }, "ColumnNullable": { @@ -108,9 +108,9 @@ } }, "EncryptionConfiguration": { - "base": "

If query results are encrypted in Amazon S3, indicates the Amazon S3 encryption option used.

", + "base": "

If query results are encrypted in Amazon S3, indicates the encryption option used (for example, SSE-KMS or CSE-KMS) and key information.

", "refs": { - "ResultConfiguration$EncryptionConfiguration": "

If query results are encrypted in S3, indicates the S3 encryption option used (for example, SSE-KMS or CSE-KMS and key information.

" + "ResultConfiguration$EncryptionConfiguration": "

If query results are encrypted in Amazon S3, indicates the encryption option used (for example, SSE-KMS or CSE-KMS) and key information.

" } }, "EncryptionOption": { @@ -120,7 +120,7 @@ } }, "ErrorCode": { - "base": null, + "base": "

The error code returned when the query execution failed to process, or when the processing request for the named query failed.

", "refs": { "InvalidRequestException$AthenaErrorCode": null, "UnprocessedNamedQueryId$ErrorCode": "

The error code returned when the processing request for the named query failed, if applicable.

", @@ -214,6 +214,7 @@ "Long": { "base": null, "refs": { + "GetQueryResultsOutput$UpdateCount": "

The number of rows inserted with a CREATE TABLE AS SELECT statement.

", "QueryExecutionStatistics$EngineExecutionTimeInMillis": "

The number of milliseconds that the query took to execute.

", "QueryExecutionStatistics$DataScannedInBytes": "

The number of bytes in the data that was queried.

" } @@ -316,13 +317,13 @@ "QueryExecutionState": { "base": null, "refs": { - "QueryExecutionStatus$State": "

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.

" + "QueryExecutionStatus$State": "

The state of query execution. QUEUED state is listed but is not used by Athena and is reserved for future use. RUNNING indicates that the query has been submitted to the service, and Athena will execute the query as soon as resources are available. 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.

" } }, "QueryExecutionStatistics": { - "base": "

The amount of data scanned during the query execution and the amount of time that it took to execute.

", + "base": "

The amount of data scanned during the query execution and the amount of time that it took to execute, and the type of statement that was run.

", "refs": { - "QueryExecution$Statistics": "

The amount of data scanned during the query execution and the amount of time that it took to execute.

" + "QueryExecution$Statistics": "

The amount of data scanned during the query execution and the amount of time that it took to execute, and the type of statement that was run.

" } }, "QueryExecutionStatus": { @@ -354,7 +355,7 @@ } }, "ResultSetMetadata": { - "base": "

The metadata that describes the column structure and data types of a table of query results.

", + "base": "

The metadata that describes the column structure and data types of a table of query results.

", "refs": { "ResultSet$ResultSetMetadata": "

The metadata that describes the column structure and data types of a table of query results.

" } @@ -381,6 +382,12 @@ "refs": { } }, + "StatementType": { + "base": null, + "refs": { + "QueryExecution$StatementType": "

The type of query statement that was run. DDL indicates DDL query statements. DML indicates DML (Data Manipulation Language) query statements, such as CREATE TABLE AS SELECT. UTILITY indicates query statements other than DDL and DML, such as SHOW CREATE TABLE, or DESCRIBE <table>.

" + } + }, "StopQueryExecutionInput": { "base": null, "refs": { @@ -402,11 +409,11 @@ "ColumnInfo$Type": "

The data type of the column.

", "EncryptionConfiguration$KmsKey": "

For SSE-KMS and CSE-KMS, this is the KMS key ARN or ID.

", "QueryExecutionStatus$StateChangeReason": "

Further detail about the status of the query.

", - "ResultConfiguration$OutputLocation": "

The location in S3 where query results are stored.

" + "ResultConfiguration$OutputLocation": "

The location in Amazon S3 where your query results are stored, such as s3://path/to/query/bucket/. For more information, see Queries and Query Result Files.

" } }, "ThrottleReason": { - "base": null, + "base": "

The reason for the query throttling, for example, when it exceeds the concurrent query limit.

", "refs": { "TooManyRequestsException$Reason": null } @@ -423,7 +430,7 @@ } }, "TooManyRequestsException": { - "base": "

Indicates that the request was throttled.

", + "base": "

Indicates that the request was throttled and includes the reason for throttling, for example, the limit of concurrent queries has been exceeded.

", "refs": { } }, diff --git a/models/apis/athena/2017-05-18/smoke.json b/models/apis/athena/2017-05-18/smoke.json new file mode 100644 index 00000000000..a3c06685f79 --- /dev/null +++ b/models/apis/athena/2017-05-18/smoke.json @@ -0,0 +1,11 @@ +{ + "version": 1, + "defaultRegion": "us-west-2", + "testCases": [ + { + "operationName": "ListNamedQueries", + "input": {}, + "errorExpectedFromService": false + } + ] +} diff --git a/models/apis/cloudtrail/2013-11-01/api-2.json b/models/apis/cloudtrail/2013-11-01/api-2.json index d1dccdbf47e..8e3d88701c9 100644 --- a/models/apis/cloudtrail/2013-11-01/api-2.json +++ b/models/apis/cloudtrail/2013-11-01/api-2.json @@ -7,6 +7,7 @@ "protocol":"json", "serviceAbbreviation":"CloudTrail", "serviceFullName":"AWS CloudTrail", + "serviceId":"CloudTrail", "signatureVersion":"v4", "targetPrefix":"com.amazonaws.cloudtrail.v20131101.CloudTrail_20131101", "uid":"cloudtrail-2013-11-01" @@ -389,6 +390,8 @@ "members":{ "EventId":{"shape":"String"}, "EventName":{"shape":"String"}, + "ReadOnly":{"shape":"String"}, + "AccessKeyId":{"shape":"String"}, "EventTime":{"shape":"Date"}, "EventSource":{"shape":"String"}, "Username":{"shape":"String"}, @@ -634,10 +637,12 @@ "enum":[ "EventId", "EventName", + "ReadOnly", "Username", "ResourceType", "ResourceName", - "EventSource" + "EventSource", + "AccessKeyId" ] }, "LookupAttributesList":{ diff --git a/models/apis/cloudtrail/2013-11-01/docs-2.json b/models/apis/cloudtrail/2013-11-01/docs-2.json index 52ebcfafe52..c168d8abf9b 100644 --- a/models/apis/cloudtrail/2013-11-01/docs-2.json +++ b/models/apis/cloudtrail/2013-11-01/docs-2.json @@ -6,12 +6,12 @@ "CreateTrail": "

Creates a trail that specifies the settings for delivery of log data to an Amazon S3 bucket. A maximum of five trails can exist in a region, irrespective of the region in which they were created.

", "DeleteTrail": "

Deletes a trail. This operation must be called from the region in which the trail was created. DeleteTrail cannot be called on the shadow trails (replicated trails in other regions) of a trail that is enabled in all regions.

", "DescribeTrails": "

Retrieves settings for the trail associated with the current region for your account.

", - "GetEventSelectors": "

Describes the settings for the event selectors that you configured for your trail. The information returned for your event selectors includes the following:

For more information, see Logging Data and Management Events for Trails in the AWS CloudTrail User Guide.

", + "GetEventSelectors": "

Describes the settings for the event selectors that you configured for your trail. The information returned for your event selectors includes the following:

For more information, see Logging Data and Management Events for Trails in the AWS CloudTrail User Guide.

", "GetTrailStatus": "

Returns a JSON-formatted list of information about the specified trail. Fields include information on delivery errors, Amazon SNS and Amazon S3 errors, and start and stop logging times for each trail. This operation returns trail status from a single region. To return trail status from all regions, you must call the operation on each region.

", "ListPublicKeys": "

Returns all public keys whose private keys were used to sign the digest files within the specified time range. The public key is needed to validate digest files that were signed with its corresponding private key.

CloudTrail uses different private/public key pairs per region. Each digest file is signed with a private key unique to its region. Therefore, when you validate a digest file from a particular region, you must look in the same region for its corresponding public key.

", "ListTags": "

Lists the tags for the trail in the current region.

", - "LookupEvents": "

Looks up API activity events captured by CloudTrail that create, update, or delete resources in your account. Events for a region can be looked up for the times in which you had CloudTrail turned on in that region during the last seven days. Lookup supports the following attributes:

All attributes are optional. The default number of results returned is 10, with a maximum of 50 possible. The response includes a token that you can use to get the next page of results.

The rate of lookup requests is limited to one per second per account. If this limit is exceeded, a throttling error occurs.

Events that occurred during the selected time range will not be available for lookup if CloudTrail logging was not enabled when the events occurred.

", - "PutEventSelectors": "

Configures an event selector for your trail. Use event selectors to specify whether you want your trail to log management and/or data events. When an event occurs in your account, CloudTrail evaluates the event selectors in all trails. For each trail, if the event matches any event selector, the trail processes and logs the event. If the event doesn't match any event selector, the trail doesn't log the event.

Example

  1. You create an event selector for a trail and specify that you want write-only events.

  2. The EC2 GetConsoleOutput and RunInstances API operations occur in your account.

  3. CloudTrail evaluates whether the events match your event selectors.

  4. The RunInstances is a write-only event and it matches your event selector. The trail logs the event.

  5. The GetConsoleOutput is a read-only event but it doesn't match your event selector. The trail doesn't log the event.

The PutEventSelectors operation must be called from the region in which the trail was created; otherwise, an InvalidHomeRegionException is thrown.

You can configure up to five event selectors for each trail. For more information, see Logging Data and Management Events for Trails in the AWS CloudTrail User Guide.

", + "LookupEvents": "

Looks up management events captured by CloudTrail. Events for a region can be looked up in that region during the last 90 days. Lookup supports the following attributes:

All attributes are optional. The default number of results returned is 50, with a maximum of 50 possible. The response includes a token that you can use to get the next page of results.

The rate of lookup requests is limited to one per second per account. If this limit is exceeded, a throttling error occurs.

Events that occurred during the selected time range will not be available for lookup if CloudTrail logging was not enabled when the events occurred.

", + "PutEventSelectors": "

Configures an event selector for your trail. Use event selectors to further specify the management and data event settings for your trail. By default, trails created without specific event selectors will be configured to log all read and write management events, and no data events.

When an event occurs in your account, CloudTrail evaluates the event selectors in all trails. For each trail, if the event matches any event selector, the trail processes and logs the event. If the event doesn't match any event selector, the trail doesn't log the event.

Example

  1. You create an event selector for a trail and specify that you want write-only events.

  2. The EC2 GetConsoleOutput and RunInstances API operations occur in your account.

  3. CloudTrail evaluates whether the events match your event selectors.

  4. The RunInstances is a write-only event and it matches your event selector. The trail logs the event.

  5. The GetConsoleOutput is a read-only event but it doesn't match your event selector. The trail doesn't log the event.

The PutEventSelectors operation must be called from the region in which the trail was created; otherwise, an InvalidHomeRegionException is thrown.

You can configure up to five event selectors for each trail. For more information, see Logging Data and Management Events for Trails and Limits in AWS CloudTrail in the AWS CloudTrail User Guide.

", "RemoveTags": "

Removes the specified tags from a trail.

", "StartLogging": "

Starts the recording of AWS API calls and log file delivery for a trail. For a trail that is enabled in all regions, this operation must be called from the region in which the trail was created. This operation cannot be called on the shadow trails (replicated trails in other regions) of a trail that is enabled in all regions.

", "StopLogging": "

Suspends the recording of AWS API calls and log file delivery for the specified trail. Under most circumstances, there is no need to use this action. You can update a trail without stopping it first. This action is the only way to stop recording. For a trail enabled in all regions, this operation must be called from the region in which the trail was created, or an InvalidHomeRegionException will occur. This operation cannot be called on the shadow trails (replicated trails in other regions) of a trail enabled in all regions.

", @@ -59,7 +59,7 @@ } }, "CloudTrailARNInvalidException": { - "base": "

This exception is thrown when an operation is called with an invalid trail ARN. The format of a trail ARN is:

arn:aws:cloudtrail:us-east-1:123456789012:trail/MyTrail

", + "base": "

This exception is thrown when an operation is called with an invalid trail ARN. The format of a trail ARN is:

arn:aws:cloudtrail:us-east-2:123456789012:trail/MyTrail

", "refs": { } }, @@ -79,7 +79,7 @@ } }, "DataResource": { - "base": "

The Amazon S3 objects that you specify in your event selectors for your trail to log data events. Data events are object-level API operations that access S3 objects, such as GetObject, DeleteObject, and PutObject. You can specify up to 250 S3 buckets and object prefixes for a trail.

Example

  1. You create an event selector for a trail and specify an S3 bucket and an empty prefix, such as arn:aws:s3:::bucket-1/.

  2. You upload an image file to bucket-1.

  3. The PutObject API operation occurs on an object in the S3 bucket that you specified in the event selector. The trail processes and logs the event.

  4. You upload another image file to a different S3 bucket named arn:aws:s3:::bucket-2.

  5. The event occurs on an object in an S3 bucket that you didn't specify in the event selector. The trail doesn’t log the event.

", + "base": "

The Amazon S3 buckets or AWS Lambda functions that you specify in your event selectors for your trail to log data events. Data events provide insight into the resource operations performed on or within a resource itself. These are also known as data plane operations. You can specify up to 250 data resources for a trail.

The total number of allowed data resources is 250. This number can be distributed between 1 and 5 event selectors, but the total cannot exceed 250 across all selectors.

The following example demonstrates how logging works when you configure logging of all data events for an S3 bucket named bucket-1. In this example, the CloudTrail user spcified an empty prefix, and the option to log both Read and Write data events.

  1. A user uploads an image file to bucket-1.

  2. The PutObject API operation is an Amazon S3 object-level API. It is recorded as a data event in CloudTrail. Because the CloudTrail user specified an S3 bucket with an empty prefix, events that occur on any object in that bucket are logged. The trail processes and logs the event.

  3. A user uploads an object to an Amazon S3 bucket named arn:aws:s3:::bucket-2.

  4. The PutObject API operation occurred for an object in an S3 bucket that the CloudTrail user didn't specify for the trail. The trail doesn’t log the event.

The following example demonstrates how logging works when you configure logging of AWS Lambda data events for a Lambda function named MyLambdaFunction, but not for all AWS Lambda functions.

  1. A user runs a script that includes a call to the MyLambdaFunction function and the MyOtherLambdaFunction function.

  2. The Invoke API operation on MyLambdaFunction is an AWS Lambda API. It is recorded as a data event in CloudTrail. Because the CloudTrail user specified logging data events for MyLambdaFunction, any invocations of that function are logged. The trail processes and logs the event.

  3. The Invoke API operation on MyOtherLambdaFunction is an AWS Lambda API. Because the CloudTrail user did not specify logging data events for all Lambda functions, the Invoke operation for MyOtherLambdaFunction does not match the function specified for the trail. The trail doesn’t log the event.

", "refs": { "DataResources$member": null } @@ -87,13 +87,13 @@ "DataResourceValues": { "base": null, "refs": { - "DataResource$Values": "

A list of ARN-like strings for the specified S3 objects.

To log data events for all objects in an S3 bucket, specify the bucket and an empty object prefix such as arn:aws:s3:::bucket-1/. The trail logs data events for all objects in this S3 bucket.

To log data events for specific objects, specify the S3 bucket and object prefix such as arn:aws:s3:::bucket-1/example-images. The trail logs data events for objects in this S3 bucket that match the prefix.

" + "DataResource$Values": "

An array of Amazon Resource Name (ARN) strings or partial ARN strings for the specified objects.

" } }, "DataResources": { "base": null, "refs": { - "EventSelector$DataResources": "

CloudTrail supports logging only data events for S3 objects. You can specify up to 250 S3 buckets and object prefixes for a trail.

For more information, see Data Events in the AWS CloudTrail User Guide.

" + "EventSelector$DataResources": "

CloudTrail supports data event logging for Amazon S3 objects and AWS Lambda functions. You can specify up to 250 resources for an individual event selector, but the total number of data resources cannot exceed 250 across all event selectors in a trail. This limit does not apply if you configure resource logging for all data events.

For more information, see Data Events and Limits in AWS CloudTrail in the AWS CloudTrail User Guide.

" } }, "Date": { @@ -141,7 +141,7 @@ } }, "EventSelector": { - "base": "

Use event selectors to specify whether you want your trail to log management and/or data events. When an event occurs in your account, CloudTrail evaluates the event selector for all trails. For each trail, if the event matches any event selector, the trail processes and logs the event. If the event doesn't match any event selector, the trail doesn't log the event.

You can configure up to five event selectors for a trail.

", + "base": "

Use event selectors to further specify the management and data event settings for your trail. By default, trails created without specific event selectors will be configured to log all read and write management events, and no data events. When an event occurs in your account, CloudTrail evaluates the event selector for all trails. For each trail, if the event matches any event selector, the trail processes and logs the event. If the event doesn't match any event selector, the trail doesn't log the event.

You can configure up to five event selectors for a trail.

", "refs": { "EventSelectors$member": null } @@ -206,7 +206,7 @@ } }, "InvalidEventSelectorsException": { - "base": "

This exception is thrown when the PutEventSelectors operation is called with an invalid number of event selectors, data resources, or an invalid value for a parameter:

", + "base": "

This exception is thrown when the PutEventSelectors operation is called with a number of event selectors or data resources that is not valid. The combination of event selectors and data resources is not valid. A trail can have up to 5 event selectors. A trail is limited to 250 data resources. These data resources can be distributed across event selectors, but the overall total cannot exceed 250.

You can:

", "refs": { } }, @@ -341,7 +341,7 @@ "MaxResults": { "base": null, "refs": { - "LookupEventsRequest$MaxResults": "

The number of events to return. Possible values are 1 through 50. The default is 10.

" + "LookupEventsRequest$MaxResults": "

The number of events to return. Possible values are 1 through 50. The default is 50.

" } }, "MaximumNumberOfTrailsExceededException": { @@ -408,7 +408,7 @@ "ResourceIdList": { "base": null, "refs": { - "ListTagsRequest$ResourceIdList": "

Specifies a list of trail ARNs whose tags will be listed. The list has a limit of 20 ARNs. The format of a trail ARN is:

arn:aws:cloudtrail:us-east-1:123456789012:trail/MyTrail

" + "ListTagsRequest$ResourceIdList": "

Specifies a list of trail ARNs whose tags will be listed. The list has a limit of 20 ARNs. The format of a trail ARN is:

arn:aws:cloudtrail:us-east-2:123456789012:trail/MyTrail

" } }, "ResourceList": { @@ -467,34 +467,36 @@ "String": { "base": null, "refs": { - "AddTagsRequest$ResourceId": "

Specifies the ARN of the trail to which one or more tags will be added. The format of a trail ARN is:

arn:aws:cloudtrail:us-east-1:123456789012:trail/MyTrail

", + "AddTagsRequest$ResourceId": "

Specifies the ARN of the trail to which one or more tags will be added. The format of a trail ARN is:

arn:aws:cloudtrail:us-east-2:123456789012:trail/MyTrail

", "CreateTrailRequest$Name": "

Specifies the name of the trail. The name must meet the following requirements:

", "CreateTrailRequest$S3BucketName": "

Specifies the name of the Amazon S3 bucket designated for publishing log files. See Amazon S3 Bucket Naming Requirements.

", "CreateTrailRequest$S3KeyPrefix": "

Specifies the Amazon S3 key prefix that comes after the name of the bucket you have designated for log file delivery. For more information, see Finding Your CloudTrail Log Files. The maximum length is 200 characters.

", "CreateTrailRequest$SnsTopicName": "

Specifies the name of the Amazon SNS topic defined for notification of log file delivery. The maximum length is 256 characters.

", "CreateTrailRequest$CloudWatchLogsLogGroupArn": "

Specifies a log group name using an Amazon Resource Name (ARN), a unique identifier that represents the log group to which CloudTrail logs will be delivered. Not required unless you specify CloudWatchLogsRoleArn.

", "CreateTrailRequest$CloudWatchLogsRoleArn": "

Specifies the role for the CloudWatch Logs endpoint to assume to write to a user's log group.

", - "CreateTrailRequest$KmsKeyId": "

Specifies the KMS key ID to use to encrypt the logs delivered by CloudTrail. The value can be an alias name prefixed by \"alias/\", a fully specified ARN to an alias, a fully specified ARN to a key, or a globally unique identifier.

Examples:

", + "CreateTrailRequest$KmsKeyId": "

Specifies the KMS key ID to use to encrypt the logs delivered by CloudTrail. The value can be an alias name prefixed by \"alias/\", a fully specified ARN to an alias, a fully specified ARN to a key, or a globally unique identifier.

Examples:

", "CreateTrailResponse$Name": "

Specifies the name of the trail.

", "CreateTrailResponse$S3BucketName": "

Specifies the name of the Amazon S3 bucket designated for publishing log files.

", "CreateTrailResponse$S3KeyPrefix": "

Specifies the Amazon S3 key prefix that comes after the name of the bucket you have designated for log file delivery. For more information, see Finding Your CloudTrail Log Files.

", "CreateTrailResponse$SnsTopicName": "

This field is deprecated. Use SnsTopicARN.

", - "CreateTrailResponse$SnsTopicARN": "

Specifies the ARN of the Amazon SNS topic that CloudTrail uses to send notifications when log files are delivered. The format of a topic ARN is:

arn:aws:sns:us-east-1:123456789012:MyTopic

", - "CreateTrailResponse$TrailARN": "

Specifies the ARN of the trail that was created. The format of a trail ARN is:

arn:aws:cloudtrail:us-east-1:123456789012:trail/MyTrail

", + "CreateTrailResponse$SnsTopicARN": "

Specifies the ARN of the Amazon SNS topic that CloudTrail uses to send notifications when log files are delivered. The format of a topic ARN is:

arn:aws:sns:us-east-2:123456789012:MyTopic

", + "CreateTrailResponse$TrailARN": "

Specifies the ARN of the trail that was created. The format of a trail ARN is:

arn:aws:cloudtrail:us-east-2:123456789012:trail/MyTrail

", "CreateTrailResponse$CloudWatchLogsLogGroupArn": "

Specifies the Amazon Resource Name (ARN) of the log group to which CloudTrail logs will be delivered.

", "CreateTrailResponse$CloudWatchLogsRoleArn": "

Specifies the role for the CloudWatch Logs endpoint to assume to write to a user's log group.

", - "CreateTrailResponse$KmsKeyId": "

Specifies the KMS key ID that encrypts the logs delivered by CloudTrail. The value is a fully specified ARN to a KMS key in the format:

arn:aws:kms:us-east-1:123456789012:key/12345678-1234-1234-1234-123456789012

", - "DataResource$Type": "

The resource type in which you want to log data events. You can specify only the following value: AWS::S3::Object.

", + "CreateTrailResponse$KmsKeyId": "

Specifies the KMS key ID that encrypts the logs delivered by CloudTrail. The value is a fully specified ARN to a KMS key in the format:

arn:aws:kms:us-east-2:123456789012:key/12345678-1234-1234-1234-123456789012

", + "DataResource$Type": "

The resource type in which you want to log data events. You can specify AWS::S3::Object or AWS::Lambda::Function resources.

", "DataResourceValues$member": null, - "DeleteTrailRequest$Name": "

Specifies the name or the CloudTrail ARN of the trail to be deleted. The format of a trail ARN is: arn:aws:cloudtrail:us-east-1:123456789012:trail/MyTrail

", + "DeleteTrailRequest$Name": "

Specifies the name or the CloudTrail ARN of the trail to be deleted. The format of a trail ARN is: arn:aws:cloudtrail:us-east-2:123456789012:trail/MyTrail

", "Event$EventId": "

The CloudTrail ID of the event returned.

", "Event$EventName": "

The name of the event returned.

", + "Event$ReadOnly": "

Information about whether the event is a write event or a read event.

", + "Event$AccessKeyId": "

The AWS access key ID that was used to sign the request. If the request was made with temporary security credentials, this is the access key ID of the temporary credentials.

", "Event$EventSource": "

The AWS service that the request was made to.

", "Event$Username": "

A user name or role name of the requester that called the API in the event returned.

", "Event$CloudTrailEvent": "

A JSON string that contains a representation of the event returned.

", - "GetEventSelectorsRequest$TrailName": "

Specifies the name of the trail or trail ARN. If you specify a trail name, the string must meet the following requirements:

If you specify a trail ARN, it must be in the format:

arn:aws:cloudtrail:us-east-1:123456789012:trail/MyTrail

", + "GetEventSelectorsRequest$TrailName": "

Specifies the name of the trail or trail ARN. If you specify a trail name, the string must meet the following requirements:

If you specify a trail ARN, it must be in the format:

arn:aws:cloudtrail:us-east-2:123456789012:trail/MyTrail

", "GetEventSelectorsResponse$TrailARN": "

The specified trail ARN that has the event selectors.

", - "GetTrailStatusRequest$Name": "

Specifies the name or the CloudTrail ARN of the trail for which you are requesting status. To get the status of a shadow trail (a replication of the trail in another region), you must specify its ARN. The format of a trail ARN is:

arn:aws:cloudtrail:us-east-1:123456789012:trail/MyTrail

", + "GetTrailStatusRequest$Name": "

Specifies the name or the CloudTrail ARN of the trail for which you are requesting status. To get the status of a shadow trail (a replication of the trail in another region), you must specify its ARN. The format of a trail ARN is:

arn:aws:cloudtrail:us-east-2:123456789012:trail/MyTrail

", "GetTrailStatusResponse$LatestDeliveryError": "

Displays any Amazon S3 error that CloudTrail encountered when attempting to deliver log files to the designated bucket. For more information see the topic Error Responses in the Amazon S3 API Reference.

This error occurs only when there is a problem with the destination S3 bucket and will not occur for timeouts. To resolve the issue, create a new bucket and call UpdateTrail to specify the new bucket, or fix the existing objects so that CloudTrail can again write to the bucket.

", "GetTrailStatusResponse$LatestNotificationError": "

Displays any Amazon SNS error that CloudTrail encountered when attempting to send a notification. For more information about Amazon SNS errors, see the Amazon SNS Developer Guide.

", "GetTrailStatusResponse$LatestCloudWatchLogsDeliveryError": "

Displays any CloudWatch Logs error that CloudTrail encountered when attempting to deliver logs to CloudWatch Logs.

", @@ -511,44 +513,44 @@ "ListTagsResponse$NextToken": "

Reserved for future use.

", "LookupAttribute$AttributeValue": "

Specifies a value for the specified AttributeKey.

", "PublicKey$Fingerprint": "

The fingerprint of the public key.

", - "PutEventSelectorsRequest$TrailName": "

Specifies the name of the trail or trail ARN. If you specify a trail name, the string must meet the following requirements:

If you specify a trail ARN, it must be in the format:

arn:aws:cloudtrail:us-east-1:123456789012:trail/MyTrail

", - "PutEventSelectorsResponse$TrailARN": "

Specifies the ARN of the trail that was updated with event selectors. The format of a trail ARN is:

arn:aws:cloudtrail:us-east-1:123456789012:trail/MyTrail

", - "RemoveTagsRequest$ResourceId": "

Specifies the ARN of the trail from which tags should be removed. The format of a trail ARN is:

arn:aws:cloudtrail:us-east-1:123456789012:trail/MyTrail

", + "PutEventSelectorsRequest$TrailName": "

Specifies the name of the trail or trail ARN. If you specify a trail name, the string must meet the following requirements:

If you specify a trail ARN, it must be in the format:

arn:aws:cloudtrail:us-east-2:123456789012:trail/MyTrail

", + "PutEventSelectorsResponse$TrailARN": "

Specifies the ARN of the trail that was updated with event selectors. The format of a trail ARN is:

arn:aws:cloudtrail:us-east-2:123456789012:trail/MyTrail

", + "RemoveTagsRequest$ResourceId": "

Specifies the ARN of the trail from which tags should be removed. The format of a trail ARN is:

arn:aws:cloudtrail:us-east-2:123456789012:trail/MyTrail

", "Resource$ResourceType": "

The type of a resource referenced by the event returned. When the resource type cannot be determined, null is returned. Some examples of resource types are: Instance for EC2, Trail for CloudTrail, DBInstance for RDS, and AccessKey for IAM. For a list of resource types supported for event lookup, see Resource Types Supported for Event Lookup.

", "Resource$ResourceName": "

The name of the resource referenced by the event returned. These are user-created names whose values will depend on the environment. For example, the resource name might be \"auto-scaling-test-group\" for an Auto Scaling Group or \"i-1234567\" for an EC2 Instance.

", "ResourceIdList$member": null, "ResourceTag$ResourceId": "

Specifies the ARN of the resource.

", - "StartLoggingRequest$Name": "

Specifies the name or the CloudTrail ARN of the trail for which CloudTrail logs AWS API calls. The format of a trail ARN is:

arn:aws:cloudtrail:us-east-1:123456789012:trail/MyTrail

", - "StopLoggingRequest$Name": "

Specifies the name or the CloudTrail ARN of the trail for which CloudTrail will stop logging AWS API calls. The format of a trail ARN is:

arn:aws:cloudtrail:us-east-1:123456789012:trail/MyTrail

", + "StartLoggingRequest$Name": "

Specifies the name or the CloudTrail ARN of the trail for which CloudTrail logs AWS API calls. The format of a trail ARN is:

arn:aws:cloudtrail:us-east-2:123456789012:trail/MyTrail

", + "StopLoggingRequest$Name": "

Specifies the name or the CloudTrail ARN of the trail for which CloudTrail will stop logging AWS API calls. The format of a trail ARN is:

arn:aws:cloudtrail:us-east-2:123456789012:trail/MyTrail

", "Tag$Key": "

The key in a key-value pair. The key must be must be no longer than 128 Unicode characters. The key must be unique for the resource to which it applies.

", "Tag$Value": "

The value in a key-value pair of a tag. The value must be no longer than 256 Unicode characters.

", "Trail$Name": "

Name of the trail set by calling CreateTrail. The maximum length is 128 characters.

", "Trail$S3BucketName": "

Name of the Amazon S3 bucket into which CloudTrail delivers your trail files. See Amazon S3 Bucket Naming Requirements.

", "Trail$S3KeyPrefix": "

Specifies the Amazon S3 key prefix that comes after the name of the bucket you have designated for log file delivery. For more information, see Finding Your CloudTrail Log Files.The maximum length is 200 characters.

", "Trail$SnsTopicName": "

This field is deprecated. Use SnsTopicARN.

", - "Trail$SnsTopicARN": "

Specifies the ARN of the Amazon SNS topic that CloudTrail uses to send notifications when log files are delivered. The format of a topic ARN is:

arn:aws:sns:us-east-1:123456789012:MyTopic

", + "Trail$SnsTopicARN": "

Specifies the ARN of the Amazon SNS topic that CloudTrail uses to send notifications when log files are delivered. The format of a topic ARN is:

arn:aws:sns:us-east-2:123456789012:MyTopic

", "Trail$HomeRegion": "

The region in which the trail was created.

", - "Trail$TrailARN": "

Specifies the ARN of the trail. The format of a trail ARN is:

arn:aws:cloudtrail:us-east-1:123456789012:trail/MyTrail

", + "Trail$TrailARN": "

Specifies the ARN of the trail. The format of a trail ARN is:

arn:aws:cloudtrail:us-east-2:123456789012:trail/MyTrail

", "Trail$CloudWatchLogsLogGroupArn": "

Specifies an Amazon Resource Name (ARN), a unique identifier that represents the log group to which CloudTrail logs will be delivered.

", "Trail$CloudWatchLogsRoleArn": "

Specifies the role for the CloudWatch Logs endpoint to assume to write to a user's log group.

", - "Trail$KmsKeyId": "

Specifies the KMS key ID that encrypts the logs delivered by CloudTrail. The value is a fully specified ARN to a KMS key in the format:

arn:aws:kms:us-east-1:123456789012:key/12345678-1234-1234-1234-123456789012

", + "Trail$KmsKeyId": "

Specifies the KMS key ID that encrypts the logs delivered by CloudTrail. The value is a fully specified ARN to a KMS key in the format:

arn:aws:kms:us-east-2:123456789012:key/12345678-1234-1234-1234-123456789012

", "TrailNameList$member": null, - "UpdateTrailRequest$Name": "

Specifies the name of the trail or trail ARN. If Name is a trail name, the string must meet the following requirements:

If Name is a trail ARN, it must be in the format:

arn:aws:cloudtrail:us-east-1:123456789012:trail/MyTrail

", + "UpdateTrailRequest$Name": "

Specifies the name of the trail or trail ARN. If Name is a trail name, the string must meet the following requirements:

If Name is a trail ARN, it must be in the format:

arn:aws:cloudtrail:us-east-2:123456789012:trail/MyTrail

", "UpdateTrailRequest$S3BucketName": "

Specifies the name of the Amazon S3 bucket designated for publishing log files. See Amazon S3 Bucket Naming Requirements.

", "UpdateTrailRequest$S3KeyPrefix": "

Specifies the Amazon S3 key prefix that comes after the name of the bucket you have designated for log file delivery. For more information, see Finding Your CloudTrail Log Files. The maximum length is 200 characters.

", "UpdateTrailRequest$SnsTopicName": "

Specifies the name of the Amazon SNS topic defined for notification of log file delivery. The maximum length is 256 characters.

", "UpdateTrailRequest$CloudWatchLogsLogGroupArn": "

Specifies a log group name using an Amazon Resource Name (ARN), a unique identifier that represents the log group to which CloudTrail logs will be delivered. Not required unless you specify CloudWatchLogsRoleArn.

", "UpdateTrailRequest$CloudWatchLogsRoleArn": "

Specifies the role for the CloudWatch Logs endpoint to assume to write to a user's log group.

", - "UpdateTrailRequest$KmsKeyId": "

Specifies the KMS key ID to use to encrypt the logs delivered by CloudTrail. The value can be an alias name prefixed by \"alias/\", a fully specified ARN to an alias, a fully specified ARN to a key, or a globally unique identifier.

Examples:

", + "UpdateTrailRequest$KmsKeyId": "

Specifies the KMS key ID to use to encrypt the logs delivered by CloudTrail. The value can be an alias name prefixed by \"alias/\", a fully specified ARN to an alias, a fully specified ARN to a key, or a globally unique identifier.

Examples:

", "UpdateTrailResponse$Name": "

Specifies the name of the trail.

", "UpdateTrailResponse$S3BucketName": "

Specifies the name of the Amazon S3 bucket designated for publishing log files.

", "UpdateTrailResponse$S3KeyPrefix": "

Specifies the Amazon S3 key prefix that comes after the name of the bucket you have designated for log file delivery. For more information, see Finding Your CloudTrail Log Files.

", "UpdateTrailResponse$SnsTopicName": "

This field is deprecated. Use SnsTopicARN.

", - "UpdateTrailResponse$SnsTopicARN": "

Specifies the ARN of the Amazon SNS topic that CloudTrail uses to send notifications when log files are delivered. The format of a topic ARN is:

arn:aws:sns:us-east-1:123456789012:MyTopic

", - "UpdateTrailResponse$TrailARN": "

Specifies the ARN of the trail that was updated. The format of a trail ARN is:

arn:aws:cloudtrail:us-east-1:123456789012:trail/MyTrail

", + "UpdateTrailResponse$SnsTopicARN": "

Specifies the ARN of the Amazon SNS topic that CloudTrail uses to send notifications when log files are delivered. The format of a topic ARN is:

arn:aws:sns:us-east-2:123456789012:MyTopic

", + "UpdateTrailResponse$TrailARN": "

Specifies the ARN of the trail that was updated. The format of a trail ARN is:

arn:aws:cloudtrail:us-east-2:123456789012:trail/MyTrail

", "UpdateTrailResponse$CloudWatchLogsLogGroupArn": "

Specifies the Amazon Resource Name (ARN) of the log group to which CloudTrail logs will be delivered.

", "UpdateTrailResponse$CloudWatchLogsRoleArn": "

Specifies the role for the CloudWatch Logs endpoint to assume to write to a user's log group.

", - "UpdateTrailResponse$KmsKeyId": "

Specifies the KMS key ID that encrypts the logs delivered by CloudTrail. The value is a fully specified ARN to a KMS key in the format:

arn:aws:kms:us-east-1:123456789012:key/12345678-1234-1234-1234-123456789012

" + "UpdateTrailResponse$KmsKeyId": "

Specifies the KMS key ID that encrypts the logs delivered by CloudTrail. The value is a fully specified ARN to a KMS key in the format:

arn:aws:kms:us-east-2:123456789012:key/12345678-1234-1234-1234-123456789012

" } }, "Tag": { @@ -590,7 +592,7 @@ "TrailNameList": { "base": null, "refs": { - "DescribeTrailsRequest$trailNameList": "

Specifies a list of trail names, trail ARNs, or both, of the trails to describe. The format of a trail ARN is:

arn:aws:cloudtrail:us-east-1:123456789012:trail/MyTrail

If an empty list is specified, information for the trail in the current region is returned.

If one or more trail names are specified, information is returned only if the names match the names of trails belonging only to the current region. To return information about a trail in another region, you must specify its trail ARN.

" + "DescribeTrailsRequest$trailNameList": "

Specifies a list of trail names, trail ARNs, or both, of the trails to describe. The format of a trail ARN is:

arn:aws:cloudtrail:us-east-2:123456789012:trail/MyTrail

If an empty list is specified, information for the trail in the current region is returned.

If one or more trail names are specified, information is returned only if the names match the names of trails belonging only to the current region. To return information about a trail in another region, you must specify its trail ARN.

" } }, "TrailNotFoundException": { diff --git a/models/apis/cloudtrail/2013-11-01/smoke.json b/models/apis/cloudtrail/2013-11-01/smoke.json new file mode 100644 index 00000000000..4addfa985f3 --- /dev/null +++ b/models/apis/cloudtrail/2013-11-01/smoke.json @@ -0,0 +1,18 @@ +{ + "version": 1, + "defaultRegion": "us-west-2", + "testCases": [ + { + "operationName": "DescribeTrails", + "input": {}, + "errorExpectedFromService": false + }, + { + "operationName": "DeleteTrail", + "input": { + "Name": "faketrail" + }, + "errorExpectedFromService": true + } + ] +} diff --git a/models/apis/comprehend/2017-11-27/api-2.json b/models/apis/comprehend/2017-11-27/api-2.json index e7923878af3..591f57ebb03 100644 --- a/models/apis/comprehend/2017-11-27/api-2.json +++ b/models/apis/comprehend/2017-11-27/api-2.json @@ -958,7 +958,11 @@ "type":"string", "enum":[ "en", - "es" + "es", + "fr", + "de", + "it", + "pt" ] }, "ListDominantLanguageDetectionJobsRequest":{ @@ -1367,7 +1371,14 @@ }, "SyntaxLanguageCode":{ "type":"string", - "enum":["en"] + "enum":[ + "en", + "es", + "fr", + "de", + "it", + "pt" + ] }, "SyntaxToken":{ "type":"structure", diff --git a/models/apis/directconnect/2012-10-25/api-2.json b/models/apis/directconnect/2012-10-25/api-2.json index 133d770d847..a5d0576ad54 100644 --- a/models/apis/directconnect/2012-10-25/api-2.json +++ b/models/apis/directconnect/2012-10-25/api-2.json @@ -6,6 +6,7 @@ "jsonVersion":"1.1", "protocol":"json", "serviceFullName":"AWS Direct Connect", + "serviceId":"Direct Connect", "signatureVersion":"v4", "targetPrefix":"OvertureService", "uid":"directconnect-2012-10-25" @@ -586,6 +587,19 @@ {"shape":"DirectConnectServerException"}, {"shape":"DirectConnectClientException"} ] + }, + "UpdateVirtualInterfaceAttributes":{ + "name":"UpdateVirtualInterfaceAttributes", + "http":{ + "method":"POST", + "requestUri":"/" + }, + "input":{"shape":"UpdateVirtualInterfaceAttributesRequest"}, + "output":{"shape":"VirtualInterface"}, + "errors":[ + {"shape":"DirectConnectServerException"}, + {"shape":"DirectConnectClientException"} + ] } }, "shapes":{ @@ -790,6 +804,7 @@ "loaIssueTime":{"shape":"LoaIssueTime"}, "lagId":{"shape":"LagId"}, "awsDevice":{"shape":"AwsDevice"}, + "jumboFrameCapable":{"shape":"JumboFrameCapable"}, "awsDeviceV2":{"shape":"AwsDeviceV2"} } }, @@ -1270,6 +1285,7 @@ "loaIssueTime":{"shape":"LoaIssueTime"}, "lagId":{"shape":"LagId"}, "awsDevice":{"shape":"AwsDevice"}, + "jumboFrameCapable":{"shape":"JumboFrameCapable"}, "awsDeviceV2":{"shape":"AwsDeviceV2"} } }, @@ -1296,6 +1312,7 @@ "interconnects":{"shape":"InterconnectList"} } }, + "JumboFrameCapable":{"type":"boolean"}, "Lag":{ "type":"structure", "members":{ @@ -1311,7 +1328,8 @@ "awsDevice":{"shape":"AwsDevice"}, "awsDeviceV2":{"shape":"AwsDeviceV2"}, "connections":{"shape":"ConnectionList"}, - "allowsHostedConnections":{"shape":"BooleanFlag"} + "allowsHostedConnections":{"shape":"BooleanFlag"}, + "jumboFrameCapable":{"shape":"JumboFrameCapable"} } }, "LagId":{"type":"string"}, @@ -1371,6 +1389,7 @@ } }, "LongAsn":{"type":"long"}, + "MTU":{"type":"integer"}, "MaxResultSetSize":{ "type":"integer", "box":true @@ -1396,6 +1415,7 @@ "virtualInterfaceName":{"shape":"VirtualInterfaceName"}, "vlan":{"shape":"VLAN"}, "asn":{"shape":"ASN"}, + "mtu":{"shape":"MTU"}, "authKey":{"shape":"BGPAuthKey"}, "amazonAddress":{"shape":"AmazonAddress"}, "customerAddress":{"shape":"CustomerAddress"}, @@ -1415,6 +1435,7 @@ "virtualInterfaceName":{"shape":"VirtualInterfaceName"}, "vlan":{"shape":"VLAN"}, "asn":{"shape":"ASN"}, + "mtu":{"shape":"MTU"}, "authKey":{"shape":"BGPAuthKey"}, "amazonAddress":{"shape":"AmazonAddress"}, "addressFamily":{"shape":"AddressFamily"}, @@ -1566,6 +1587,14 @@ "minimumLinks":{"shape":"Count"} } }, + "UpdateVirtualInterfaceAttributesRequest":{ + "type":"structure", + "required":["virtualInterfaceId"], + "members":{ + "virtualInterfaceId":{"shape":"VirtualInterfaceId"}, + "mtu":{"shape":"MTU"} + } + }, "VLAN":{"type":"integer"}, "VirtualGateway":{ "type":"structure", @@ -1605,6 +1634,8 @@ "addressFamily":{"shape":"AddressFamily"}, "virtualInterfaceState":{"shape":"VirtualInterfaceState"}, "customerRouterConfig":{"shape":"RouterConfig"}, + "mtu":{"shape":"MTU"}, + "jumboFrameCapable":{"shape":"JumboFrameCapable"}, "virtualGatewayId":{"shape":"VirtualGatewayId"}, "directConnectGatewayId":{"shape":"DirectConnectGatewayId"}, "routeFilterPrefixes":{"shape":"RouteFilterPrefixList"}, diff --git a/models/apis/directconnect/2012-10-25/docs-2.json b/models/apis/directconnect/2012-10-25/docs-2.json index 4c909fdbaf2..1beef7b9174 100644 --- a/models/apis/directconnect/2012-10-25/docs-2.json +++ b/models/apis/directconnect/2012-10-25/docs-2.json @@ -1,619 +1,620 @@ { "version": "2.0", - "service": "

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).

", + "service": "

AWS Direct Connect links your internal network to an AWS Direct Connect location over a standard 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 EC2 and Amazon S3) and to Amazon VPC, bypassing Internet service providers in your network path. A connection provides access to all AWS Regions except the China (Beijing) and (China) Ningxia Regions. AWS resources in the China Regions can only be accessed through locations associated with those Regions.

", "operations": { - "AllocateConnectionOnInterconnect": "

Deprecated in favor of AllocateHostedConnection.

Creates a hosted connection on an interconnect.

Allocates a VLAN number and a specified amount of bandwidth for use by a hosted connection on the given interconnect.

This is intended for use by AWS Direct Connect partners only.

", - "AllocateHostedConnection": "

Creates a hosted connection on an interconnect or a link aggregation group (LAG).

Allocates a VLAN number and a specified amount of bandwidth for use by a hosted connection on the given interconnect or LAG.

This is intended for use by AWS Direct Connect partners only.

", - "AllocatePrivateVirtualInterface": "

Provisions a private virtual interface to be owned by another AWS customer.

Virtual interfaces created using this action must be confirmed by the virtual interface owner by using the ConfirmPrivateVirtualInterface action. Until then, the virtual interface will be in 'Confirming' state, and will not be available for handling traffic.

", - "AllocatePublicVirtualInterface": "

Provisions a public virtual interface to be owned by a different customer.

The owner of a connection calls this function to provision a public virtual interface which will be owned by another AWS customer.

Virtual interfaces created using this function must be confirmed by the virtual interface owner by calling ConfirmPublicVirtualInterface. Until this step has been completed, the virtual interface will be in 'Confirming' state, and will not be available for handling traffic.

When creating an IPv6 public virtual interface (addressFamily is 'ipv6'), the customer and amazon address fields should be left blank to use auto-assigned IPv6 space. Custom IPv6 Addresses are currently not supported.

", - "AssociateConnectionWithLag": "

Associates an existing connection with a link aggregation group (LAG). The connection is interrupted and re-established as a member of the LAG (connectivity to AWS will be interrupted). The connection must be hosted on the same AWS Direct Connect endpoint as the LAG, and its bandwidth must match the bandwidth for the LAG. You can reassociate a connection that's currently associated with a different LAG; however, if removing the connection will cause the original LAG to fall below its setting for minimum number of operational connections, the request fails.

Any virtual interfaces that are directly associated with the connection are automatically re-associated with the LAG. If the connection was originally associated with a different LAG, the virtual interfaces remain associated with the original LAG.

For interconnects, any hosted connections are automatically re-associated with the LAG. If the interconnect was originally associated with a different LAG, the hosted connections remain associated with the original LAG.

", - "AssociateHostedConnection": "

Associates a hosted connection and its virtual interfaces with a link aggregation group (LAG) or interconnect. If the target interconnect or LAG has an existing hosted connection with a conflicting VLAN number or IP address, the operation fails. This action temporarily interrupts the hosted connection's connectivity to AWS as it is being migrated.

This is intended for use by AWS Direct Connect partners only.

", - "AssociateVirtualInterface": "

Associates a virtual interface with a specified link aggregation group (LAG) or connection. Connectivity to AWS is temporarily interrupted as the virtual interface is being migrated. If the target connection or LAG has an associated virtual interface with a conflicting VLAN number or a conflicting IP address, the operation fails.

Virtual interfaces associated with a hosted connection cannot be associated with a LAG; hosted connections must be migrated along with their virtual interfaces using AssociateHostedConnection.

In order to reassociate a virtual interface to a new connection or LAG, the requester must own either the virtual interface itself or the connection to which the virtual interface is currently associated. Additionally, the requester must own the connection or LAG to which the virtual interface will be newly associated.

", - "ConfirmConnection": "

Confirm the creation of a hosted connection on an interconnect.

Upon creation, the hosted connection is initially in the 'Ordering' state, and will remain in this state until the owner calls ConfirmConnection to confirm creation of the hosted connection.

", - "ConfirmPrivateVirtualInterface": "

Accept ownership of a private virtual interface created by another customer.

After the virtual interface owner calls this function, the virtual interface will be created and attached to the given virtual private gateway or direct connect gateway, and will be available for handling traffic.

", - "ConfirmPublicVirtualInterface": "

Accept ownership of a public virtual interface created by another customer.

After the virtual interface owner calls this function, the specified virtual interface will be created and made available for handling traffic.

", - "CreateBGPPeer": "

Creates a new BGP peer on a specified virtual interface. The BGP peer cannot be in the same address family (IPv4/IPv6) of an existing BGP peer on the virtual interface.

You must create a BGP peer for the corresponding address family in order to access AWS resources that also use that address family.

When creating a IPv6 BGP peer, the Amazon address and customer address fields must be left blank. IPv6 addresses are automatically assigned from Amazon's pool of IPv6 addresses; you cannot specify custom IPv6 addresses.

For a public virtual interface, the Autonomous System Number (ASN) must be private or already whitelisted for the virtual interface.

", - "CreateConnection": "

Creates a new connection between the customer network and a specific AWS Direct Connect location.

A connection 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. An AWS Direct Connect location provides access to Amazon Web Services in the region it is associated with. You can establish connections with AWS Direct Connect locations in multiple regions, but a connection in one region does not provide connectivity to other regions.

To find the locations for your region, use DescribeLocations.

You can automatically add the new connection to a link aggregation group (LAG) by specifying a LAG ID in the request. This ensures that the new connection is allocated on the same AWS Direct Connect endpoint that hosts the specified LAG. If there are no available ports on the endpoint, the request fails and no connection will be created.

", - "CreateDirectConnectGateway": "

Creates a new direct connect gateway. A direct connect gateway is an intermediate object that enables you to connect a set of virtual interfaces and virtual private gateways. direct connect gateways are global and visible in any AWS region after they are created. The virtual interfaces and virtual private gateways that are connected through a direct connect gateway can be in different regions. This enables you to connect to a VPC in any region, regardless of the region in which the virtual interfaces are located, and pass traffic between them.

", - "CreateDirectConnectGatewayAssociation": "

Creates an association between a direct connect gateway and a virtual private gateway (VGW). The VGW must be attached to a VPC and must not be associated with another direct connect gateway.

", - "CreateInterconnect": "

Creates a new interconnect between a AWS Direct Connect partner's network and a specific AWS Direct Connect location.

An interconnect is a connection which is capable of hosting other connections. The AWS Direct Connect partner can use an interconnect to provide sub-1Gbps AWS Direct Connect service to tier 2 customers who do not have their own connections. Like a standard connection, an interconnect links the AWS Direct Connect partner's network to an AWS Direct Connect location over a standard 1 Gbps or 10 Gbps Ethernet fiber-optic cable. One end is connected to the partner's router, the other to an AWS Direct Connect router.

You can automatically add the new interconnect to a link aggregation group (LAG) by specifying a LAG ID in the request. This ensures that the new interconnect is allocated on the same AWS Direct Connect endpoint that hosts the specified LAG. If there are no available ports on the endpoint, the request fails and no interconnect will be created.

For each end customer, the AWS Direct Connect partner provisions a connection on their interconnect by calling AllocateConnectionOnInterconnect. The end customer can then connect to AWS resources by creating a virtual interface on their connection, using the VLAN assigned to them by the AWS Direct Connect partner.

This is intended for use by AWS Direct Connect partners only.

", - "CreateLag": "

Creates a new link aggregation group (LAG) with the specified number of bundled physical connections between the customer network and a specific AWS Direct Connect location. A LAG is a logical interface that uses the Link Aggregation Control Protocol (LACP) to aggregate multiple 1 gigabit or 10 gigabit interfaces, allowing you to treat them as a single interface.

All connections in a LAG must use the same bandwidth (for example, 10 Gbps), and must terminate at the same AWS Direct Connect endpoint.

You can have up to 10 connections per LAG. Regardless of this limit, if you request more connections for the LAG than AWS Direct Connect can allocate on a single endpoint, no LAG is created.

You can specify an existing physical connection or interconnect to include in the LAG (which counts towards the total number of connections). Doing so interrupts the current physical connection or hosted connections, and re-establishes them as a member of the LAG. The LAG will be created on the same AWS Direct Connect endpoint to which the connection terminates. Any virtual interfaces associated with the connection are automatically disassociated and re-associated with the LAG. The connection ID does not change.

If the AWS account used to create a LAG is a registered AWS Direct Connect partner, the LAG is automatically enabled to host sub-connections. For a LAG owned by a partner, any associated virtual interfaces cannot be directly configured.

", - "CreatePrivateVirtualInterface": "

Creates a new private virtual interface. A virtual interface is the VLAN that transports AWS Direct Connect traffic. A private virtual interface supports sending traffic to a single virtual private cloud (VPC).

", - "CreatePublicVirtualInterface": "

Creates a new public virtual interface. A virtual interface is the VLAN that transports AWS Direct Connect traffic. A public virtual interface supports sending traffic to public services of AWS such as Amazon Simple Storage Service (Amazon S3).

When creating an IPv6 public virtual interface (addressFamily is 'ipv6'), the customer and amazon address fields should be left blank to use auto-assigned IPv6 space. Custom IPv6 Addresses are currently not supported.

", - "DeleteBGPPeer": "

Deletes a BGP peer on the specified virtual interface that matches the specified customer address and ASN. You cannot delete the last BGP peer from a virtual interface.

", - "DeleteConnection": "

Deletes the connection.

Deleting a connection only stops the AWS Direct Connect port hour and data transfer charges. You need to cancel separately with the providers any services or charges for cross-connects or network circuits that connect you to the AWS Direct Connect location.

", - "DeleteDirectConnectGateway": "

Deletes a direct connect gateway. You must first delete all virtual interfaces that are attached to the direct connect gateway and disassociate all virtual private gateways that are associated with the direct connect gateway.

", - "DeleteDirectConnectGatewayAssociation": "

Deletes the association between a direct connect gateway and a virtual private gateway.

", - "DeleteInterconnect": "

Deletes the specified interconnect.

This is intended for use by AWS Direct Connect partners only.

", - "DeleteLag": "

Deletes a link aggregation group (LAG). You cannot delete a LAG if it has active virtual interfaces or hosted connections.

", + "AllocateConnectionOnInterconnect": "

Deprecated. Use AllocateHostedConnection instead.

Creates a hosted connection on an interconnect.

Allocates a VLAN number and a specified amount of bandwidth for use by a hosted connection on the specified interconnect.

Intended for use by AWS Direct Connect partners only.

", + "AllocateHostedConnection": "

Creates a hosted connection on the specified interconnect or a link aggregation group (LAG).

Allocates a VLAN number and a specified amount of bandwidth for use by a hosted connection on the specified interconnect or LAG.

Intended for use by AWS Direct Connect partners only.

", + "AllocatePrivateVirtualInterface": "

Provisions a private virtual interface to be owned by the specified AWS account.

Virtual interfaces created using this action must be confirmed by the owner using ConfirmPrivateVirtualInterface. Until then, the virtual interface is in the Confirming state and is not available to handle traffic.

", + "AllocatePublicVirtualInterface": "

Provisions a public virtual interface to be owned by the specified AWS account.

The owner of a connection calls this function to provision a public virtual interface to be owned by the specified AWS account.

Virtual interfaces created using this function must be confirmed by the owner using ConfirmPublicVirtualInterface. Until this step has been completed, the virtual interface is in the confirming state and is not available to handle traffic.

When creating an IPv6 public virtual interface, omit the Amazon address and customer address. IPv6 addresses are automatically assigned from the Amazon pool of IPv6 addresses; you cannot specify custom IPv6 addresses.

", + "AssociateConnectionWithLag": "

Associates an existing connection with a link aggregation group (LAG). The connection is interrupted and re-established as a member of the LAG (connectivity to AWS is interrupted). The connection must be hosted on the same AWS Direct Connect endpoint as the LAG, and its bandwidth must match the bandwidth for the LAG. You can re-associate a connection that's currently associated with a different LAG; however, if removing the connection would cause the original LAG to fall below its setting for minimum number of operational connections, the request fails.

Any virtual interfaces that are directly associated with the connection are automatically re-associated with the LAG. If the connection was originally associated with a different LAG, the virtual interfaces remain associated with the original LAG.

For interconnects, any hosted connections are automatically re-associated with the LAG. If the interconnect was originally associated with a different LAG, the hosted connections remain associated with the original LAG.

", + "AssociateHostedConnection": "

Associates a hosted connection and its virtual interfaces with a link aggregation group (LAG) or interconnect. If the target interconnect or LAG has an existing hosted connection with a conflicting VLAN number or IP address, the operation fails. This action temporarily interrupts the hosted connection's connectivity to AWS as it is being migrated.

Intended for use by AWS Direct Connect partners only.

", + "AssociateVirtualInterface": "

Associates a virtual interface with a specified link aggregation group (LAG) or connection. Connectivity to AWS is temporarily interrupted as the virtual interface is being migrated. If the target connection or LAG has an associated virtual interface with a conflicting VLAN number or a conflicting IP address, the operation fails.

Virtual interfaces associated with a hosted connection cannot be associated with a LAG; hosted connections must be migrated along with their virtual interfaces using AssociateHostedConnection.

To reassociate a virtual interface to a new connection or LAG, the requester must own either the virtual interface itself or the connection to which the virtual interface is currently associated. Additionally, the requester must own the connection or LAG for the association.

", + "ConfirmConnection": "

Confirms the creation of the specified hosted connection on an interconnect.

Upon creation, the hosted connection is initially in the Ordering state, and remains in this state until the owner confirms creation of the hosted connection.

", + "ConfirmPrivateVirtualInterface": "

Accepts ownership of a private virtual interface created by another AWS account.

After the virtual interface owner makes this call, the virtual interface is created and attached to the specified virtual private gateway or Direct Connect gateway, and is made available to handle traffic.

", + "ConfirmPublicVirtualInterface": "

Accepts ownership of a public virtual interface created by another AWS account.

After the virtual interface owner makes this call, the specified virtual interface is created and made available to handle traffic.

", + "CreateBGPPeer": "

Creates a BGP peer on the specified virtual interface.

The BGP peer cannot be in the same address family (IPv4/IPv6) of an existing BGP peer on the virtual interface.

You must create a BGP peer for the corresponding address family in order to access AWS resources that also use that address family.

When creating a IPv6 BGP peer, omit the Amazon address and customer address. IPv6 addresses are automatically assigned from the Amazon pool of IPv6 addresses; you cannot specify custom IPv6 addresses.

For a public virtual interface, the Autonomous System Number (ASN) must be private or already whitelisted for the virtual interface.

", + "CreateConnection": "

Creates a connection between a customer network and a specific AWS Direct Connect location.

A connection links your internal network to an AWS Direct Connect location over a standard Ethernet fiber-optic cable. One end of the cable is connected to your router, the other to an AWS Direct Connect router.

To find the locations for your Region, use DescribeLocations.

You can automatically add the new connection to a link aggregation group (LAG) by specifying a LAG ID in the request. This ensures that the new connection is allocated on the same AWS Direct Connect endpoint that hosts the specified LAG. If there are no available ports on the endpoint, the request fails and no connection is created.

", + "CreateDirectConnectGateway": "

Creates a Direct Connect gateway, which is an intermediate object that enables you to connect a set of virtual interfaces and virtual private gateways. A Direct Connect gateway is global and visible in any AWS Region after it is created. The virtual interfaces and virtual private gateways that are connected through a Direct Connect gateway can be in different AWS Regions. This enables you to connect to a VPC in any Region, regardless of the Region in which the virtual interfaces are located, and pass traffic between them.

", + "CreateDirectConnectGatewayAssociation": "

Creates an association between a Direct Connect gateway and a virtual private gateway. The virtual private gateway must be attached to a VPC and must not be associated with another Direct Connect gateway.

", + "CreateInterconnect": "

Creates an interconnect between an AWS Direct Connect partner's network and a specific AWS Direct Connect location.

An interconnect is a connection which is capable of hosting other connections. The partner can use an interconnect to provide sub-1Gbps AWS Direct Connect service to tier 2 customers who do not have their own connections. Like a standard connection, an interconnect links the partner's network to an AWS Direct Connect location over a standard Ethernet fiber-optic cable. One end is connected to the partner's router, the other to an AWS Direct Connect router.

You can automatically add the new interconnect to a link aggregation group (LAG) by specifying a LAG ID in the request. This ensures that the new interconnect is allocated on the same AWS Direct Connect endpoint that hosts the specified LAG. If there are no available ports on the endpoint, the request fails and no interconnect is created.

For each end customer, the AWS Direct Connect partner provisions a connection on their interconnect by calling AllocateConnectionOnInterconnect. The end customer can then connect to AWS resources by creating a virtual interface on their connection, using the VLAN assigned to them by the partner.

Intended for use by AWS Direct Connect partners only.

", + "CreateLag": "

Creates a link aggregation group (LAG) with the specified number of bundled physical connections between the customer network and a specific AWS Direct Connect location. A LAG is a logical interface that uses the Link Aggregation Control Protocol (LACP) to aggregate multiple interfaces, enabling you to treat them as a single interface.

All connections in a LAG must use the same bandwidth and must terminate at the same AWS Direct Connect endpoint.

You can have up to 10 connections per LAG. Regardless of this limit, if you request more connections for the LAG than AWS Direct Connect can allocate on a single endpoint, no LAG is created.

You can specify an existing physical connection or interconnect to include in the LAG (which counts towards the total number of connections). Doing so interrupts the current physical connection or hosted connections, and re-establishes them as a member of the LAG. The LAG will be created on the same AWS Direct Connect endpoint to which the connection terminates. Any virtual interfaces associated with the connection are automatically disassociated and re-associated with the LAG. The connection ID does not change.

If the AWS account used to create a LAG is a registered AWS Direct Connect partner, the LAG is automatically enabled to host sub-connections. For a LAG owned by a partner, any associated virtual interfaces cannot be directly configured.

", + "CreatePrivateVirtualInterface": "

Creates a private virtual interface. A virtual interface is the VLAN that transports AWS Direct Connect traffic. A private virtual interface can be connected to either a Direct Connect gateway or a Virtual Private Gateway (VGW). Connecting the private virtual interface to a Direct Connect gateway enables the possibility for connecting to multiple VPCs, including VPCs in different AWS Regions. Connecting the private virtual interface to a VGW only provides access to a single VPC within the same Region.

", + "CreatePublicVirtualInterface": "

Creates a public virtual interface. A virtual interface is the VLAN that transports AWS Direct Connect traffic. A public virtual interface supports sending traffic to public services of AWS such as Amazon S3.

When creating an IPv6 public virtual interface (addressFamily is ipv6), leave the customer and amazon address fields blank to use auto-assigned IPv6 space. Custom IPv6 addresses are not supported.

", + "DeleteBGPPeer": "

Deletes the BGP peer on the specified virtual interface with the specified customer address and ASN.

You cannot delete the last BGP peer from a virtual interface.

", + "DeleteConnection": "

Deletes the specified connection.

Deleting a connection only stops the AWS Direct Connect port hour and data transfer charges. If you are partnering with any third parties to connect with the AWS Direct Connect location, you must cancel your service with them separately.

", + "DeleteDirectConnectGateway": "

Deletes the specified Direct Connect gateway. You must first delete all virtual interfaces that are attached to the Direct Connect gateway and disassociate all virtual private gateways that are associated with the Direct Connect gateway.

", + "DeleteDirectConnectGatewayAssociation": "

Deletes the association between the specified Direct Connect gateway and virtual private gateway.

", + "DeleteInterconnect": "

Deletes the specified interconnect.

Intended for use by AWS Direct Connect partners only.

", + "DeleteLag": "

Deletes the specified link aggregation group (LAG). You cannot delete a LAG if it has active virtual interfaces or hosted connections.

", "DeleteVirtualInterface": "

Deletes a virtual interface.

", - "DescribeConnectionLoa": "

Deprecated in favor of DescribeLoa.

Returns the LOA-CFA for a Connection.

The Letter of Authorization - Connecting Facility Assignment (LOA-CFA) is a document that your APN partner or service provider uses when establishing your cross connect to AWS at the colocation facility. For more information, see Requesting Cross Connects at AWS Direct Connect Locations in the AWS Direct Connect user guide.

", - "DescribeConnections": "

Displays all connections in this region.

If a connection ID is provided, the call returns only that particular connection.

", - "DescribeConnectionsOnInterconnect": "

Deprecated in favor of DescribeHostedConnections.

Returns a list of connections that have been provisioned on the given interconnect.

This is intended for use by AWS Direct Connect partners only.

", - "DescribeDirectConnectGatewayAssociations": "

Returns a list of all direct connect gateway and virtual private gateway (VGW) associations. Either a direct connect gateway ID or a VGW ID must be provided in the request. If a direct connect gateway ID is provided, the response returns all VGWs associated with the direct connect gateway. If a VGW ID is provided, the response returns all direct connect gateways associated with the VGW. If both are provided, the response only returns the association that matches both the direct connect gateway and the VGW.

", - "DescribeDirectConnectGatewayAttachments": "

Returns a list of all direct connect gateway and virtual interface (VIF) attachments. Either a direct connect gateway ID or a VIF ID must be provided in the request. If a direct connect gateway ID is provided, the response returns all VIFs attached to the direct connect gateway. If a VIF ID is provided, the response returns all direct connect gateways attached to the VIF. If both are provided, the response only returns the attachment that matches both the direct connect gateway and the VIF.

", - "DescribeDirectConnectGateways": "

Returns a list of direct connect gateways in your account. Deleted direct connect gateways are not returned. You can provide a direct connect gateway ID in the request to return information about the specific direct connect gateway only. Otherwise, if a direct connect gateway ID is not provided, information about all of your direct connect gateways is returned.

", - "DescribeHostedConnections": "

Returns a list of hosted connections that have been provisioned on the given interconnect or link aggregation group (LAG).

This is intended for use by AWS Direct Connect partners only.

", - "DescribeInterconnectLoa": "

Deprecated in favor of DescribeLoa.

Returns the LOA-CFA for an Interconnect.

The Letter of Authorization - Connecting Facility Assignment (LOA-CFA) is a document that is used when establishing your cross connect to AWS at the colocation facility. For more information, see Requesting Cross Connects at AWS Direct Connect Locations in the AWS Direct Connect user guide.

", - "DescribeInterconnects": "

Returns a list of interconnects owned by the AWS account.

If an interconnect ID is provided, it will only return this particular interconnect.

", - "DescribeLags": "

Describes the link aggregation groups (LAGs) in your account.

If a LAG ID is provided, only information about the specified LAG is returned.

", - "DescribeLoa": "

Returns the LOA-CFA for a connection, interconnect, or link aggregation group (LAG).

The Letter of Authorization - Connecting Facility Assignment (LOA-CFA) is a document that is used when establishing your cross connect to AWS at the colocation facility. For more information, see Requesting Cross Connects at AWS Direct Connect Locations in the AWS Direct Connect user guide.

", - "DescribeLocations": "

Returns the list of AWS Direct Connect locations in the current AWS region. These are the locations that may be selected when calling CreateConnection or CreateInterconnect.

", - "DescribeTags": "

Describes the tags associated with the specified Direct Connect resources.

", - "DescribeVirtualGateways": "

Returns a list of virtual private gateways owned by the AWS account.

You can create one or more AWS Direct Connect private virtual interfaces linking to a virtual private gateway. A virtual private gateway can be managed via Amazon Virtual Private Cloud (VPC) console or the EC2 CreateVpnGateway action.

", - "DescribeVirtualInterfaces": "

Displays all virtual interfaces for an AWS account. Virtual interfaces deleted fewer than 15 minutes before you make the request are also returned. If you specify a connection ID, only the virtual interfaces associated with the connection are returned. If you specify a virtual interface ID, then only a single virtual interface is returned.

A virtual interface (VLAN) transmits the traffic between the AWS Direct Connect location and the customer.

", - "DisassociateConnectionFromLag": "

Disassociates a connection from a link aggregation group (LAG). The connection is interrupted and re-established as a standalone connection (the connection is not deleted; to delete the connection, use the DeleteConnection request). If the LAG has associated virtual interfaces or hosted connections, they remain associated with the LAG. A disassociated connection owned by an AWS Direct Connect partner is automatically converted to an interconnect.

If disassociating the connection will cause the LAG to fall below its setting for minimum number of operational connections, the request fails, except when it's the last member of the LAG. If all connections are disassociated, the LAG continues to exist as an empty LAG with no physical connections.

", - "TagResource": "

Adds the specified tags to the specified Direct Connect resource. Each Direct Connect resource can have a maximum of 50 tags.

Each tag consists of a key and an optional value. If a tag with the same key is already associated with the Direct Connect resource, this action updates its value.

", - "UntagResource": "

Removes one or more tags from the specified Direct Connect resource.

", - "UpdateLag": "

Updates the attributes of a link aggregation group (LAG).

You can update the following attributes:

When you create a LAG, the default value for the minimum number of operational connections is zero (0). If you update this value, and the number of operational connections falls below the specified value, the LAG will automatically go down to avoid overutilization of the remaining connections. Adjusting this value should be done with care as it could force the LAG down if the value is set higher than the current number of operational connections.

" + "DescribeConnectionLoa": "

Deprecated. Use DescribeLoa instead.

Gets the LOA-CFA for a connection.

The Letter of Authorization - Connecting Facility Assignment (LOA-CFA) is a document that your APN partner or service provider uses when establishing your cross connect to AWS at the colocation facility. For more information, see Requesting Cross Connects at AWS Direct Connect Locations in the AWS Direct Connect User Guide.

", + "DescribeConnections": "

Displays the specified connection or all connections in this Region.

", + "DescribeConnectionsOnInterconnect": "

Deprecated. Use DescribeHostedConnections instead.

Lists the connections that have been provisioned on the specified interconnect.

Intended for use by AWS Direct Connect partners only.

", + "DescribeDirectConnectGatewayAssociations": "

Lists the associations between your Direct Connect gateways and virtual private gateways. You must specify a Direct Connect gateway, a virtual private gateway, or both. If you specify a Direct Connect gateway, the response contains all virtual private gateways associated with the Direct Connect gateway. If you specify a virtual private gateway, the response contains all Direct Connect gateways associated with the virtual private gateway. If you specify both, the response contains the association between the Direct Connect gateway and the virtual private gateway.

", + "DescribeDirectConnectGatewayAttachments": "

Lists the attachments between your Direct Connect gateways and virtual interfaces. You must specify a Direct Connect gateway, a virtual interface, or both. If you specify a Direct Connect gateway, the response contains all virtual interfaces attached to the Direct Connect gateway. If you specify a virtual interface, the response contains all Direct Connect gateways attached to the virtual interface. If you specify both, the response contains the attachment between the Direct Connect gateway and the virtual interface.

", + "DescribeDirectConnectGateways": "

Lists all your Direct Connect gateways or only the specified Direct Connect gateway. Deleted Direct Connect gateways are not returned.

", + "DescribeHostedConnections": "

Lists the hosted connections that have been provisioned on the specified interconnect or link aggregation group (LAG).

Intended for use by AWS Direct Connect partners only.

", + "DescribeInterconnectLoa": "

Deprecated. Use DescribeLoa instead.

Gets the LOA-CFA for the specified interconnect.

The Letter of Authorization - Connecting Facility Assignment (LOA-CFA) is a document that is used when establishing your cross connect to AWS at the colocation facility. For more information, see Requesting Cross Connects at AWS Direct Connect Locations in the AWS Direct Connect User Guide.

", + "DescribeInterconnects": "

Lists the interconnects owned by the AWS account or only the specified interconnect.

", + "DescribeLags": "

Describes all your link aggregation groups (LAG) or the specified LAG.

", + "DescribeLoa": "

Gets the LOA-CFA for a connection, interconnect, or link aggregation group (LAG).

The Letter of Authorization - Connecting Facility Assignment (LOA-CFA) is a document that is used when establishing your cross connect to AWS at the colocation facility. For more information, see Requesting Cross Connects at AWS Direct Connect Locations in the AWS Direct Connect User Guide.

", + "DescribeLocations": "

Lists the AWS Direct Connect locations in the current AWS Region. These are the locations that can be selected when calling CreateConnection or CreateInterconnect.

", + "DescribeTags": "

Describes the tags associated with the specified AWS Direct Connect resources.

", + "DescribeVirtualGateways": "

Lists the virtual private gateways owned by the AWS account.

You can create one or more AWS Direct Connect private virtual interfaces linked to a virtual private gateway.

", + "DescribeVirtualInterfaces": "

Displays all virtual interfaces for an AWS account. Virtual interfaces deleted fewer than 15 minutes before you make the request are also returned. If you specify a connection ID, only the virtual interfaces associated with the connection are returned. If you specify a virtual interface ID, then only a single virtual interface is returned.

A virtual interface (VLAN) transmits the traffic between the AWS Direct Connect location and the customer network.

", + "DisassociateConnectionFromLag": "

Disassociates a connection from a link aggregation group (LAG). The connection is interrupted and re-established as a standalone connection (the connection is not deleted; to delete the connection, use the DeleteConnection request). If the LAG has associated virtual interfaces or hosted connections, they remain associated with the LAG. A disassociated connection owned by an AWS Direct Connect partner is automatically converted to an interconnect.

If disassociating the connection would cause the LAG to fall below its setting for minimum number of operational connections, the request fails, except when it's the last member of the LAG. If all connections are disassociated, the LAG continues to exist as an empty LAG with no physical connections.

", + "TagResource": "

Adds the specified tags to the specified AWS Direct Connect resource. Each resource can have a maximum of 50 tags.

Each tag consists of a key and an optional value. If a tag with the same key is already associated with the resource, this action updates its value.

", + "UntagResource": "

Removes one or more tags from the specified AWS Direct Connect resource.

", + "UpdateLag": "

Updates the attributes of the specified link aggregation group (LAG).

You can update the following attributes:

When you create a LAG, the default value for the minimum number of operational connections is zero (0). If you update this value and the number of operational connections falls below the specified value, the LAG automatically goes down to avoid over-utilization of the remaining connections. Adjust this value with care, as it could force the LAG down if it is set higher than the current number of operational connections.

", + "UpdateVirtualInterfaceAttributes": "

Updates the specified attributes of the specified virtual private interface.

Setting the MTU of a virtual interface to 9001 (jumbo frames) can cause an update to the underlying physical connection if it wasn't updated to support jumbo frames. Updating the connection disrupts network connectivity for all virtual interfaces associated with the connection for up to 30 seconds. To check whether your connection supports jumbo frames, call DescribeConnections. To check whether your virtual interface supports jumbo frames, call DescribeVirtualInterfaces.

" }, "shapes": { "ASN": { - "base": "

The autonomous system (AS) number for Border Gateway Protocol (BGP) configuration.

Example: 65000

", + "base": null, "refs": { - "BGPPeer$asn": null, - "DeleteBGPPeerRequest$asn": null, - "NewBGPPeer$asn": null, - "NewPrivateVirtualInterface$asn": null, - "NewPrivateVirtualInterfaceAllocation$asn": null, - "NewPublicVirtualInterface$asn": null, - "NewPublicVirtualInterfaceAllocation$asn": null, - "VirtualInterface$asn": null + "BGPPeer$asn": "

The autonomous system (AS) number for Border Gateway Protocol (BGP) configuration.

", + "DeleteBGPPeerRequest$asn": "

The autonomous system (AS) number for Border Gateway Protocol (BGP) configuration.

", + "NewBGPPeer$asn": "

The autonomous system (AS) number for Border Gateway Protocol (BGP) configuration.

", + "NewPrivateVirtualInterface$asn": "

The autonomous system (AS) number for Border Gateway Protocol (BGP) configuration.

", + "NewPrivateVirtualInterfaceAllocation$asn": "

The autonomous system (AS) number for Border Gateway Protocol (BGP) configuration.

", + "NewPublicVirtualInterface$asn": "

The autonomous system (AS) number for Border Gateway Protocol (BGP) configuration.

", + "NewPublicVirtualInterfaceAllocation$asn": "

The autonomous system (AS) number for Border Gateway Protocol (BGP) configuration.

", + "VirtualInterface$asn": "

The autonomous system (AS) number for Border Gateway Protocol (BGP) configuration.

" } }, "AddressFamily": { - "base": "

Indicates the address family for the BGP peer.

", + "base": null, "refs": { - "BGPPeer$addressFamily": null, - "NewBGPPeer$addressFamily": null, - "NewPrivateVirtualInterface$addressFamily": null, - "NewPrivateVirtualInterfaceAllocation$addressFamily": null, - "NewPublicVirtualInterface$addressFamily": null, - "NewPublicVirtualInterfaceAllocation$addressFamily": null, - "VirtualInterface$addressFamily": null + "BGPPeer$addressFamily": "

The address family for the BGP peer.

", + "NewBGPPeer$addressFamily": "

The address family for the BGP peer.

", + "NewPrivateVirtualInterface$addressFamily": "

The address family for the BGP peer.

", + "NewPrivateVirtualInterfaceAllocation$addressFamily": "

The address family for the BGP peer.

", + "NewPublicVirtualInterface$addressFamily": "

The address family for the BGP peer.

", + "NewPublicVirtualInterfaceAllocation$addressFamily": "

The address family for the BGP peer.

", + "VirtualInterface$addressFamily": "

The address family for the BGP peer.

" } }, "AllocateConnectionOnInterconnectRequest": { - "base": "

Container for the parameters to the AllocateConnectionOnInterconnect operation.

", + "base": null, "refs": { } }, "AllocateHostedConnectionRequest": { - "base": "

Container for the parameters to theHostedConnection operation.

", + "base": null, "refs": { } }, "AllocatePrivateVirtualInterfaceRequest": { - "base": "

Container for the parameters to the AllocatePrivateVirtualInterface operation.

", + "base": null, "refs": { } }, "AllocatePublicVirtualInterfaceRequest": { - "base": "

Container for the parameters to the AllocatePublicVirtualInterface operation.

", + "base": null, "refs": { } }, "AmazonAddress": { - "base": "

IP address assigned to the Amazon interface.

Example: 192.168.1.1/30 or 2001:db8::1/125

", + "base": null, "refs": { - "BGPPeer$amazonAddress": null, - "NewBGPPeer$amazonAddress": null, - "NewPrivateVirtualInterface$amazonAddress": null, - "NewPrivateVirtualInterfaceAllocation$amazonAddress": null, - "NewPublicVirtualInterface$amazonAddress": null, - "NewPublicVirtualInterfaceAllocation$amazonAddress": null, - "VirtualInterface$amazonAddress": null + "BGPPeer$amazonAddress": "

The IP address assigned to the Amazon interface.

", + "NewBGPPeer$amazonAddress": "

The IP address assigned to the Amazon interface.

", + "NewPrivateVirtualInterface$amazonAddress": "

The IP address assigned to the Amazon interface.

", + "NewPrivateVirtualInterfaceAllocation$amazonAddress": "

The IP address assigned to the Amazon interface.

", + "NewPublicVirtualInterface$amazonAddress": "

The IP address assigned to the Amazon interface.

", + "NewPublicVirtualInterfaceAllocation$amazonAddress": "

The IP address assigned to the Amazon interface.

", + "VirtualInterface$amazonAddress": "

The IP address assigned to the Amazon interface.

" } }, "AssociateConnectionWithLagRequest": { - "base": "

Container for the parameters to the AssociateConnectionWithLag operation.

", + "base": null, "refs": { } }, "AssociateHostedConnectionRequest": { - "base": "

Container for the parameters to the AssociateHostedConnection operation.

", + "base": null, "refs": { } }, "AssociateVirtualInterfaceRequest": { - "base": "

Container for the parameters to the AssociateVirtualInterface operation.

", + "base": null, "refs": { } }, "AwsDevice": { - "base": "

An abstract ID for the physical Direct Connect endpoint.

Example: EQC50-abcdef123456

", + "base": null, "refs": { - "Connection$awsDevice": "

Deprecated in favor of awsDeviceV2.

The Direct Connection endpoint which the physical connection terminates on.

", - "Interconnect$awsDevice": "

Deprecated in favor of awsDeviceV2.

The Direct Connection endpoint which the physical connection terminates on.

", - "Lag$awsDevice": "

Deprecated in favor of awsDeviceV2.

The AWS Direct Connection endpoint that hosts the LAG.

" + "Connection$awsDevice": "

The Direct Connect endpoint on which the physical connection terminates.

", + "Interconnect$awsDevice": "

The Direct Connect endpoint on which the physical connection terminates.

", + "Lag$awsDevice": "

The Direct Connect endpoint that hosts the LAG.

" } }, "AwsDeviceV2": { "base": null, "refs": { - "BGPPeer$awsDeviceV2": "

The Direct Connection endpoint which the BGP peer terminates on.

", - "Connection$awsDeviceV2": "

The Direct Connection endpoint which the physical connection terminates on.

", - "Interconnect$awsDeviceV2": "

The Direct Connection endpoint which the physical connection terminates on.

", - "Lag$awsDeviceV2": "

The AWS Direct Connection endpoint that hosts the LAG.

", - "VirtualInterface$awsDeviceV2": "

The Direct Connection endpoint which the virtual interface terminates on.

" + "BGPPeer$awsDeviceV2": "

The Direct Connect endpoint on which the BGP peer terminates.

", + "Connection$awsDeviceV2": "

The Direct Connect endpoint on which the physical connection terminates.

", + "Interconnect$awsDeviceV2": "

The Direct Connect endpoint on which the physical connection terminates.

", + "Lag$awsDeviceV2": "

The Direct Connect endpoint that hosts the LAG.

", + "VirtualInterface$awsDeviceV2": "

The Direct Connect endpoint on which the virtual interface terminates.

" } }, "BGPAuthKey": { - "base": "

The authentication key for BGP configuration.

Example: asdf34example

", + "base": null, "refs": { - "BGPPeer$authKey": null, - "NewBGPPeer$authKey": null, - "NewPrivateVirtualInterface$authKey": null, - "NewPrivateVirtualInterfaceAllocation$authKey": null, - "NewPublicVirtualInterface$authKey": null, - "NewPublicVirtualInterfaceAllocation$authKey": null, - "VirtualInterface$authKey": null + "BGPPeer$authKey": "

The authentication key for BGP configuration.

", + "NewBGPPeer$authKey": "

The authentication key for BGP configuration.

", + "NewPrivateVirtualInterface$authKey": "

The authentication key for BGP configuration.

", + "NewPrivateVirtualInterfaceAllocation$authKey": "

The authentication key for BGP configuration.

", + "NewPublicVirtualInterface$authKey": "

The authentication key for BGP configuration.

", + "NewPublicVirtualInterfaceAllocation$authKey": "

The authentication key for BGP configuration.

", + "VirtualInterface$authKey": "

The authentication key for BGP configuration.

" } }, "BGPPeer": { - "base": "

A structure containing information about a BGP peer.

", + "base": "

Information about a BGP peer.

", "refs": { "BGPPeerList$member": null } }, "BGPPeerList": { - "base": "

A list of the BGP peers configured on this virtual interface.

", + "base": null, "refs": { - "VirtualInterface$bgpPeers": null + "VirtualInterface$bgpPeers": "

The BGP peers configured on this virtual interface.

" } }, "BGPPeerState": { - "base": "

The state of the BGP peer.

", + "base": null, "refs": { - "BGPPeer$bgpPeerState": null + "BGPPeer$bgpPeerState": "

The state of the BGP peer. The following are the possible values:

" } }, "BGPStatus": { - "base": "

The Up/Down state of the BGP peer.

", + "base": null, "refs": { - "BGPPeer$bgpStatus": null + "BGPPeer$bgpStatus": "

The status of the BGP peer. The following are the possible values:

" } }, "Bandwidth": { - "base": "

Bandwidth of the connection.

Example: 1Gbps

Default: None

", + "base": null, "refs": { - "AllocateConnectionOnInterconnectRequest$bandwidth": "

Bandwidth of the connection.

Example: \"500Mbps\"

Default: None

Values: 50Mbps, 100Mbps, 200Mbps, 300Mbps, 400Mbps, or 500Mbps

", - "AllocateHostedConnectionRequest$bandwidth": "

The bandwidth of the connection.

Example: 500Mbps

Default: None

Values: 50Mbps, 100Mbps, 200Mbps, 300Mbps, 400Mbps, or 500Mbps

", - "Connection$bandwidth": "

Bandwidth of the connection.

Example: 1Gbps (for regular connections), or 500Mbps (for hosted connections)

Default: None

", - "CreateConnectionRequest$bandwidth": null, - "CreateInterconnectRequest$bandwidth": "

The port bandwidth

Example: 1Gbps

Default: None

Available values: 1Gbps,10Gbps

", - "CreateLagRequest$connectionsBandwidth": "

The bandwidth of the individual physical connections bundled by the LAG.

Default: None

Available values: 1Gbps, 10Gbps

", - "Interconnect$bandwidth": null, - "Lag$connectionsBandwidth": "

The individual bandwidth of the physical connections bundled by the LAG.

Available values: 1Gbps, 10Gbps

" + "AllocateConnectionOnInterconnectRequest$bandwidth": "

The bandwidth of the connection, in Mbps. The possible values are 50Mbps, 100Mbps, 200Mbps, 300Mbps, 400Mbps, and 500Mbps.

", + "AllocateHostedConnectionRequest$bandwidth": "

The bandwidth of the hosted connection, in Mbps. The possible values are 50Mbps, 100Mbps, 200Mbps, 300Mbps, 400Mbps, and 500Mbps.

", + "Connection$bandwidth": "

The bandwidth of the connection.

", + "CreateConnectionRequest$bandwidth": "

The bandwidth of the connection.

", + "CreateInterconnectRequest$bandwidth": "

The port bandwidth, in Gbps. The possible values are 1 and 10.

", + "CreateLagRequest$connectionsBandwidth": "

The bandwidth of the individual physical connections bundled by the LAG. The possible values are 1Gbps and 10Gbps.

", + "Interconnect$bandwidth": "

The bandwidth of the connection.

", + "Lag$connectionsBandwidth": "

The individual bandwidth of the physical connections bundled by the LAG. The possible values are 1Gbps and 10Gbps.

" } }, "BooleanFlag": { "base": null, "refs": { - "Lag$allowsHostedConnections": "

Indicates whether the LAG can host other connections.

This is intended for use by AWS Direct Connect partners only.

" + "Lag$allowsHostedConnections": "

Indicates whether the LAG can host other connections.

" } }, "CIDR": { "base": null, "refs": { - "RouteFilterPrefix$cidr": "

CIDR notation for the advertised route. Multiple routes are separated by commas.

IPv6 CIDRs must be at least a /64 or shorter

Example: 10.10.10.0/24,10.10.11.0/24,2001:db8::/64

" + "RouteFilterPrefix$cidr": "

The CIDR block for the advertised route. Separate multiple routes using commas. An IPv6 CIDR must use /64 or shorter.

" } }, "ConfirmConnectionRequest": { - "base": "

Container for the parameters to the ConfirmConnection operation.

", + "base": null, "refs": { } }, "ConfirmConnectionResponse": { - "base": "

The response received when ConfirmConnection is called.

", + "base": null, "refs": { } }, "ConfirmPrivateVirtualInterfaceRequest": { - "base": "

Container for the parameters to the ConfirmPrivateVirtualInterface operation.

", + "base": null, "refs": { } }, "ConfirmPrivateVirtualInterfaceResponse": { - "base": "

The response received when ConfirmPrivateVirtualInterface is called.

", + "base": null, "refs": { } }, "ConfirmPublicVirtualInterfaceRequest": { - "base": "

Container for the parameters to the ConfirmPublicVirtualInterface operation.

", + "base": null, "refs": { } }, "ConfirmPublicVirtualInterfaceResponse": { - "base": "

The response received when ConfirmPublicVirtualInterface is called.

", + "base": null, "refs": { } }, "Connection": { - "base": "

A connection represents the physical network connection between the AWS Direct Connect location and the customer.

", + "base": "

Information about an AWS Direct Connect connection.

", "refs": { "ConnectionList$member": null } }, "ConnectionId": { - "base": "

The ID of the connection. This field is also used as the ID type for operations that use multiple connection types (LAG, interconnect, and/or connection).

Example: dxcon-fg5678gh

Default: None

", - "refs": { - "AllocateHostedConnectionRequest$connectionId": "

The ID of the interconnect or LAG on which the connection will be provisioned.

Example: dxcon-456abc78 or dxlag-abc123

Default: None

", - "AllocatePrivateVirtualInterfaceRequest$connectionId": "

The connection ID on which the private virtual interface is provisioned.

Default: None

", - "AllocatePublicVirtualInterfaceRequest$connectionId": "

The connection ID on which the public virtual interface is provisioned.

Default: None

", - "AssociateConnectionWithLagRequest$connectionId": "

The ID of the connection.

Example: dxcon-abc123

Default: None

", - "AssociateHostedConnectionRequest$connectionId": "

The ID of the hosted connection.

Example: dxcon-abc123

Default: None

", - "AssociateHostedConnectionRequest$parentConnectionId": "

The ID of the interconnect or the LAG.

Example: dxcon-abc123 or dxlag-abc123

Default: None

", - "AssociateVirtualInterfaceRequest$connectionId": "

The ID of the LAG or connection with which to associate the virtual interface.

Example: dxlag-abc123 or dxcon-abc123

Default: None

", - "ConfirmConnectionRequest$connectionId": null, - "Connection$connectionId": null, - "CreateLagRequest$connectionId": "

The ID of an existing connection to migrate to the LAG.

Default: None

", - "CreatePrivateVirtualInterfaceRequest$connectionId": null, - "CreatePublicVirtualInterfaceRequest$connectionId": null, - "DeleteConnectionRequest$connectionId": null, - "DescribeConnectionLoaRequest$connectionId": null, - "DescribeConnectionsRequest$connectionId": null, - "DescribeHostedConnectionsRequest$connectionId": "

The ID of the interconnect or LAG on which the hosted connections are provisioned.

Example: dxcon-abc123 or dxlag-abc123

Default: None

", - "DescribeLoaRequest$connectionId": "

The ID of a connection, LAG, or interconnect for which to get the LOA-CFA information.

Example: dxcon-abc123 or dxlag-abc123

Default: None

", - "DescribeVirtualInterfacesRequest$connectionId": null, - "DisassociateConnectionFromLagRequest$connectionId": "

The ID of the connection to disassociate from the LAG.

Example: dxcon-abc123

Default: None

", - "VirtualInterface$connectionId": null + "base": null, + "refs": { + "AllocateHostedConnectionRequest$connectionId": "

The ID of the interconnect or LAG.

", + "AllocatePrivateVirtualInterfaceRequest$connectionId": "

The ID of the connection on which the private virtual interface is provisioned.

", + "AllocatePublicVirtualInterfaceRequest$connectionId": "

The ID of the connection on which the public virtual interface is provisioned.

", + "AssociateConnectionWithLagRequest$connectionId": "

The ID of the connection. For example, dxcon-abc123.

", + "AssociateHostedConnectionRequest$connectionId": "

The ID of the hosted connection.

", + "AssociateHostedConnectionRequest$parentConnectionId": "

The ID of the interconnect or the LAG.

", + "AssociateVirtualInterfaceRequest$connectionId": "

The ID of the LAG or connection.

", + "ConfirmConnectionRequest$connectionId": "

The ID of the hosted connection.

", + "Connection$connectionId": "

The ID of the connection.

", + "CreateLagRequest$connectionId": "

The ID of an existing connection to migrate to the LAG.

", + "CreatePrivateVirtualInterfaceRequest$connectionId": "

The ID of the connection.

", + "CreatePublicVirtualInterfaceRequest$connectionId": "

The ID of the connection.

", + "DeleteConnectionRequest$connectionId": "

The ID of the connection.

", + "DescribeConnectionLoaRequest$connectionId": "

The ID of the connection.

", + "DescribeConnectionsRequest$connectionId": "

The ID of the connection.

", + "DescribeHostedConnectionsRequest$connectionId": "

The ID of the interconnect or LAG.

", + "DescribeLoaRequest$connectionId": "

The ID of a connection, LAG, or interconnect.

", + "DescribeVirtualInterfacesRequest$connectionId": "

The ID of the connection.

", + "DisassociateConnectionFromLagRequest$connectionId": "

The ID of the connection. For example, dxcon-abc123.

", + "VirtualInterface$connectionId": "

The ID of the connection.

" } }, "ConnectionList": { - "base": "

A list of connections.

", + "base": null, "refs": { - "Connections$connections": "

A list of connections.

", - "Lag$connections": "

A list of connections bundled by this LAG.

" + "Connections$connections": "

The connections.

", + "Lag$connections": "

The connections bundled by the LAG.

" } }, "ConnectionName": { - "base": "

The name of the connection.

Example: \"My Connection to AWS\"

Default: None

", + "base": null, "refs": { - "AllocateConnectionOnInterconnectRequest$connectionName": "

Name of the provisioned connection.

Example: \"500M Connection to AWS\"

Default: None

", - "AllocateHostedConnectionRequest$connectionName": "

The name of the provisioned connection.

Example: \"500M Connection to AWS\"

Default: None

", - "Connection$connectionName": null, - "CreateConnectionRequest$connectionName": null + "AllocateConnectionOnInterconnectRequest$connectionName": "

The name of the provisioned connection.

", + "AllocateHostedConnectionRequest$connectionName": "

The name of the hosted connection.

", + "Connection$connectionName": "

The name of the connection.

", + "CreateConnectionRequest$connectionName": "

The name of the connection.

" } }, "ConnectionState": { - "base": "

State of the connection.

", + "base": null, "refs": { - "ConfirmConnectionResponse$connectionState": null, - "Connection$connectionState": null + "ConfirmConnectionResponse$connectionState": "

The state of the connection. The following are the possible values:

", + "Connection$connectionState": "

The state of the connection. The following are the possible values:

" } }, "Connections": { - "base": "

A structure containing a list of connections.

", + "base": null, "refs": { } }, "Count": { "base": null, "refs": { - "CreateLagRequest$numberOfConnections": "

The number of physical connections initially provisioned and bundled by the LAG.

Default: None

", + "CreateLagRequest$numberOfConnections": "

The number of physical connections initially provisioned and bundled by the LAG.

", "Lag$numberOfConnections": "

The number of physical connections bundled by the LAG, up to a maximum of 10.

", - "Lag$minimumLinks": "

The minimum number of physical connections that must be operational for the LAG itself to be operational. If the number of operational connections drops below this setting, the LAG state changes to down. This value can help to ensure that a LAG is not overutilized if a significant number of its bundled connections go down.

", - "UpdateLagRequest$minimumLinks": "

The minimum number of physical connections that must be operational for the LAG itself to be operational.

Default: None

" + "Lag$minimumLinks": "

The minimum number of physical connections that must be operational for the LAG itself to be operational.

", + "UpdateLagRequest$minimumLinks": "

The minimum number of physical connections that must be operational for the LAG itself to be operational.

" } }, "CreateBGPPeerRequest": { - "base": "

Container for the parameters to the CreateBGPPeer operation.

", + "base": null, "refs": { } }, "CreateBGPPeerResponse": { - "base": "

The response received when CreateBGPPeer is called.

", + "base": null, "refs": { } }, "CreateConnectionRequest": { - "base": "

Container for the parameters to the CreateConnection operation.

", + "base": null, "refs": { } }, "CreateDirectConnectGatewayAssociationRequest": { - "base": "

Container for the parameters to the CreateDirectConnectGatewayAssociation operation.

", + "base": null, "refs": { } }, "CreateDirectConnectGatewayAssociationResult": { - "base": "

Container for the response from the CreateDirectConnectGatewayAssociation API call

", + "base": null, "refs": { } }, "CreateDirectConnectGatewayRequest": { - "base": "

Container for the parameters to the CreateDirectConnectGateway operation.

", + "base": null, "refs": { } }, "CreateDirectConnectGatewayResult": { - "base": "

Container for the response from the CreateDirectConnectGateway API call

", + "base": null, "refs": { } }, "CreateInterconnectRequest": { - "base": "

Container for the parameters to the CreateInterconnect operation.

", + "base": null, "refs": { } }, "CreateLagRequest": { - "base": "

Container for the parameters to the CreateLag operation.

", + "base": null, "refs": { } }, "CreatePrivateVirtualInterfaceRequest": { - "base": "

Container for the parameters to the CreatePrivateVirtualInterface operation.

", + "base": null, "refs": { } }, "CreatePublicVirtualInterfaceRequest": { - "base": "

Container for the parameters to the CreatePublicVirtualInterface operation.

", + "base": null, "refs": { } }, "CustomerAddress": { - "base": "

IP address assigned to the customer interface.

Example: 192.168.1.2/30 or 2001:db8::2/125

", + "base": null, "refs": { - "BGPPeer$customerAddress": null, - "DeleteBGPPeerRequest$customerAddress": null, - "NewBGPPeer$customerAddress": null, - "NewPrivateVirtualInterface$customerAddress": null, - "NewPrivateVirtualInterfaceAllocation$customerAddress": null, - "NewPublicVirtualInterface$customerAddress": null, - "NewPublicVirtualInterfaceAllocation$customerAddress": null, - "VirtualInterface$customerAddress": null + "BGPPeer$customerAddress": "

The IP address assigned to the customer interface.

", + "DeleteBGPPeerRequest$customerAddress": "

The IP address assigned to the customer interface.

", + "NewBGPPeer$customerAddress": "

The IP address assigned to the customer interface.

", + "NewPrivateVirtualInterface$customerAddress": "

The IP address assigned to the customer interface.

", + "NewPrivateVirtualInterfaceAllocation$customerAddress": "

The IP address assigned to the customer interface.

", + "NewPublicVirtualInterface$customerAddress": "

The IP address assigned to the customer interface.

", + "NewPublicVirtualInterfaceAllocation$customerAddress": "

The IP address assigned to the customer interface.

", + "VirtualInterface$customerAddress": "

The IP address assigned to the customer interface.

" } }, "DeleteBGPPeerRequest": { - "base": "

Container for the parameters to the DeleteBGPPeer operation.

", + "base": null, "refs": { } }, "DeleteBGPPeerResponse": { - "base": "

The response received when DeleteBGPPeer is called.

", + "base": null, "refs": { } }, "DeleteConnectionRequest": { - "base": "

Container for the parameters to the DeleteConnection operation.

", + "base": null, "refs": { } }, "DeleteDirectConnectGatewayAssociationRequest": { - "base": "

Container for the parameters to the DeleteDirectConnectGatewayAssociation operation.

", + "base": null, "refs": { } }, "DeleteDirectConnectGatewayAssociationResult": { - "base": "

Container for the response from the DeleteDirectConnectGatewayAssociation API call

", + "base": null, "refs": { } }, "DeleteDirectConnectGatewayRequest": { - "base": "

Container for the parameters to the DeleteDirectConnectGateway operation.

", + "base": null, "refs": { } }, "DeleteDirectConnectGatewayResult": { - "base": "

Container for the response from the DeleteDirectConnectGateway API call

", + "base": null, "refs": { } }, "DeleteInterconnectRequest": { - "base": "

Container for the parameters to the DeleteInterconnect operation.

", + "base": null, "refs": { } }, "DeleteInterconnectResponse": { - "base": "

The response received when DeleteInterconnect is called.

", + "base": null, "refs": { } }, "DeleteLagRequest": { - "base": "

Container for the parameters to the DeleteLag operation.

", + "base": null, "refs": { } }, "DeleteVirtualInterfaceRequest": { - "base": "

Container for the parameters to the DeleteVirtualInterface operation.

", + "base": null, "refs": { } }, "DeleteVirtualInterfaceResponse": { - "base": "

The response received when DeleteVirtualInterface is called.

", + "base": null, "refs": { } }, "DescribeConnectionLoaRequest": { - "base": "

Container for the parameters to the DescribeConnectionLoa operation.

", + "base": null, "refs": { } }, "DescribeConnectionLoaResponse": { - "base": "

The response received when DescribeConnectionLoa is called.

", + "base": null, "refs": { } }, "DescribeConnectionsOnInterconnectRequest": { - "base": "

Container for the parameters to the DescribeConnectionsOnInterconnect operation.

", + "base": null, "refs": { } }, "DescribeConnectionsRequest": { - "base": "

Container for the parameters to the DescribeConnections operation.

", + "base": null, "refs": { } }, "DescribeDirectConnectGatewayAssociationsRequest": { - "base": "

Container for the parameters to the DescribeDirectConnectGatewayAssociations operation.

", + "base": null, "refs": { } }, "DescribeDirectConnectGatewayAssociationsResult": { - "base": "

Container for the response from the DescribeDirectConnectGatewayAssociations API call

", + "base": null, "refs": { } }, "DescribeDirectConnectGatewayAttachmentsRequest": { - "base": "

Container for the parameters to the DescribeDirectConnectGatewayAttachments operation.

", + "base": null, "refs": { } }, "DescribeDirectConnectGatewayAttachmentsResult": { - "base": "

Container for the response from the DescribeDirectConnectGatewayAttachments API call

", + "base": null, "refs": { } }, "DescribeDirectConnectGatewaysRequest": { - "base": "

Container for the parameters to the DescribeDirectConnectGateways operation.

", + "base": null, "refs": { } }, "DescribeDirectConnectGatewaysResult": { - "base": "

Container for the response from the DescribeDirectConnectGateways API call

", + "base": null, "refs": { } }, "DescribeHostedConnectionsRequest": { - "base": "

Container for the parameters to the DescribeHostedConnections operation.

", + "base": null, "refs": { } }, "DescribeInterconnectLoaRequest": { - "base": "

Container for the parameters to the DescribeInterconnectLoa operation.

", + "base": null, "refs": { } }, "DescribeInterconnectLoaResponse": { - "base": "

The response received when DescribeInterconnectLoa is called.

", + "base": null, "refs": { } }, "DescribeInterconnectsRequest": { - "base": "

Container for the parameters to the DescribeInterconnects operation.

", + "base": null, "refs": { } }, "DescribeLagsRequest": { - "base": "

Container for the parameters to the DescribeLags operation.

", + "base": null, "refs": { } }, "DescribeLoaRequest": { - "base": "

Container for the parameters to the DescribeLoa operation.

", + "base": null, "refs": { } }, "DescribeTagsRequest": { - "base": "

Container for the parameters to the DescribeTags operation.

", + "base": null, "refs": { } }, "DescribeTagsResponse": { - "base": "

The response received when DescribeTags is called.

", + "base": null, "refs": { } }, "DescribeVirtualInterfacesRequest": { - "base": "

Container for the parameters to the DescribeVirtualInterfaces operation.

", + "base": null, "refs": { } }, "DirectConnectClientException": { - "base": "

The API was called with invalid parameters. The error message will contain additional details about the cause.

", + "base": "

One or more parameters are not valid.

", "refs": { } }, "DirectConnectGateway": { - "base": "

A direct connect gateway is an intermediate object that enables you to connect virtual interfaces and virtual private gateways.

", + "base": "

Information about a Direct Connect gateway, which enables you to connect virtual interfaces and virtual private gateways.

", "refs": { - "CreateDirectConnectGatewayResult$directConnectGateway": "

The direct connect gateway to be created.

", - "DeleteDirectConnectGatewayResult$directConnectGateway": "

The direct connect gateway to be deleted.

", + "CreateDirectConnectGatewayResult$directConnectGateway": "

The Direct Connect gateway.

", + "DeleteDirectConnectGatewayResult$directConnectGateway": "

The Direct Connect gateway.

", "DirectConnectGatewayList$member": null } }, "DirectConnectGatewayAssociation": { - "base": "

The association between a direct connect gateway and virtual private gateway.

", + "base": "

Information about an association between a Direct Connect gateway and a virtual private gateway.

", "refs": { - "CreateDirectConnectGatewayAssociationResult$directConnectGatewayAssociation": "

The direct connect gateway association to be created.

", - "DeleteDirectConnectGatewayAssociationResult$directConnectGatewayAssociation": "

The direct connect gateway association to be deleted.

", + "CreateDirectConnectGatewayAssociationResult$directConnectGatewayAssociation": "

The association to be created.

", + "DeleteDirectConnectGatewayAssociationResult$directConnectGatewayAssociation": "

The association to be deleted.

", "DirectConnectGatewayAssociationList$member": null } }, "DirectConnectGatewayAssociationList": { - "base": "

A list of direct connect gateway associations.

", + "base": null, "refs": { - "DescribeDirectConnectGatewayAssociationsResult$directConnectGatewayAssociations": "

Information about the direct connect gateway associations.

" + "DescribeDirectConnectGatewayAssociationsResult$directConnectGatewayAssociations": "

The associations.

" } }, "DirectConnectGatewayAssociationState": { - "base": "

State of the direct connect gateway association.

", + "base": null, "refs": { - "DirectConnectGatewayAssociation$associationState": null + "DirectConnectGatewayAssociation$associationState": "

The state of the association. The following are the possible values:

" } }, "DirectConnectGatewayAttachment": { - "base": "

The association between a direct connect gateway and virtual interface.

", + "base": "

Information about an attachment between a Direct Connect gateway and a virtual interface.

", "refs": { "DirectConnectGatewayAttachmentList$member": null } }, "DirectConnectGatewayAttachmentList": { - "base": "

A list of direct connect gateway attachments.

", + "base": null, "refs": { - "DescribeDirectConnectGatewayAttachmentsResult$directConnectGatewayAttachments": "

Information about the direct connect gateway attachments.

" + "DescribeDirectConnectGatewayAttachmentsResult$directConnectGatewayAttachments": "

The attachments.

" } }, "DirectConnectGatewayAttachmentState": { - "base": "

State of the direct connect gateway attachment.

", + "base": null, "refs": { - "DirectConnectGatewayAttachment$attachmentState": null + "DirectConnectGatewayAttachment$attachmentState": "

The state of the attachment. The following are the possible values:

" } }, "DirectConnectGatewayId": { - "base": "

The ID of the direct connect gateway.

Example: \"abcd1234-dcba-5678-be23-cdef9876ab45\"

", - "refs": { - "ConfirmPrivateVirtualInterfaceRequest$directConnectGatewayId": "

ID of the direct connect gateway that will be attached to the virtual interface.

A direct connect gateway can be managed via the AWS Direct Connect console or the CreateDirectConnectGateway action.

Default: None

", - "CreateDirectConnectGatewayAssociationRequest$directConnectGatewayId": "

The ID of the direct connect gateway.

Example: \"abcd1234-dcba-5678-be23-cdef9876ab45\"

Default: None

", - "DeleteDirectConnectGatewayAssociationRequest$directConnectGatewayId": "

The ID of the direct connect gateway.

Example: \"abcd1234-dcba-5678-be23-cdef9876ab45\"

Default: None

", - "DeleteDirectConnectGatewayRequest$directConnectGatewayId": "

The ID of the direct connect gateway.

Example: \"abcd1234-dcba-5678-be23-cdef9876ab45\"

Default: None

", - "DescribeDirectConnectGatewayAssociationsRequest$directConnectGatewayId": "

The ID of the direct connect gateway.

Example: \"abcd1234-dcba-5678-be23-cdef9876ab45\"

Default: None

", - "DescribeDirectConnectGatewayAttachmentsRequest$directConnectGatewayId": "

The ID of the direct connect gateway.

Example: \"abcd1234-dcba-5678-be23-cdef9876ab45\"

Default: None

", - "DescribeDirectConnectGatewaysRequest$directConnectGatewayId": "

The ID of the direct connect gateway.

Example: \"abcd1234-dcba-5678-be23-cdef9876ab45\"

Default: None

", - "DirectConnectGateway$directConnectGatewayId": null, - "DirectConnectGatewayAssociation$directConnectGatewayId": null, - "DirectConnectGatewayAttachment$directConnectGatewayId": null, - "NewPrivateVirtualInterface$directConnectGatewayId": null, - "VirtualInterface$directConnectGatewayId": null + "base": null, + "refs": { + "ConfirmPrivateVirtualInterfaceRequest$directConnectGatewayId": "

The ID of the Direct Connect gateway.

", + "CreateDirectConnectGatewayAssociationRequest$directConnectGatewayId": "

The ID of the Direct Connect gateway.

", + "DeleteDirectConnectGatewayAssociationRequest$directConnectGatewayId": "

The ID of the Direct Connect gateway.

", + "DeleteDirectConnectGatewayRequest$directConnectGatewayId": "

The ID of the Direct Connect gateway.

", + "DescribeDirectConnectGatewayAssociationsRequest$directConnectGatewayId": "

The ID of the Direct Connect gateway.

", + "DescribeDirectConnectGatewayAttachmentsRequest$directConnectGatewayId": "

The ID of the Direct Connect gateway.

", + "DescribeDirectConnectGatewaysRequest$directConnectGatewayId": "

The ID of the Direct Connect gateway.

", + "DirectConnectGateway$directConnectGatewayId": "

The ID of the Direct Connect gateway.

", + "DirectConnectGatewayAssociation$directConnectGatewayId": "

The ID of the Direct Connect gateway.

", + "DirectConnectGatewayAttachment$directConnectGatewayId": "

The ID of the Direct Connect gateway.

", + "NewPrivateVirtualInterface$directConnectGatewayId": "

The ID of the Direct Connect gateway.

", + "VirtualInterface$directConnectGatewayId": "

The ID of the Direct Connect gateway.

" } }, "DirectConnectGatewayList": { - "base": "

A list of direct connect gateways.

", + "base": null, "refs": { - "DescribeDirectConnectGatewaysResult$directConnectGateways": "

Information about the direct connect gateways.

" + "DescribeDirectConnectGatewaysResult$directConnectGateways": "

The Direct Connect gateways.

" } }, "DirectConnectGatewayName": { - "base": "

The name of the direct connect gateway.

Example: \"My direct connect gateway\"

Default: None

", + "base": null, "refs": { - "CreateDirectConnectGatewayRequest$directConnectGatewayName": "

The name of the direct connect gateway.

Example: \"My direct connect gateway\"

Default: None

", - "DirectConnectGateway$directConnectGatewayName": null + "CreateDirectConnectGatewayRequest$directConnectGatewayName": "

The name of the Direct Connect gateway.

", + "DirectConnectGateway$directConnectGatewayName": "

The name of the Direct Connect gateway.

" } }, "DirectConnectGatewayState": { - "base": "

State of the direct connect gateway.

", + "base": null, "refs": { - "DirectConnectGateway$directConnectGatewayState": null + "DirectConnectGateway$directConnectGatewayState": "

The state of the Direct Connect gateway. The following are the possible values:

" } }, "DirectConnectServerException": { - "base": "

A server-side error occurred during the API call. The error message will contain additional details about the cause.

", + "base": "

A server-side error occurred.

", "refs": { } }, "DisassociateConnectionFromLagRequest": { - "base": "

Container for the parameters to the DisassociateConnectionFromLag operation.

", + "base": null, "refs": { } }, @@ -625,233 +626,251 @@ "ErrorMessage": { "base": null, "refs": { - "DirectConnectClientException$message": "

This is an exception thrown when there is an issue with the input provided by the API call. For example, the name provided for a connection contains a pound sign (#). This can also occur when a valid value is provided, but is otherwise constrained. For example, the valid VLAN tag range is 1-4096 but each can only be used once per connection.

", - "DirectConnectServerException$message": "

This is an exception thrown when there is a backend issue on the server side.

" + "DirectConnectClientException$message": null, + "DirectConnectServerException$message": null } }, "Interconnect": { - "base": "

An interconnect is a connection that can host other connections.

Like a standard AWS Direct Connect connection, an interconnect represents the physical connection between an AWS Direct Connect partner's network and a specific Direct Connect location. An AWS Direct Connect partner who owns an interconnect can provision hosted connections on the interconnect for their end customers, thereby providing the end customers with connectivity to AWS services.

The resources of the interconnect, including bandwidth and VLAN numbers, are shared by all of the hosted connections on the interconnect, and the owner of the interconnect determines how these resources are assigned.

", + "base": "

Information about an interconnect.

", "refs": { "InterconnectList$member": null } }, "InterconnectId": { - "base": "

The ID of the interconnect.

Example: dxcon-abc123

", + "base": null, "refs": { - "AllocateConnectionOnInterconnectRequest$interconnectId": "

ID of the interconnect on which the connection will be provisioned.

Example: dxcon-456abc78

Default: None

", - "DeleteInterconnectRequest$interconnectId": null, - "DescribeConnectionsOnInterconnectRequest$interconnectId": "

ID of the interconnect on which a list of connection is provisioned.

Example: dxcon-abc123

Default: None

", - "DescribeInterconnectLoaRequest$interconnectId": null, - "DescribeInterconnectsRequest$interconnectId": null, - "Interconnect$interconnectId": null + "AllocateConnectionOnInterconnectRequest$interconnectId": "

The ID of the interconnect on which the connection will be provisioned. For example, dxcon-456abc78.

", + "DeleteInterconnectRequest$interconnectId": "

The ID of the interconnect.

", + "DescribeConnectionsOnInterconnectRequest$interconnectId": "

The ID of the interconnect.

", + "DescribeInterconnectLoaRequest$interconnectId": "

The ID of the interconnect.

", + "DescribeInterconnectsRequest$interconnectId": "

The ID of the interconnect.

", + "Interconnect$interconnectId": "

The ID of the interconnect.

" } }, "InterconnectList": { - "base": "

A list of interconnects.

", + "base": null, "refs": { - "Interconnects$interconnects": "

A list of interconnects.

" + "Interconnects$interconnects": "

The interconnects.

" } }, "InterconnectName": { - "base": "

The name of the interconnect.

Example: \"1G Interconnect to AWS\"

", + "base": null, "refs": { - "CreateInterconnectRequest$interconnectName": "

The name of the interconnect.

Example: \"1G Interconnect to AWS\"

Default: None

", - "Interconnect$interconnectName": null + "CreateInterconnectRequest$interconnectName": "

The name of the interconnect.

", + "Interconnect$interconnectName": "

The name of the interconnect.

" } }, "InterconnectState": { - "base": "

State of the interconnect.

", + "base": null, "refs": { - "DeleteInterconnectResponse$interconnectState": null, - "Interconnect$interconnectState": null + "DeleteInterconnectResponse$interconnectState": "

The state of the interconnect. The following are the possible values:

", + "Interconnect$interconnectState": "

The state of the interconnect. The following are the possible values:

" } }, "Interconnects": { - "base": "

A structure containing a list of interconnects.

", + "base": null, + "refs": { + } + }, + "JumboFrameCapable": { + "base": null, "refs": { + "Connection$jumboFrameCapable": "

Indicates whether jumbo frames (9001 MTU) are supported.

", + "Interconnect$jumboFrameCapable": "

Indicates whether jumbo frames (9001 MTU) are supported.

", + "Lag$jumboFrameCapable": "

Indicates whether jumbo frames (9001 MTU) are supported.

", + "VirtualInterface$jumboFrameCapable": "

Indicates whether jumbo frames (9001 MTU) are supported.

" } }, "Lag": { - "base": "

Describes a link aggregation group (LAG). A LAG is a connection that uses the Link Aggregation Control Protocol (LACP) to logically aggregate a bundle of physical connections. Like an interconnect, it can host other connections. All connections in a LAG must terminate on the same physical AWS Direct Connect endpoint, and must be the same bandwidth.

", + "base": "

Information about a link aggregation group (LAG).

", "refs": { "LagList$member": null } }, "LagId": { - "base": "

The ID of the LAG.

Example: dxlag-fg5678gh

", + "base": null, "refs": { - "AssociateConnectionWithLagRequest$lagId": "

The ID of the LAG with which to associate the connection.

Example: dxlag-abc123

Default: None

", - "Connection$lagId": null, - "CreateConnectionRequest$lagId": null, - "CreateInterconnectRequest$lagId": null, - "DeleteLagRequest$lagId": "

The ID of the LAG to delete.

Example: dxlag-abc123

Default: None

", - "DescribeLagsRequest$lagId": "

The ID of the LAG.

Example: dxlag-abc123

Default: None

", - "DisassociateConnectionFromLagRequest$lagId": "

The ID of the LAG.

Example: dxlag-abc123

Default: None

", - "Interconnect$lagId": null, - "Lag$lagId": null, - "UpdateLagRequest$lagId": "

The ID of the LAG to update.

Example: dxlag-abc123

Default: None

" + "AssociateConnectionWithLagRequest$lagId": "

The ID of the LAG with which to associate the connection. For example, dxlag-abc123.

", + "Connection$lagId": "

The ID of the LAG.

", + "CreateConnectionRequest$lagId": "

The ID of the LAG.

", + "CreateInterconnectRequest$lagId": "

The ID of the LAG.

", + "DeleteLagRequest$lagId": "

The ID of the LAG.

", + "DescribeLagsRequest$lagId": "

The ID of the LAG.

", + "DisassociateConnectionFromLagRequest$lagId": "

The ID of the LAG. For example, dxlag-abc123.

", + "Interconnect$lagId": "

The ID of the LAG.

", + "Lag$lagId": "

The ID of the LAG.

", + "UpdateLagRequest$lagId": "

The ID of the LAG.

" } }, "LagList": { - "base": "

A list of LAGs.

", + "base": null, "refs": { - "Lags$lags": "

A list of LAGs.

" + "Lags$lags": "

The LAGs.

" } }, "LagName": { "base": null, "refs": { - "CreateLagRequest$lagName": "

The name of the LAG.

Example: \"3x10G LAG to AWS\"

Default: None

", + "CreateLagRequest$lagName": "

The name of the LAG.

", "Lag$lagName": "

The name of the LAG.

", - "UpdateLagRequest$lagName": "

The name for the LAG.

Example: \"3x10G LAG to AWS\"

Default: None

" + "UpdateLagRequest$lagName": "

The name of the LAG.

" } }, "LagState": { - "base": "

The state of the LAG.

", + "base": null, "refs": { - "Lag$lagState": null + "Lag$lagState": "

The state of the LAG. The following are the possible values:

" } }, "Lags": { - "base": "

A structure containing a list of LAGs.

", + "base": null, "refs": { } }, "Loa": { - "base": "

A structure containing the Letter of Authorization - Connecting Facility Assignment (LOA-CFA) for a connection.

", + "base": "

Information about a Letter of Authorization - Connecting Facility Assignment (LOA-CFA) for a connection.

", "refs": { - "DescribeConnectionLoaResponse$loa": null, - "DescribeInterconnectLoaResponse$loa": null + "DescribeConnectionLoaResponse$loa": "

The Letter of Authorization - Connecting Facility Assignment (LOA-CFA).

", + "DescribeInterconnectLoaResponse$loa": "

The Letter of Authorization - Connecting Facility Assignment (LOA-CFA).

" } }, "LoaContent": { - "base": "

The binary contents of the LOA-CFA document.

", + "base": null, "refs": { - "Loa$loaContent": null + "Loa$loaContent": "

The binary contents of the LOA-CFA document.

" } }, "LoaContentType": { - "base": "

A standard media type indicating the content type of the LOA-CFA document. Currently, the only supported value is \"application/pdf\".

Default: application/pdf

", + "base": null, "refs": { - "DescribeConnectionLoaRequest$loaContentType": null, - "DescribeInterconnectLoaRequest$loaContentType": null, - "DescribeLoaRequest$loaContentType": "

A standard media type indicating the content type of the LOA-CFA document. Currently, the only supported value is \"application/pdf\".

Default: application/pdf

", - "Loa$loaContentType": null + "DescribeConnectionLoaRequest$loaContentType": "

The standard media type for the LOA-CFA document. The only supported value is application/pdf.

", + "DescribeInterconnectLoaRequest$loaContentType": "

The standard media type for the LOA-CFA document. The only supported value is application/pdf.

", + "DescribeLoaRequest$loaContentType": "

The standard media type for the LOA-CFA document. The only supported value is application/pdf.

", + "Loa$loaContentType": "

The standard media type for the LOA-CFA document. The only supported value is application/pdf.

" } }, "LoaIssueTime": { "base": null, "refs": { "Connection$loaIssueTime": "

The time of the most recent call to DescribeLoa for this connection.

", - "Interconnect$loaIssueTime": "

The time of the most recent call to DescribeInterconnectLoa for this Interconnect.

" + "Interconnect$loaIssueTime": "

The time of the most recent call to DescribeLoa for this connection.

" } }, "Location": { - "base": "

An AWS Direct Connect location where connections and interconnects can be requested.

", + "base": "

Information about an AWS Direct Connect location.

", "refs": { "LocationList$member": null } }, "LocationCode": { - "base": "

Where the connection is located.

Example: EqSV5

Default: None

", + "base": null, "refs": { - "Connection$location": null, - "CreateConnectionRequest$location": null, - "CreateInterconnectRequest$location": "

Where the interconnect is located

Example: EqSV5

Default: None

", - "CreateLagRequest$location": "

The AWS Direct Connect location in which the LAG should be allocated.

Example: EqSV5

Default: None

", - "Interconnect$location": null, - "Lag$location": null, - "Location$locationCode": "

The code used to indicate the AWS Direct Connect location.

", - "VirtualInterface$location": null + "Connection$location": "

The location of the connection.

", + "CreateConnectionRequest$location": "

The location of the connection.

", + "CreateInterconnectRequest$location": "

The location of the interconnect.

", + "CreateLagRequest$location": "

The location for the LAG.

", + "Interconnect$location": "

The location of the connection.

", + "Lag$location": "

The location of the LAG.

", + "Location$locationCode": "

The code for the location.

", + "VirtualInterface$location": "

The location of the connection.

" } }, "LocationList": { "base": null, "refs": { - "Locations$locations": "

A list of colocation hubs where network providers have equipment. Most regions have multiple locations available.

" + "Locations$locations": "

The locations.

" } }, "LocationName": { "base": null, "refs": { - "Location$locationName": "

The name of the AWS Direct Connect location. The name includes the colocation partner name and the physical site of the lit building.

" + "Location$locationName": "

The name of the location. This includes the name of the colocation partner and the physical site of the building.

" } }, "Locations": { - "base": "

A location is a network facility where AWS Direct Connect routers are available to be connected. Generally, these are colocation hubs where many network providers have equipment, and where cross connects can be delivered. Locations include a name and facility code, and must be provided when creating a connection.

", + "base": null, "refs": { } }, "LongAsn": { "base": null, "refs": { - "CreateDirectConnectGatewayRequest$amazonSideAsn": "

The autonomous system number (ASN) for Border Gateway Protocol (BGP) to be configured on the Amazon side of the connection. The ASN must be in the private range of 64,512 to 65,534 or 4,200,000,000 to 4,294,967,294

Example: 65200

Default: 64512

", + "CreateDirectConnectGatewayRequest$amazonSideAsn": "

The autonomous system number (ASN) for Border Gateway Protocol (BGP) to be configured on the Amazon side of the connection. The ASN must be in the private range of 64,512 to 65,534 or 4,200,000,000 to 4,294,967,294. The default is 64512.

", "DirectConnectGateway$amazonSideAsn": "

The autonomous system number (ASN) for the Amazon side of the connection.

", "VirtualInterface$amazonSideAsn": "

The autonomous system number (ASN) for the Amazon side of the connection.

" } }, + "MTU": { + "base": null, + "refs": { + "NewPrivateVirtualInterface$mtu": "

The maximum transmission unit (MTU), in bytes. The supported values are 1500 and 9001. The default value is 1500.

", + "NewPrivateVirtualInterfaceAllocation$mtu": "

The maximum transmission unit (MTU), in bytes. The supported values are 1500 and 9001. The default value is 1500.

", + "UpdateVirtualInterfaceAttributesRequest$mtu": "

The maximum transmission unit (MTU), in bytes. The supported values are 1500 and 9001. The default value is 1500.

", + "VirtualInterface$mtu": "

The maximum transmission unit (MTU), in bytes. The supported values are 1500 and 9001. The default value is 1500.

" + } + }, "MaxResultSetSize": { - "base": "

Maximum number of objects to return per page.

", + "base": null, "refs": { - "DescribeDirectConnectGatewayAssociationsRequest$maxResults": "

The maximum number of direct connect gateway associations to return per page.

Example: 15

Default: None

", - "DescribeDirectConnectGatewayAttachmentsRequest$maxResults": "

The maximum number of direct connect gateway attachments to return per page.

Example: 15

Default: None

", - "DescribeDirectConnectGatewaysRequest$maxResults": "

The maximum number of direct connect gateways to return per page.

Example: 15

Default: None

" + "DescribeDirectConnectGatewayAssociationsRequest$maxResults": "

The maximum number of associations to return per page.

", + "DescribeDirectConnectGatewayAttachmentsRequest$maxResults": "

The maximum number of attachments to return per page.

", + "DescribeDirectConnectGatewaysRequest$maxResults": "

The maximum number of Direct Connect gateways to return per page.

" } }, "NewBGPPeer": { - "base": "

A structure containing information about a new BGP peer.

", + "base": "

Information about a new BGP peer.

", "refs": { - "CreateBGPPeerRequest$newBGPPeer": "

Detailed information for the BGP peer to be created.

Default: None

" + "CreateBGPPeerRequest$newBGPPeer": "

Information about the BGP peer.

" } }, "NewPrivateVirtualInterface": { - "base": "

A structure containing information about a new private virtual interface.

", + "base": "

Information about a private virtual interface.

", "refs": { - "CreatePrivateVirtualInterfaceRequest$newPrivateVirtualInterface": "

Detailed information for the private virtual interface to be created.

Default: None

" + "CreatePrivateVirtualInterfaceRequest$newPrivateVirtualInterface": "

Information about the private virtual interface.

" } }, "NewPrivateVirtualInterfaceAllocation": { - "base": "

A structure containing information about a private virtual interface that will be provisioned on a connection.

", + "base": "

Information about a private virtual interface to be provisioned on a connection.

", "refs": { - "AllocatePrivateVirtualInterfaceRequest$newPrivateVirtualInterfaceAllocation": "

Detailed information for the private virtual interface to be provisioned.

Default: None

" + "AllocatePrivateVirtualInterfaceRequest$newPrivateVirtualInterfaceAllocation": "

Information about the private virtual interface.

" } }, "NewPublicVirtualInterface": { - "base": "

A structure containing information about a new public virtual interface.

", + "base": "

Information about a public virtual interface.

", "refs": { - "CreatePublicVirtualInterfaceRequest$newPublicVirtualInterface": "

Detailed information for the public virtual interface to be created.

Default: None

" + "CreatePublicVirtualInterfaceRequest$newPublicVirtualInterface": "

Information about the public virtual interface.

" } }, "NewPublicVirtualInterfaceAllocation": { - "base": "

A structure containing information about a public virtual interface that will be provisioned on a connection.

", + "base": "

Information about a public virtual interface to be provisioned on a connection.

", "refs": { - "AllocatePublicVirtualInterfaceRequest$newPublicVirtualInterfaceAllocation": "

Detailed information for the public virtual interface to be provisioned.

Default: None

" + "AllocatePublicVirtualInterfaceRequest$newPublicVirtualInterfaceAllocation": "

Information about the public virtual interface.

" } }, "OwnerAccount": { "base": null, "refs": { - "AllocateConnectionOnInterconnectRequest$ownerAccount": "

Numeric account Id of the customer for whom the connection will be provisioned.

Example: 123443215678

Default: None

", - "AllocateHostedConnectionRequest$ownerAccount": "

The numeric account ID of the customer for whom the connection will be provisioned.

Example: 123443215678

Default: None

", - "AllocatePrivateVirtualInterfaceRequest$ownerAccount": "

The AWS account that will own the new private virtual interface.

Default: None

", - "AllocatePublicVirtualInterfaceRequest$ownerAccount": "

The AWS account that will own the new public virtual interface.

Default: None

", - "Connection$ownerAccount": "

The AWS account that will own the new connection.

", - "DirectConnectGateway$ownerAccount": "

The AWS account ID of the owner of the direct connect gateway.

", - "DirectConnectGatewayAssociation$virtualGatewayOwnerAccount": "

The AWS account ID of the owner of the virtual private gateway.

", - "DirectConnectGatewayAttachment$virtualInterfaceOwnerAccount": "

The AWS account ID of the owner of the virtual interface.

", - "Lag$ownerAccount": "

The owner of the LAG.

", - "VirtualInterface$ownerAccount": "

The AWS account that will own the new virtual interface.

" + "AllocateConnectionOnInterconnectRequest$ownerAccount": "

The ID of the AWS account of the customer for whom the connection will be provisioned.

", + "AllocateHostedConnectionRequest$ownerAccount": "

The ID of the AWS account ID of the customer for the connection.

", + "AllocatePrivateVirtualInterfaceRequest$ownerAccount": "

The ID of the AWS account that owns the virtual private interface.

", + "AllocatePublicVirtualInterfaceRequest$ownerAccount": "

The ID of the AWS account that owns the public virtual interface.

", + "Connection$ownerAccount": "

The ID of the AWS account that owns the connection.

", + "DirectConnectGateway$ownerAccount": "

The ID of the AWS account that owns the Direct Connect gateway.

", + "DirectConnectGatewayAssociation$virtualGatewayOwnerAccount": "

The ID of the AWS account that owns the virtual private gateway.

", + "DirectConnectGatewayAttachment$virtualInterfaceOwnerAccount": "

The ID of the AWS account that owns the virtual interface.

", + "Lag$ownerAccount": "

The ID of the AWS account that owns the LAG.

", + "VirtualInterface$ownerAccount": "

The ID of the AWS account that owns the virtual interface.

" } }, "PaginationToken": { - "base": "

Token to retrieve the next page of the result.

", + "base": null, "refs": { - "DescribeDirectConnectGatewayAssociationsRequest$nextToken": "

The token provided in the previous describe result to retrieve the next page of the result.

Default: None

", - "DescribeDirectConnectGatewayAssociationsResult$nextToken": null, - "DescribeDirectConnectGatewayAttachmentsRequest$nextToken": "

The token provided in the previous describe result to retrieve the next page of the result.

Default: None

", - "DescribeDirectConnectGatewayAttachmentsResult$nextToken": null, - "DescribeDirectConnectGatewaysRequest$nextToken": "

The token provided in the previous describe result to retrieve the next page of the result.

Default: None

", - "DescribeDirectConnectGatewaysResult$nextToken": null + "DescribeDirectConnectGatewayAssociationsRequest$nextToken": "

The token provided in the previous call to retrieve the next page.

", + "DescribeDirectConnectGatewayAssociationsResult$nextToken": "

The token to retrieve the next page.

", + "DescribeDirectConnectGatewayAttachmentsRequest$nextToken": "

The token provided in the previous call to retrieve the next page.

", + "DescribeDirectConnectGatewayAttachmentsResult$nextToken": "

The token to retrieve the next page.

", + "DescribeDirectConnectGatewaysRequest$nextToken": "

The token provided in the previous call to retrieve the next page.

", + "DescribeDirectConnectGatewaysResult$nextToken": "

The token to retrieve the next page.

" } }, "PartnerName": { @@ -863,38 +882,38 @@ "ProviderName": { "base": null, "refs": { - "DescribeConnectionLoaRequest$providerName": "

The name of the APN partner or service provider who establishes connectivity on your behalf. If you supply this parameter, the LOA-CFA lists the provider name alongside your company name as the requester of the cross connect.

Default: None

", - "DescribeInterconnectLoaRequest$providerName": "

The name of the service provider who establishes connectivity on your behalf. If you supply this parameter, the LOA-CFA lists the provider name alongside your company name as the requester of the cross connect.

Default: None

", - "DescribeLoaRequest$providerName": "

The name of the service provider who establishes connectivity on your behalf. If you supply this parameter, the LOA-CFA lists the provider name alongside your company name as the requester of the cross connect.

Default: None

" + "DescribeConnectionLoaRequest$providerName": "

The name of the APN partner or service provider who establishes connectivity on your behalf. If you specify this parameter, the LOA-CFA lists the provider name alongside your company name as the requester of the cross connect.

", + "DescribeInterconnectLoaRequest$providerName": "

The name of the service provider who establishes connectivity on your behalf. If you supply this parameter, the LOA-CFA lists the provider name alongside your company name as the requester of the cross connect.

", + "DescribeLoaRequest$providerName": "

The name of the service provider who establishes connectivity on your behalf. If you specify this parameter, the LOA-CFA lists the provider name alongside your company name as the requester of the cross connect.

" } }, "Region": { - "base": "

The AWS region where the connection is located.

Example: us-east-1

Default: None

", + "base": null, "refs": { - "Connection$region": null, - "Interconnect$region": null, - "Lag$region": null, - "Location$region": "

The AWS region where the AWS Direct connect location is located.

Example: us-east-1

Default: None

", - "VirtualInterface$region": "

The AWS region where the virtual interface is located.

Example: us-east-1

Default: None

" + "Connection$region": "

The AWS Region where the connection is located.

", + "Interconnect$region": "

The AWS Region where the connection is located.

", + "Lag$region": "

The AWS Region where the connection is located.

", + "Location$region": "

The AWS Region for the location.

", + "VirtualInterface$region": "

The AWS Region where the virtual interface is located.

" } }, "ResourceArn": { "base": null, "refs": { "ResourceArnList$member": null, - "ResourceTag$resourceArn": "

The Amazon Resource Name (ARN) of the Direct Connect resource.

", - "TagResourceRequest$resourceArn": "

The Amazon Resource Name (ARN) of the Direct Connect resource.

Example: arn:aws:directconnect:us-east-1:123456789012:dxcon/dxcon-fg5678gh

", - "UntagResourceRequest$resourceArn": "

The Amazon Resource Name (ARN) of the Direct Connect resource.

" + "ResourceTag$resourceArn": "

The Amazon Resource Name (ARN) of the resource.

", + "TagResourceRequest$resourceArn": "

The Amazon Resource Name (ARN) of the resource.

", + "UntagResourceRequest$resourceArn": "

The Amazon Resource Name (ARN) of the resource.

" } }, "ResourceArnList": { "base": null, "refs": { - "DescribeTagsRequest$resourceArns": "

The Amazon Resource Names (ARNs) of the Direct Connect resources.

" + "DescribeTagsRequest$resourceArns": "

The Amazon Resource Names (ARNs) of the resources.

" } }, "ResourceTag": { - "base": "

The tags associated with a Direct Connect resource.

", + "base": "

Information about a tag associated with an AWS Direct Connect resource.

", "refs": { "ResourceTagList$member": null } @@ -906,31 +925,31 @@ } }, "RouteFilterPrefix": { - "base": "

A route filter prefix that the customer can advertise through Border Gateway Protocol (BGP) over a public virtual interface.

", + "base": "

Information about a route filter prefix that a customer can advertise through Border Gateway Protocol (BGP) over a public virtual interface.

", "refs": { "RouteFilterPrefixList$member": null } }, "RouteFilterPrefixList": { - "base": "

A list of routes to be advertised to the AWS network in this region (public virtual interface).

", + "base": null, "refs": { - "NewPublicVirtualInterface$routeFilterPrefixes": null, - "NewPublicVirtualInterfaceAllocation$routeFilterPrefixes": null, - "VirtualInterface$routeFilterPrefixes": null + "NewPublicVirtualInterface$routeFilterPrefixes": "

The routes to be advertised to the AWS network in this Region. Applies to public virtual interfaces.

", + "NewPublicVirtualInterfaceAllocation$routeFilterPrefixes": "

The routes to be advertised to the AWS network in this Region. Applies to public virtual interfaces.

", + "VirtualInterface$routeFilterPrefixes": "

The routes to be advertised to the AWS network in this Region. Applies to public virtual interfaces.

" } }, "RouterConfig": { "base": null, "refs": { - "VirtualInterface$customerRouterConfig": "

Information for generating the customer router configuration.

" + "VirtualInterface$customerRouterConfig": "

The customer router configuration.

" } }, "StateChangeError": { - "base": "

Error message when the state of an object fails to advance.

", + "base": null, "refs": { - "DirectConnectGateway$stateChangeError": null, - "DirectConnectGatewayAssociation$stateChangeError": null, - "DirectConnectGatewayAttachment$stateChangeError": null + "DirectConnectGateway$stateChangeError": "

The error message if the state of an object failed to advance.

", + "DirectConnectGatewayAssociation$stateChangeError": "

The error message if the state of an object failed to advance.

", + "DirectConnectGatewayAttachment$stateChangeError": "

The error message if the state of an object failed to advance.

" } }, "Tag": { @@ -942,176 +961,182 @@ "TagKey": { "base": null, "refs": { - "Tag$key": "

The key of the tag.

", + "Tag$key": "

The key.

", "TagKeyList$member": null } }, "TagKeyList": { "base": null, "refs": { - "UntagResourceRequest$tagKeys": "

The list of tag keys to remove.

" + "UntagResourceRequest$tagKeys": "

The tag keys of the tags to remove.

" } }, "TagList": { "base": null, "refs": { "ResourceTag$tags": "

The tags.

", - "TagResourceRequest$tags": "

The list of tags to add.

" + "TagResourceRequest$tags": "

The tags to add.

" } }, "TagResourceRequest": { - "base": "

Container for the parameters to the TagResource operation.

", + "base": null, "refs": { } }, "TagResourceResponse": { - "base": "

The response received when TagResource is called.

", + "base": null, "refs": { } }, "TagValue": { "base": null, "refs": { - "Tag$value": "

The value of the tag.

" + "Tag$value": "

The value.

" } }, "TooManyTagsException": { - "base": "

You have reached the limit on the number of tags that can be assigned to a Direct Connect resource.

", + "base": "

You have reached the limit on the number of tags that can be assigned.

", "refs": { } }, "UntagResourceRequest": { - "base": "

Container for the parameters to the UntagResource operation.

", + "base": null, "refs": { } }, "UntagResourceResponse": { - "base": "

The response received when UntagResource is called.

", + "base": null, "refs": { } }, "UpdateLagRequest": { - "base": "

Container for the parameters to the UpdateLag operation.

", + "base": null, + "refs": { + } + }, + "UpdateVirtualInterfaceAttributesRequest": { + "base": null, "refs": { } }, "VLAN": { - "base": "

The VLAN ID.

Example: 101

", + "base": null, "refs": { - "AllocateConnectionOnInterconnectRequest$vlan": "

The dedicated VLAN provisioned to the connection.

Example: 101

Default: None

", - "AllocateHostedConnectionRequest$vlan": "

The dedicated VLAN provisioned to the hosted connection.

Example: 101

Default: None

", - "Connection$vlan": null, - "NewPrivateVirtualInterface$vlan": null, - "NewPrivateVirtualInterfaceAllocation$vlan": null, - "NewPublicVirtualInterface$vlan": null, - "NewPublicVirtualInterfaceAllocation$vlan": null, - "VirtualInterface$vlan": null + "AllocateConnectionOnInterconnectRequest$vlan": "

The dedicated VLAN provisioned to the connection.

", + "AllocateHostedConnectionRequest$vlan": "

The dedicated VLAN provisioned to the hosted connection.

", + "Connection$vlan": "

The ID of the VLAN.

", + "NewPrivateVirtualInterface$vlan": "

The ID of the VLAN.

", + "NewPrivateVirtualInterfaceAllocation$vlan": "

The ID of the VLAN.

", + "NewPublicVirtualInterface$vlan": "

The ID of the VLAN.

", + "NewPublicVirtualInterfaceAllocation$vlan": "

The ID of the VLAN.

", + "VirtualInterface$vlan": "

The ID of the VLAN.

" } }, "VirtualGateway": { - "base": "

You can create one or more AWS Direct Connect private virtual interfaces linking to your virtual private gateway.

Virtual private gateways can be managed using the Amazon Virtual Private Cloud (Amazon VPC) console or the Amazon EC2 CreateVpnGateway action.

", + "base": "

Information about a virtual private gateway for a private virtual interface.

", "refs": { "VirtualGatewayList$member": null } }, "VirtualGatewayId": { - "base": "

The ID of the virtual private gateway to a VPC. This only applies to private virtual interfaces.

Example: vgw-123er56

", + "base": null, "refs": { - "ConfirmPrivateVirtualInterfaceRequest$virtualGatewayId": "

ID of the virtual private gateway that will be attached to the virtual interface.

A virtual private gateway can be managed via the Amazon Virtual Private Cloud (VPC) console or the EC2 CreateVpnGateway action.

Default: None

", - "CreateDirectConnectGatewayAssociationRequest$virtualGatewayId": "

The ID of the virtual private gateway.

Example: \"vgw-abc123ef\"

Default: None

", - "DeleteDirectConnectGatewayAssociationRequest$virtualGatewayId": "

The ID of the virtual private gateway.

Example: \"vgw-abc123ef\"

Default: None

", - "DescribeDirectConnectGatewayAssociationsRequest$virtualGatewayId": "

The ID of the virtual private gateway.

Example: \"vgw-abc123ef\"

Default: None

", - "DirectConnectGatewayAssociation$virtualGatewayId": null, - "NewPrivateVirtualInterface$virtualGatewayId": null, - "VirtualGateway$virtualGatewayId": null, - "VirtualInterface$virtualGatewayId": null + "ConfirmPrivateVirtualInterfaceRequest$virtualGatewayId": "

The ID of the virtual private gateway.

", + "CreateDirectConnectGatewayAssociationRequest$virtualGatewayId": "

The ID of the virtual private gateway.

", + "DeleteDirectConnectGatewayAssociationRequest$virtualGatewayId": "

The ID of the virtual private gateway.

", + "DescribeDirectConnectGatewayAssociationsRequest$virtualGatewayId": "

The ID of the virtual private gateway.

", + "DirectConnectGatewayAssociation$virtualGatewayId": "

The ID of the virtual private gateway. Applies only to private virtual interfaces.

", + "NewPrivateVirtualInterface$virtualGatewayId": "

The ID of the virtual private gateway.

", + "VirtualGateway$virtualGatewayId": "

The ID of the virtual private gateway.

", + "VirtualInterface$virtualGatewayId": "

The ID of the virtual private gateway. Applies only to private virtual interfaces.

" } }, "VirtualGatewayList": { - "base": "

A list of virtual private gateways.

", + "base": null, "refs": { - "VirtualGateways$virtualGateways": "

A list of virtual private gateways.

" + "VirtualGateways$virtualGateways": "

The virtual private gateways.

" } }, "VirtualGatewayRegion": { - "base": "

The region in which the virtual private gateway is located.

Example: us-east-1

", + "base": null, "refs": { - "DirectConnectGatewayAssociation$virtualGatewayRegion": null + "DirectConnectGatewayAssociation$virtualGatewayRegion": "

The AWS Region where the virtual private gateway is located.

" } }, "VirtualGatewayState": { - "base": "

State of the virtual private gateway.

", + "base": null, "refs": { - "VirtualGateway$virtualGatewayState": null + "VirtualGateway$virtualGatewayState": "

The state of the virtual private gateway. The following are the possible values:

" } }, "VirtualGateways": { - "base": "

A structure containing a list of virtual private gateways.

", + "base": null, "refs": { } }, "VirtualInterface": { - "base": "

A virtual interface (VLAN) transmits the traffic between the AWS Direct Connect location and the customer.

", + "base": "

Information about a virtual interface.

", "refs": { - "CreateBGPPeerResponse$virtualInterface": null, - "DeleteBGPPeerResponse$virtualInterface": null, + "CreateBGPPeerResponse$virtualInterface": "

The virtual interface.

", + "DeleteBGPPeerResponse$virtualInterface": "

The virtual interface.

", "VirtualInterfaceList$member": null } }, "VirtualInterfaceId": { - "base": "

The ID of the virtual interface.

Example: dxvif-123dfg56

Default: None

", + "base": null, "refs": { - "AssociateVirtualInterfaceRequest$virtualInterfaceId": "

The ID of the virtual interface.

Example: dxvif-123dfg56

Default: None

", - "ConfirmPrivateVirtualInterfaceRequest$virtualInterfaceId": null, - "ConfirmPublicVirtualInterfaceRequest$virtualInterfaceId": null, - "CreateBGPPeerRequest$virtualInterfaceId": "

The ID of the virtual interface on which the BGP peer will be provisioned.

Example: dxvif-456abc78

Default: None

", - "DeleteBGPPeerRequest$virtualInterfaceId": "

The ID of the virtual interface from which the BGP peer will be deleted.

Example: dxvif-456abc78

Default: None

", - "DeleteVirtualInterfaceRequest$virtualInterfaceId": null, - "DescribeDirectConnectGatewayAttachmentsRequest$virtualInterfaceId": "

The ID of the virtual interface.

Example: \"dxvif-abc123ef\"

Default: None

", - "DescribeVirtualInterfacesRequest$virtualInterfaceId": null, - "DirectConnectGatewayAttachment$virtualInterfaceId": null, - "VirtualInterface$virtualInterfaceId": null + "AssociateVirtualInterfaceRequest$virtualInterfaceId": "

The ID of the virtual interface.

", + "ConfirmPrivateVirtualInterfaceRequest$virtualInterfaceId": "

The ID of the virtual interface.

", + "ConfirmPublicVirtualInterfaceRequest$virtualInterfaceId": "

The ID of the virtual interface.

", + "CreateBGPPeerRequest$virtualInterfaceId": "

The ID of the virtual interface.

", + "DeleteBGPPeerRequest$virtualInterfaceId": "

The ID of the virtual interface.

", + "DeleteVirtualInterfaceRequest$virtualInterfaceId": "

The ID of the virtual interface.

", + "DescribeDirectConnectGatewayAttachmentsRequest$virtualInterfaceId": "

The ID of the virtual interface.

", + "DescribeVirtualInterfacesRequest$virtualInterfaceId": "

The ID of the virtual interface.

", + "DirectConnectGatewayAttachment$virtualInterfaceId": "

The ID of the virtual interface.

", + "UpdateVirtualInterfaceAttributesRequest$virtualInterfaceId": "

The ID of the virtual private interface.

", + "VirtualInterface$virtualInterfaceId": "

The ID of the virtual interface.

" } }, "VirtualInterfaceList": { - "base": "

A list of virtual interfaces.

", + "base": null, "refs": { - "VirtualInterfaces$virtualInterfaces": "

A list of virtual interfaces.

" + "VirtualInterfaces$virtualInterfaces": "

The virtual interfaces

" } }, "VirtualInterfaceName": { - "base": "

The name of the virtual interface assigned by the customer.

Example: \"My VPC\"

", + "base": null, "refs": { - "NewPrivateVirtualInterface$virtualInterfaceName": null, - "NewPrivateVirtualInterfaceAllocation$virtualInterfaceName": null, - "NewPublicVirtualInterface$virtualInterfaceName": null, - "NewPublicVirtualInterfaceAllocation$virtualInterfaceName": null, - "VirtualInterface$virtualInterfaceName": null + "NewPrivateVirtualInterface$virtualInterfaceName": "

The name of the virtual interface assigned by the customer network.

", + "NewPrivateVirtualInterfaceAllocation$virtualInterfaceName": "

The name of the virtual interface assigned by the customer network.

", + "NewPublicVirtualInterface$virtualInterfaceName": "

The name of the virtual interface assigned by the customer network.

", + "NewPublicVirtualInterfaceAllocation$virtualInterfaceName": "

The name of the virtual interface assigned by the customer network.

", + "VirtualInterface$virtualInterfaceName": "

The name of the virtual interface assigned by the customer network.

" } }, "VirtualInterfaceRegion": { - "base": "

The region in which the virtual interface is located.

Example: us-east-1

", + "base": null, "refs": { - "DirectConnectGatewayAttachment$virtualInterfaceRegion": null + "DirectConnectGatewayAttachment$virtualInterfaceRegion": "

The AWS Region where the virtual interface is located.

" } }, "VirtualInterfaceState": { - "base": "

State of the virtual interface.

", + "base": null, "refs": { - "ConfirmPrivateVirtualInterfaceResponse$virtualInterfaceState": null, - "ConfirmPublicVirtualInterfaceResponse$virtualInterfaceState": null, - "DeleteVirtualInterfaceResponse$virtualInterfaceState": null, - "VirtualInterface$virtualInterfaceState": null + "ConfirmPrivateVirtualInterfaceResponse$virtualInterfaceState": "

The state of the virtual interface. The following are the possible values:

", + "ConfirmPublicVirtualInterfaceResponse$virtualInterfaceState": "

The state of the virtual interface. The following are the possible values:

", + "DeleteVirtualInterfaceResponse$virtualInterfaceState": "

The state of the virtual interface. The following are the possible values:

", + "VirtualInterface$virtualInterfaceState": "

The state of the virtual interface. The following are the possible values:

" } }, "VirtualInterfaceType": { - "base": "

The type of virtual interface.

Example: private (Amazon VPC) or public (Amazon S3, Amazon DynamoDB, and so on.)

", + "base": null, "refs": { - "VirtualInterface$virtualInterfaceType": null + "VirtualInterface$virtualInterfaceType": "

The type of virtual interface. The possible values are private and public.

" } }, "VirtualInterfaces": { - "base": "

A structure containing a list of virtual interfaces.

", + "base": null, "refs": { } } diff --git a/models/apis/directconnect/2012-10-25/smoke.json b/models/apis/directconnect/2012-10-25/smoke.json new file mode 100644 index 00000000000..565bd73414f --- /dev/null +++ b/models/apis/directconnect/2012-10-25/smoke.json @@ -0,0 +1,18 @@ +{ + "version": 1, + "defaultRegion": "us-west-2", + "testCases": [ + { + "operationName": "DescribeConnections", + "input": {}, + "errorExpectedFromService": false + }, + { + "operationName": "DescribeConnections", + "input": { + "connectionId": "fake-connection" + }, + "errorExpectedFromService": true + } + ] +} diff --git a/models/apis/ec2/2016-11-15/api-2.json b/models/apis/ec2/2016-11-15/api-2.json index 23e3dfafd3a..aacd559a8c2 100755 --- a/models/apis/ec2/2016-11-15/api-2.json +++ b/models/apis/ec2/2016-11-15/api-2.json @@ -11780,6 +11780,7 @@ "g3.4xlarge", "g3.8xlarge", "g3.16xlarge", + "g3s.xlarge", "cg1.4xlarge", "p2.xlarge", "p2.8xlarge", diff --git a/models/apis/es/2015-01-01/api-2.json b/models/apis/es/2015-01-01/api-2.json index 23148a8ece4..42a181d7362 100644 --- a/models/apis/es/2015-01-01/api-2.json +++ b/models/apis/es/2015-01-01/api-2.json @@ -24,6 +24,21 @@ {"shape":"InternalException"} ] }, + "CancelElasticsearchServiceSoftwareUpdate":{ + "name":"CancelElasticsearchServiceSoftwareUpdate", + "http":{ + "method":"POST", + "requestUri":"/2015-01-01/es/serviceSoftwareUpdate/cancel" + }, + "input":{"shape":"CancelElasticsearchServiceSoftwareUpdateRequest"}, + "output":{"shape":"CancelElasticsearchServiceSoftwareUpdateResponse"}, + "errors":[ + {"shape":"BaseException"}, + {"shape":"InternalException"}, + {"shape":"ResourceNotFoundException"}, + {"shape":"ValidationException"} + ] + }, "CreateElasticsearchDomain":{ "name":"CreateElasticsearchDomain", "http":{ @@ -295,6 +310,21 @@ {"shape":"InternalException"} ] }, + "StartElasticsearchServiceSoftwareUpdate":{ + "name":"StartElasticsearchServiceSoftwareUpdate", + "http":{ + "method":"POST", + "requestUri":"/2015-01-01/es/serviceSoftwareUpdate/start" + }, + "input":{"shape":"StartElasticsearchServiceSoftwareUpdateRequest"}, + "output":{"shape":"StartElasticsearchServiceSoftwareUpdateResponse"}, + "errors":[ + {"shape":"BaseException"}, + {"shape":"InternalException"}, + {"shape":"ResourceNotFoundException"}, + {"shape":"ValidationException"} + ] + }, "UpdateElasticsearchDomainConfig":{ "name":"UpdateElasticsearchDomainConfig", "http":{ @@ -389,6 +419,19 @@ "exception":true }, "Boolean":{"type":"boolean"}, + "CancelElasticsearchServiceSoftwareUpdateRequest":{ + "type":"structure", + "required":["DomainName"], + "members":{ + "DomainName":{"shape":"DomainName"} + } + }, + "CancelElasticsearchServiceSoftwareUpdateResponse":{ + "type":"structure", + "members":{ + "ServiceSoftwareOptions":{"shape":"ServiceSoftwareOptions"} + } + }, "CloudWatchLogsLogGroupArn":{"type":"string"}, "CognitoOptions":{ "type":"structure", @@ -462,6 +505,17 @@ "DomainStatus":{"shape":"ElasticsearchDomainStatus"} } }, + "DeploymentCloseDateTimeStamp":{"type":"timestamp"}, + "DeploymentStatus":{ + "type":"string", + "enum":[ + "PENDING_UPDATE", + "IN_PROGRESS", + "COMPLETED", + "NOT_ELIGIBLE", + "ELIGIBLE" + ] + }, "DescribeElasticsearchDomainConfigRequest":{ "type":"structure", "required":["DomainName"], @@ -760,7 +814,8 @@ "EncryptionAtRestOptions":{"shape":"EncryptionAtRestOptions"}, "NodeToNodeEncryptionOptions":{"shape":"NodeToNodeEncryptionOptions"}, "AdvancedOptions":{"shape":"AdvancedOptions"}, - "LogPublishingOptions":{"shape":"LogPublishingOptions"} + "LogPublishingOptions":{"shape":"LogPublishingOptions"}, + "ServiceSoftwareOptions":{"shape":"ServiceSoftwareOptions"} } }, "ElasticsearchDomainStatusList":{ @@ -1219,6 +1274,18 @@ "max":2048, "min":20 }, + "ServiceSoftwareOptions":{ + "type":"structure", + "members":{ + "CurrentVersion":{"shape":"String"}, + "NewVersion":{"shape":"String"}, + "UpdateAvailable":{"shape":"Boolean"}, + "Cancellable":{"shape":"Boolean"}, + "UpdateStatus":{"shape":"DeploymentStatus"}, + "Description":{"shape":"String"}, + "AutomatedUpdateDate":{"shape":"DeploymentCloseDateTimeStamp"} + } + }, "ServiceUrl":{"type":"string"}, "SnapshotOptions":{ "type":"structure", @@ -1237,6 +1304,19 @@ "Status":{"shape":"OptionStatus"} } }, + "StartElasticsearchServiceSoftwareUpdateRequest":{ + "type":"structure", + "required":["DomainName"], + "members":{ + "DomainName":{"shape":"DomainName"} + } + }, + "StartElasticsearchServiceSoftwareUpdateResponse":{ + "type":"structure", + "members":{ + "ServiceSoftwareOptions":{"shape":"ServiceSoftwareOptions"} + } + }, "StartTimestamp":{"type":"timestamp"}, "StorageSubTypeName":{"type":"string"}, "StorageType":{ diff --git a/models/apis/es/2015-01-01/docs-2.json b/models/apis/es/2015-01-01/docs-2.json index 996c73770e6..3b49591948f 100644 --- a/models/apis/es/2015-01-01/docs-2.json +++ b/models/apis/es/2015-01-01/docs-2.json @@ -3,6 +3,7 @@ "service": "Amazon Elasticsearch Configuration 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.

", "operations": { "AddTags": "

Attaches tags to an existing Elasticsearch domain. Tags are a set of case-sensitive key value pairs. An Elasticsearch domain may have up to 10 tags. See Tagging Amazon Elasticsearch Service Domains for more information.

", + "CancelElasticsearchServiceSoftwareUpdate": "

Cancels a scheduled service software update for an Amazon ES domain. You can only perform this operation before the AutomatedUpdateDate and when the UpdateStatus is in the PENDING_UPDATE state.

", "CreateElasticsearchDomain": "

Creates a new Elasticsearch domain. For more information, see Creating Elasticsearch Domains in the Amazon Elasticsearch Service Developer Guide.

", "DeleteElasticsearchDomain": "

Permanently deletes the specified Elasticsearch domain and all of its data. Once a domain is deleted, it cannot be recovered.

", "DeleteElasticsearchServiceRole": "

Deletes the service-linked role that Elasticsearch Service uses to manage and maintain VPC domains. Role deletion will fail if any existing VPC domains use the role. You must delete any such Elasticsearch domains before deleting the role. See Deleting Elasticsearch Service Role in VPC Endpoints for Amazon Elasticsearch Service Domains.

", @@ -21,6 +22,7 @@ "ListTags": "

Returns all tags for the given Elasticsearch domain.

", "PurchaseReservedElasticsearchInstanceOffering": "

Allows you to purchase reserved Elasticsearch instances.

", "RemoveTags": "

Removes the specified set of tags from the specified Elasticsearch domain.

", + "StartElasticsearchServiceSoftwareUpdate": "

Schedules a service software update for an Amazon ES domain.

", "UpdateElasticsearchDomainConfig": "

Modifies the cluster configuration of the specified Elasticsearch domain, setting as setting the instance type and the number of instances.

", "UpgradeElasticsearchDomain": "

Allows you to either upgrade your domain or perform an Upgrade eligibility check to a compatible Elasticsearch version.

" }, @@ -92,10 +94,22 @@ "LogPublishingOption$Enabled": "

Specifies whether given log publishing option is enabled or not.

", "NodeToNodeEncryptionOptions$Enabled": "

Specify true to enable node-to-node encryption.

", "OptionStatus$PendingDeletion": "

Indicates whether the Elasticsearch domain is being deleted.

", + "ServiceSoftwareOptions$UpdateAvailable": "

True if you are able to update you service software version. False if you are not able to update your service software version.

", + "ServiceSoftwareOptions$Cancellable": "

True if you are able to cancel your service software version update. False if you are not able to cancel your service software version.

", "UpgradeElasticsearchDomainRequest$PerformCheckOnly": "

This flag, when set to True, indicates that an Upgrade Eligibility Check needs to be performed. This will not actually perform the Upgrade.

", "UpgradeElasticsearchDomainResponse$PerformCheckOnly": "

This flag, when set to True, indicates that an Upgrade Eligibility Check needs to be performed. This will not actually perform the Upgrade.

" } }, + "CancelElasticsearchServiceSoftwareUpdateRequest": { + "base": "

Container for the parameters to the CancelElasticsearchServiceSoftwareUpdate operation. Specifies the name of the Elasticsearch domain that you wish to cancel a service software update on.

", + "refs": { + } + }, + "CancelElasticsearchServiceSoftwareUpdateResponse": { + "base": "

The result of a CancelElasticsearchServiceSoftwareUpdate operation. Contains the status of the update.

", + "refs": { + } + }, "CloudWatchLogsLogGroupArn": { "base": "

ARN of the Cloudwatch log group to which log needs to be published.

", "refs": { @@ -149,6 +163,18 @@ "refs": { } }, + "DeploymentCloseDateTimeStamp": { + "base": null, + "refs": { + "ServiceSoftwareOptions$AutomatedUpdateDate": "

Timestamp, in Epoch time, until which you can manually request a service software update. After this date, we automatically update your service software.

" + } + }, + "DeploymentStatus": { + "base": null, + "refs": { + "ServiceSoftwareOptions$UpdateStatus": "

The status of your service software update. This field can take the following values: ELIGIBLE, PENDING_UPDATE, IN_PROGRESS, COMPLETED, and NOT_ELIGIBLE.

" + } + }, "DescribeElasticsearchDomainConfigRequest": { "base": "

Container for the parameters to the DescribeElasticsearchDomainConfig operation. Specifies the domain name for which you want configuration information.

", "refs": { @@ -235,6 +261,7 @@ "DomainName": { "base": "

The name of an Elasticsearch domain. Domain names are unique across the domains owned by an account within an AWS region. Domain names start with a letter or number and can contain the following characters: a-z (lowercase), 0-9, and - (hyphen).

", "refs": { + "CancelElasticsearchServiceSoftwareUpdateRequest$DomainName": "

The name of the domain that you want to stop the latest service software update on.

", "CreateElasticsearchDomainRequest$DomainName": "

The name of the Elasticsearch domain that you are creating. Domain names are unique across the domains owned by an account within an AWS region. Domain names must start with a letter or number and can contain the following characters: a-z (lowercase), 0-9, and - (hyphen).

", "DeleteElasticsearchDomainRequest$DomainName": "

The name of the Elasticsearch domain that you want to permanently delete.

", "DescribeElasticsearchDomainConfigRequest$DomainName": "

The Elasticsearch domain that you want to get information about.

", @@ -247,6 +274,7 @@ "GetUpgradeHistoryRequest$DomainName": null, "GetUpgradeStatusRequest$DomainName": null, "ListElasticsearchInstanceTypesRequest$DomainName": "

DomainName represents the name of the Domain that we are trying to modify. This should be present only if we are querying for list of available Elasticsearch instance types when modifying existing domain.

", + "StartElasticsearchServiceSoftwareUpdateRequest$DomainName": "

The name of the domain that you want to update to the latest service software.

", "UpdateElasticsearchDomainConfigRequest$DomainName": "

The name of the Elasticsearch domain that you are updating.

", "UpgradeElasticsearchDomainRequest$DomainName": null, "UpgradeElasticsearchDomainResponse$DomainName": null @@ -770,6 +798,14 @@ "CognitoOptions$RoleArn": "

Specifies the role ARN that provides Elasticsearch permissions for accessing Cognito resources.

" } }, + "ServiceSoftwareOptions": { + "base": "

The current options of an Elasticsearch domain service software options.

", + "refs": { + "CancelElasticsearchServiceSoftwareUpdateResponse$ServiceSoftwareOptions": "

The current status of the Elasticsearch service software update.

", + "ElasticsearchDomainStatus$ServiceSoftwareOptions": "

The current status of the Elasticsearch domain's service software.

", + "StartElasticsearchServiceSoftwareUpdateResponse$ServiceSoftwareOptions": "

The current status of the Elasticsearch service software update.

" + } + }, "ServiceUrl": { "base": "

The endpoint to which service requests are submitted. For example, search-imdb-movies-oopcnjfn6ugofer3zx5iadxxca.eu-west-1.es.amazonaws.com or doc-imdb-movies-oopcnjfn6ugofer3zx5iadxxca.eu-west-1.es.amazonaws.com.

", "refs": { @@ -792,6 +828,16 @@ "ElasticsearchDomainConfig$SnapshotOptions": "

Specifies the SnapshotOptions for the Elasticsearch domain.

" } }, + "StartElasticsearchServiceSoftwareUpdateRequest": { + "base": "

Container for the parameters to the StartElasticsearchServiceSoftwareUpdate operation. Specifies the name of the Elasticsearch domain that you wish to schedule a service software update on.

", + "refs": { + } + }, + "StartElasticsearchServiceSoftwareUpdateResponse": { + "base": "

The result of a StartElasticsearchServiceSoftwareUpdate operation. Contains the status of the update.

", + "refs": { + } + }, "StartTimestamp": { "base": null, "refs": { @@ -847,6 +893,9 @@ "ReservedElasticsearchInstance$CurrencyCode": "

The currency code for the reserved Elasticsearch instance offering.

", "ReservedElasticsearchInstance$State": "

The state of the reserved Elasticsearch instance.

", "ReservedElasticsearchInstanceOffering$CurrencyCode": "

The currency code for the reserved Elasticsearch instance offering.

", + "ServiceSoftwareOptions$CurrentVersion": "

The current service software version that is present on the domain.

", + "ServiceSoftwareOptions$NewVersion": "

The new service software version if one is available.

", + "ServiceSoftwareOptions$Description": "

The description of the UpdateStatus.

", "StringList$member": null, "VPCDerivedInfo$VPCId": "

The VPC Id for the Elasticsearch domain. Exists only if the domain was created with VPCOptions.

" } diff --git a/models/apis/lambda/2015-03-31/api-2.json b/models/apis/lambda/2015-03-31/api-2.json index bce64a50446..031c6dfe14e 100644 --- a/models/apis/lambda/2015-03-31/api-2.json +++ b/models/apis/lambda/2015-03-31/api-2.json @@ -611,7 +611,7 @@ }, "Arn":{ "type":"string", - "pattern":"arn:aws:([a-zA-Z0-9\\-])+:([a-z]{2}-[a-z]+-\\d{1})?:(\\d{12})?:(.*)" + "pattern":"arn:(aws[a-zA-Z0-9-]*):([a-zA-Z0-9\\-])+:([a-z]{2}(-gov)?-[a-z]+-\\d{1})?:(\\d{12})?:(.*)" }, "BatchSize":{ "type":"integer", @@ -878,7 +878,7 @@ }, "FunctionArn":{ "type":"string", - "pattern":"arn:aws:lambda:[a-z]{2}-[a-z]+-\\d{1}:\\d{12}:function:[a-zA-Z0-9-_]+(:(\\$LATEST|[a-zA-Z0-9-_]+))?" + "pattern":"arn:(aws[a-zA-Z-]*)?:lambda:[a-z]{2}(-gov)?-[a-z]+-\\d{1}:\\d{12}:function:[a-zA-Z0-9-_]+(:(\\$LATEST|[a-zA-Z0-9-_]+))?" }, "FunctionCode":{ "type":"structure", @@ -928,7 +928,7 @@ "type":"string", "max":140, "min":1, - "pattern":"(arn:aws:lambda:)?([a-z]{2}-[a-z]+-\\d{1}:)?(\\d{12}:)?(function:)?([a-zA-Z0-9-_]+)(:(\\$LATEST|[a-zA-Z0-9-_]+))?" + "pattern":"(arn:(aws[a-zA-Z-]*)?:lambda:)?([a-z]{2}(-gov)?-[a-z]+-\\d{1}:)?(\\d{12}:)?(function:)?([a-zA-Z0-9-_]+)(:(\\$LATEST|[a-zA-Z0-9-_]+))?" }, "FunctionVersion":{ "type":"string", @@ -1224,7 +1224,7 @@ }, "KMSKeyArn":{ "type":"string", - "pattern":"(arn:aws:[a-z0-9-.]+:.*)|()" + "pattern":"(arn:(aws[a-zA-Z-]*)?:[a-z0-9-.]+:.*)|()" }, "KMSNotFoundException":{ "type":"structure", @@ -1401,13 +1401,13 @@ }, "NameSpacedFunctionArn":{ "type":"string", - "pattern":"arn:aws:lambda:[a-z]{2}-[a-z]+-\\d{1}:\\d{12}:function:[a-zA-Z0-9-_\\.]+(:(\\$LATEST|[a-zA-Z0-9-_]+))?" + "pattern":"arn:(aws[a-zA-Z-]*)?:lambda:[a-z]{2}(-gov)?-[a-z]+-\\d{1}:\\d{12}:function:[a-zA-Z0-9-_\\.]+(:(\\$LATEST|[a-zA-Z0-9-_]+))?" }, "NamespacedFunctionName":{ "type":"string", "max":170, "min":1, - "pattern":"(arn:aws:lambda:)?([a-z]{2}-[a-z]+-\\d{1}:)?(\\d{12}:)?(function:)?([a-zA-Z0-9-_\\.]+)(:(\\$LATEST|[a-zA-Z0-9-_]+))?" + "pattern":"(arn:(aws[a-zA-Z-]*)?:lambda:)?([a-z]{2}(-gov)?-[a-z]+-\\d{1}:)?(\\d{12}:)?(function:)?([a-zA-Z0-9-_\\.]+)(:(\\$LATEST|[a-zA-Z0-9-_]+))?" }, "NamespacedStatementId":{ "type":"string", @@ -1516,7 +1516,7 @@ }, "ResourceArn":{ "type":"string", - "pattern":"(arn:aws:[a-z0-9-.]+:.*)|()" + "pattern":"(arn:(aws[a-zA-Z-]*)?:[a-z0-9-.]+:.*)|()" }, "ResourceConflictException":{ "type":"structure", @@ -1547,7 +1547,7 @@ }, "RoleArn":{ "type":"string", - "pattern":"arn:aws:iam::\\d{12}:role/?[a-zA-Z_0-9+=,.@\\-_/]+" + "pattern":"arn:(aws[a-zA-Z-]*)?:iam::\\d{12}:role/?[a-zA-Z_0-9+=,.@\\-_/]+" }, "Runtime":{ "type":"string", diff --git a/models/apis/lambda/2015-03-31/docs-2.json b/models/apis/lambda/2015-03-31/docs-2.json index 1484d3915a4..5cf00b806be 100644 --- a/models/apis/lambda/2015-03-31/docs-2.json +++ b/models/apis/lambda/2015-03-31/docs-2.json @@ -2,48 +2,48 @@ "version": "2.0", "service": "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, and for information about how the service works, see AWS Lambda: How it Works in the AWS Lambda Developer Guide.

", "operations": { - "AddPermission": "

Adds a permission to the resource policy associated with the specified AWS Lambda function. You use resource policies to grant permissions to event sources that use push model. In a push model, event sources (such as Amazon S3 and custom applications) invoke your Lambda function. Each permission you add to the resource policy allows an event source, permission to invoke the Lambda function.

For information about the push model, see Lambda Functions.

If you are using versioning, the permissions you add are specific to the Lambda function version or alias you specify in the AddPermission request via the Qualifier parameter. For more information about versioning, see AWS Lambda Function Versioning and Aliases.

This operation requires permission for the lambda:AddPermission action.

", + "AddPermission": "

Adds a permission to the resource policy associated with the specified AWS Lambda function. You use resource policies to grant permissions to event sources that use the push model. In a push model, event sources (such as Amazon S3 and custom applications) invoke your Lambda function. Each permission you add to the resource policy allows an event source permission to invoke the Lambda function.

Permissions apply to the Amazon Resource Name (ARN) used to invoke the function, which can be unqualified (the unpublished version of the function), or include a version or alias. If a client uses a version or alias to invoke a function, use the Qualifier parameter to apply permissions to that ARN. For more information about versioning, see AWS Lambda Function Versioning and Aliases.

This operation requires permission for the lambda:AddPermission action.

", "CreateAlias": "

Creates an alias that points to the specified Lambda function version. For more information, see Introduction to AWS Lambda Aliases.

Alias names are unique for a given function. This requires permission for the lambda:CreateAlias action.

", - "CreateEventSourceMapping": "

Identifies a poll-based event source for a Lambda function. It can be either an Amazon Kinesis or DynamoDB stream, or an Amazon SQS queue. AWS Lambda invokes the specified function when records are posted to the event source.

This association between a poll-based source and a Lambda function is called the event source mapping.

You provide mapping information (for example, which stream or SQS queue to read from and which Lambda function to invoke) in the request body.

Amazon Kinesis or DynamoDB stream event sources can be associated with multiple AWS Lambda functions and a given Lambda function can be associated with multiple AWS event sources. For Amazon SQS, you can configure multiple queues as event sources for a single Lambda function, but an SQS queue can be mapped only to a single Lambda function.

If you are using versioning, you can specify a specific function version or an alias via the function name parameter. For more information about versioning, see AWS Lambda Function Versioning and Aliases.

This operation requires permission for the lambda:CreateEventSourceMapping action.

", - "CreateFunction": "

Creates a new Lambda function. The function metadata is created from the request parameters, and the code for the function is provided by a .zip file in the request body. If the function name already exists, the operation will fail. Note that the function name is case-sensitive.

If you are using versioning, you can also publish a version of the Lambda function you are creating using the Publish parameter. For more information about versioning, see AWS Lambda Function Versioning and Aliases.

This operation requires permission for the lambda:CreateFunction action.

", + "CreateEventSourceMapping": "

Identifies a poll-based event source for a Lambda function. It can be either an Amazon Kinesis or DynamoDB stream. AWS Lambda invokes the specified function when records are posted to the event source.

This association between a poll-based source and a Lambda function is called the event source mapping.

You provide mapping information (for example, which stream or SQS queue to read from and which Lambda function to invoke) in the request body.

Amazon Kinesis or DynamoDB stream event sources can be associated with multiple AWS Lambda functions and a given Lambda function can be associated with multiple AWS event sources. For Amazon SQS, you can configure multiple queues as event sources for a single Lambda function, but an SQS queue can be mapped only to a single Lambda function.

You can configure an SQS queue in an account separate from your Lambda function's account. Also the queue needs to reside in the same AWS region as your function.

If you are using versioning, you can specify a specific function version or an alias via the function name parameter. For more information about versioning, see AWS Lambda Function Versioning and Aliases.

This operation requires permission for the lambda:CreateEventSourceMapping action.

", + "CreateFunction": "

Creates a new Lambda function. The function configuration is created from the request parameters, and the code for the function is provided by a .zip file. The function name is case-sensitive.

This operation requires permission for the lambda:CreateFunction action.

", "DeleteAlias": "

Deletes the specified Lambda function alias. For more information, see Introduction to AWS Lambda Aliases.

This requires permission for the lambda:DeleteAlias action.

", "DeleteEventSourceMapping": "

Removes an event source mapping. This means AWS Lambda will no longer invoke the function for events in the associated source.

This operation requires permission for the lambda:DeleteEventSourceMapping action.

", - "DeleteFunction": "

Deletes the specified Lambda function code and configuration.

If you are using the versioning feature and you don't specify a function version in your DeleteFunction request, AWS Lambda will delete the function, including all its versions, and any aliases pointing to the function versions. To delete a specific function version, you must provide the function version via the Qualifier parameter. For information about function versioning, see AWS Lambda Function Versioning and Aliases.

When you delete a function the associated resource policy is also deleted. You will need to delete the event source mappings explicitly.

This operation requires permission for the lambda:DeleteFunction action.

", - "DeleteFunctionConcurrency": "

Removes concurrent execution limits from this function. For more information, see concurrent-executions.

", - "GetAccountSettings": "

Returns a customer's account settings.

You can use this operation to retrieve Lambda limits information, such as code size and concurrency limits. For more information about limits, see AWS Lambda Limits. You can also retrieve resource usage statistics, such as code storage usage and function count.

", + "DeleteFunction": "

Deletes a Lambda function. To delete a specific function version, use the Qualifier parameter. Otherwise, all versions and aliases are deleted. Event source mappings are not deleted.

This operation requires permission for the lambda:DeleteFunction action.

", + "DeleteFunctionConcurrency": "

Removes concurrent execution limits from this function. For more information, see Managing Concurrency.

", + "GetAccountSettings": "

Retrieves details about your account's limits and usage in a region.

", "GetAlias": "

Returns the specified alias information such as the alias ARN, description, and function version it is pointing to. For more information, see Introduction to AWS Lambda Aliases.

This requires permission for the lambda:GetAlias action.

", "GetEventSourceMapping": "

Returns configuration information for the specified event source mapping (see CreateEventSourceMapping).

This operation requires permission for the lambda:GetEventSourceMapping action.

", - "GetFunction": "

Returns the configuration information of the Lambda function and a presigned URL link to the .zip file you uploaded with CreateFunction so you can download the .zip file. Note that the URL is valid for up to 10 minutes. The configuration information is the same information you provided as parameters when uploading the function.

Using the optional Qualifier parameter, you can specify a specific function version for which you want this information. If you don't specify this parameter, the API uses unqualified function ARN which return information about the $LATEST version of the Lambda function. For more information, see AWS Lambda Function Versioning and Aliases.

This operation requires permission for the lambda:GetFunction action.

", + "GetFunction": "

Returns the configuration information of the Lambda function and a presigned URL link to the .zip file you uploaded with CreateFunction so you can download the .zip file. Note that the URL is valid for up to 10 minutes. The configuration information is the same information you provided as parameters when uploading the function.

Use the Qualifier parameter to retrieve a published version of the function. Otherwise, returns the unpublished version ($LATEST). For more information, see AWS Lambda Function Versioning and Aliases.

This operation requires permission for the lambda:GetFunction action.

", "GetFunctionConfiguration": "

Returns the configuration information of the Lambda function. This the same information you provided as parameters when uploading the function by using CreateFunction.

If you are using the versioning feature, you can retrieve this information for a specific function version by using the optional Qualifier parameter and specifying the function version or alias that points to it. If you don't provide it, the API returns information about the $LATEST version of the function. For more information about versioning, see AWS Lambda Function Versioning and Aliases.

This operation requires permission for the lambda:GetFunctionConfiguration operation.

", - "GetPolicy": "

Returns the resource policy associated with the specified Lambda function.

If you are using the versioning feature, you can get the resource policy associated with the specific Lambda function version or alias by specifying the version or alias name using the Qualifier parameter. For more information about versioning, see AWS Lambda Function Versioning and Aliases.

You need permission for the lambda:GetPolicy action.

", - "Invoke": "

Invokes a specific Lambda function. For an example, see Create the Lambda Function and Test It Manually.

If you are using the versioning feature, you can invoke the specific function version by providing function version or alias name that is pointing to the function version using the Qualifier parameter in the request. If you don't provide the Qualifier parameter, the $LATEST version of the Lambda function is invoked. Invocations occur at least once in response to an event and functions must be idempotent to handle this. For information about the versioning feature, see AWS Lambda Function Versioning and Aliases.

This operation requires permission for the lambda:InvokeFunction action.

The TooManyRequestsException noted below will return the following: ConcurrentInvocationLimitExceeded will be returned if you have no functions with reserved concurrency and have exceeded your account concurrent limit or if a function without reserved concurrency exceeds the account's unreserved concurrency limit. ReservedFunctionConcurrentInvocationLimitExceeded will be returned when a function with reserved concurrency exceeds its configured concurrency limit.

", - "InvokeAsync": "

This API is deprecated. We recommend you use Invoke API (see Invoke).

Submits an invocation request to AWS Lambda. Upon receiving the request, Lambda executes the specified function asynchronously. To see the logs generated by the Lambda function execution, see the CloudWatch Logs console.

This operation requires permission for the lambda:InvokeFunction action.

", + "GetPolicy": "

Returns the resource policy associated with the specified Lambda function.

This action requires permission for the lambda:GetPolicy action.

", + "Invoke": "

Invokes a Lambda function. For an example, see Create the Lambda Function and Test It Manually.

Specify just a function name to invoke the latest version of the function. To invoke a published version, use the Qualifier parameter to specify a version or alias.

If you use the RequestResponse (synchronous) invocation option, the function will be invoked only once. If you use the Event (asynchronous) invocation option, the function will be invoked at least once in response to an event and the function must be idempotent to handle this.

For functions with a long timeout, your client may be disconnected during synchronous invocation while it waits for a response. Configure your HTTP client, SDK, firewall, proxy, or operating system to allow for long connections with timeout or keep-alive settings.

This operation requires permission for the lambda:InvokeFunction action.

The TooManyRequestsException noted below will return the following: ConcurrentInvocationLimitExceeded will be returned if you have no functions with reserved concurrency and have exceeded your account concurrent limit or if a function without reserved concurrency exceeds the account's unreserved concurrency limit. ReservedFunctionConcurrentInvocationLimitExceeded will be returned when a function with reserved concurrency exceeds its configured concurrency limit.

", + "InvokeAsync": "

For asynchronous function invocation, use Invoke.

Submits an invocation request to AWS Lambda. Upon receiving the request, Lambda executes the specified function asynchronously. To see the logs generated by the Lambda function execution, see the CloudWatch Logs console.

This operation requires permission for the lambda:InvokeFunction action.

", "ListAliases": "

Returns list of aliases created for a Lambda function. For each alias, the response includes information such as the alias ARN, description, alias name, and the function version to which it points. For more information, see Introduction to AWS Lambda Aliases.

This requires permission for the lambda:ListAliases action.

", - "ListEventSourceMappings": "

Returns a list of event source mappings you created using the CreateEventSourceMapping (see CreateEventSourceMapping).

For each mapping, the API returns configuration information. You can optionally specify filters to retrieve specific event source mappings.

If you are using the versioning feature, you can get list of event source mappings for a specific Lambda function version or an alias as described in the FunctionName parameter. For information about the versioning feature, see AWS Lambda Function Versioning and Aliases.

This operation requires permission for the lambda:ListEventSourceMappings action.

", + "ListEventSourceMappings": "

Returns a list of event source mappings you created using the CreateEventSourceMapping (see CreateEventSourceMapping).

For each mapping, the API returns configuration information. You can optionally specify filters to retrieve specific event source mappings.

This operation requires permission for the lambda:ListEventSourceMappings action.

", "ListFunctions": "

Returns a list of your Lambda functions. For each function, the response includes the function configuration information. You must use GetFunction to retrieve the code for your function.

This operation requires permission for the lambda:ListFunctions action.

If you are using the versioning feature, you can list all of your functions or only $LATEST versions. For information about the versioning feature, see AWS Lambda Function Versioning and Aliases.

", "ListTags": "

Returns a list of tags assigned to a function when supplied the function ARN (Amazon Resource Name). For more information on Tagging, see Tagging Lambda Functions in the AWS Lambda Developer Guide.

", - "ListVersionsByFunction": "

List all versions of a function. For information about the versioning feature, see AWS Lambda Function Versioning and Aliases.

", + "ListVersionsByFunction": "

Lists all versions of a function. For information about versioning, see AWS Lambda Function Versioning and Aliases.

", "PublishVersion": "

Publishes a version of your function from the current snapshot of $LATEST. That is, AWS Lambda takes a snapshot of the function code and configuration information from $LATEST and publishes a new version. The code and configuration cannot be modified after publication. For information about the versioning feature, see AWS Lambda Function Versioning and Aliases.

", - "PutFunctionConcurrency": "

Sets a limit on the number of concurrent executions available to this function. It is a subset of your account's total concurrent execution limit per region. Note that Lambda automatically reserves a buffer of 100 concurrent executions for functions without any reserved concurrency limit. This means if your account limit is 1000, you have a total of 900 available to allocate to individual functions. For more information, see concurrent-executions.

", - "RemovePermission": "

You can remove individual permissions from an resource policy associated with a Lambda function by providing a statement ID that you provided when you added the permission.

If you are using versioning, the permissions you remove are specific to the Lambda function version or alias you specify in the AddPermission request via the Qualifier parameter. For more information about versioning, see AWS Lambda Function Versioning and Aliases.

Note that removal of a permission will cause an active event source to lose permission to the function.

You need permission for the lambda:RemovePermission action.

", + "PutFunctionConcurrency": "

Sets a limit on the number of concurrent executions available to this function. It is a subset of your account's total concurrent execution limit per region. Note that Lambda automatically reserves a buffer of 100 concurrent executions for functions without any reserved concurrency limit. This means if your account limit is 1000, you have a total of 900 available to allocate to individual functions. For more information, see Managing Concurrency.

", + "RemovePermission": "

Removes permissions from a function. You can remove individual permissions from an resource policy associated with a Lambda function by providing a statement ID that you provided when you added the permission. When you remove permissions, disable the event source mapping or trigger configuration first to avoid errors.

Permissions apply to the Amazon Resource Name (ARN) used to invoke the function, which can be unqualified (the unpublished version of the function), or include a version or alias. If a client uses a version or alias to invoke a function, use the Qualifier parameter to apply permissions to that ARN. For more information about versioning, see AWS Lambda Function Versioning and Aliases.

You need permission for the lambda:RemovePermission action.

", "TagResource": "

Creates a list of tags (key-value pairs) on the Lambda function. Requires the Lambda function ARN (Amazon Resource Name). If a key is specified without a value, Lambda creates a tag with the specified key and a value of null. For more information, see Tagging Lambda Functions in the AWS Lambda Developer Guide.

", "UntagResource": "

Removes tags from a Lambda function. Requires the function ARN (Amazon Resource Name). For more information, see Tagging Lambda Functions in the AWS Lambda Developer Guide.

", "UpdateAlias": "

Using this API you can update the function version to which the alias points and the alias description. For more information, see Introduction to AWS Lambda Aliases.

This requires permission for the lambda:UpdateAlias action.

", - "UpdateEventSourceMapping": "

You can update an event source mapping. This is useful if you want to change the parameters of the existing mapping without losing your position in the stream. You can change which function will receive the stream records, but to change the stream itself, you must create a new mapping.

If you are using the versioning feature, you can update the event source mapping to map to a specific Lambda function version or alias as described in the FunctionName parameter. For information about the versioning feature, see AWS Lambda Function Versioning and Aliases.

If you disable the event source mapping, AWS Lambda stops polling. If you enable again, it will resume polling from the time it had stopped polling, so you don't lose processing of any records. However, if you delete event source mapping and create it again, it will reset.

This operation requires permission for the lambda:UpdateEventSourceMapping action.

", + "UpdateEventSourceMapping": "

You can update an event source mapping. This is useful if you want to change the parameters of the existing mapping without losing your position in the stream. You can change which function will receive the stream records, but to change the stream itself, you must create a new mapping.

If you disable the event source mapping, AWS Lambda stops polling. If you enable again, it will resume polling from the time it had stopped polling, so you don't lose processing of any records. However, if you delete event source mapping and create it again, it will reset.

This operation requires permission for the lambda:UpdateEventSourceMapping action.

", "UpdateFunctionCode": "

Updates the code for the specified Lambda function. This operation must only be used on an existing Lambda function and cannot be used to update the function configuration.

If you are using the versioning feature, note this API will always update the $LATEST version of your Lambda function. For information about the versioning feature, see AWS Lambda Function Versioning and Aliases.

This operation requires permission for the lambda:UpdateFunctionCode action.

", "UpdateFunctionConfiguration": "

Updates the configuration parameters for the specified Lambda function by using the values provided in the request. You provide only the parameters you want to change. This operation must only be used on an existing Lambda function and cannot be used to update the function's code.

If you are using the versioning feature, note this API will always update the $LATEST version of your Lambda function. For information about the versioning feature, see AWS Lambda Function Versioning and Aliases.

This operation requires permission for the lambda:UpdateFunctionConfiguration action.

" }, "shapes": { "AccountLimit": { - "base": "

Provides limits of code size and concurrency associated with the current account and region.

", + "base": "

Provides limits of code size and concurrency associated with the current account and region. For more information or to request a limit increase for concurrent executions, see Lambda Limits.

", "refs": { - "GetAccountSettingsResponse$AccountLimit": null + "GetAccountSettingsResponse$AccountLimit": "

Limits related to concurrency and code storage.

" } }, "AccountUsage": { "base": "

Provides code size usage and function count associated with the current account and region.

", "refs": { - "GetAccountSettingsResponse$AccountUsage": null + "GetAccountSettingsResponse$AccountUsage": "

The number of functions and amount of storage in use.

" } }, "Action": { @@ -53,12 +53,12 @@ } }, "AddPermissionRequest": { - "base": "

", + "base": null, "refs": { } }, "AddPermissionResponse": { - "base": "

", + "base": null, "refs": { } }, @@ -71,7 +71,7 @@ "AdditionalVersionWeights": { "base": null, "refs": { - "AliasRoutingConfiguration$AdditionalVersionWeights": "

Set this value to dictate what percentage of traffic will invoke the updated function version. If set to an empty string, 100 percent of traffic will invoke function-version. For more information, see lambda-traffic-shifting-using-aliases.

" + "AliasRoutingConfiguration$AdditionalVersionWeights": "

The name of the second alias, and the percentage of traffic that is routed to it.

" } }, "Alias": { @@ -97,34 +97,34 @@ } }, "AliasRoutingConfiguration": { - "base": "

The parent object that implements what percentage of traffic will invoke each function version. For more information, see lambda-traffic-shifting-using-aliases.

", + "base": "

The alias's traffic shifting configuration.

", "refs": { - "AliasConfiguration$RoutingConfig": "

Specifies an additional function versions the alias points to, allowing you to dictate what percentage of traffic will invoke each version. For more information, see lambda-traffic-shifting-using-aliases.

", - "CreateAliasRequest$RoutingConfig": "

Specifies an additional version your alias can point to, allowing you to dictate what percentage of traffic will invoke each version. For more information, see lambda-traffic-shifting-using-aliases.

", - "UpdateAliasRequest$RoutingConfig": "

Specifies an additional version your alias can point to, allowing you to dictate what percentage of traffic will invoke each version. For more information, see lambda-traffic-shifting-using-aliases.

" + "AliasConfiguration$RoutingConfig": "

Specifies an additional function versions the alias points to, allowing you to dictate what percentage of traffic will invoke each version.

", + "CreateAliasRequest$RoutingConfig": "

Specifies an additional version your alias can point to, allowing you to dictate what percentage of traffic will invoke each version. For more information, see Traffic Shifting Using Aliases.

", + "UpdateAliasRequest$RoutingConfig": "

Specifies an additional version your alias can point to, allowing you to dictate what percentage of traffic will invoke each version. For more information, see Traffic Shifting Using Aliases.

" } }, "Arn": { "base": null, "refs": { - "AddPermissionRequest$SourceArn": "

This is optional; however, when granting permission to invoke your function, you should specify this field with the Amazon Resource Name (ARN) as its value. This ensures that only events generated from the specified source can invoke the function.

If you add a permission without providing the source ARN, any AWS account that creates a mapping to your function ARN can send events to invoke your Lambda function.

", - "CreateEventSourceMappingRequest$EventSourceArn": "

The Amazon Resource Name (ARN) of the event source. Any record added to this source could cause AWS Lambda to invoke your Lambda function, it depends on the BatchSize. AWS Lambda POSTs the event's records to your Lambda function as JSON.

", - "EventSourceMappingConfiguration$EventSourceArn": "

The Amazon Resource Name (ARN) of the Amazon Kinesis or DynamoDB stream or the SQS queue that is the source of events.

", - "ListEventSourceMappingsRequest$EventSourceArn": "

The Amazon Resource Name (ARN) of the Amazon Kinesis or DynamoDB stream, or an SQS queue. (This parameter is optional.)

" + "AddPermissionRequest$SourceArn": "

The Amazon Resource Name of the invoker.

If you add a permission to a service principal without providing the source ARN, any AWS account that creates a mapping to your function ARN can invoke your Lambda function.

", + "CreateEventSourceMappingRequest$EventSourceArn": "

The Amazon Resource Name (ARN) of the event source.

", + "EventSourceMappingConfiguration$EventSourceArn": "

The Amazon Resource Name (ARN) of the Amazon Kinesis or DynamoDB stream that is the source of events.

", + "ListEventSourceMappingsRequest$EventSourceArn": "

The Amazon Resource Name (ARN) of the Amazon Kinesis or DynamoDB stream. (This parameter is optional.)

" } }, "BatchSize": { "base": null, "refs": { - "CreateEventSourceMappingRequest$BatchSize": "

The largest number of records that AWS Lambda will retrieve from your event source at the time of invoking your function. Your function receives an event with all the retrieved records. The default for Amazon Kinesis and Amazon DynamoDB is 100 records. For SQS, the default is 1.

", + "CreateEventSourceMappingRequest$BatchSize": "

The largest number of records that AWS Lambda will retrieve from your event source at the time of invoking your function. Your function receives an event with all the retrieved records. The default for Amazon Kinesis and Amazon DynamoDB is 100 records. Both the default and maximum for Amazon SQS are 10 messages.

", "EventSourceMappingConfiguration$BatchSize": "

The largest number of records that AWS Lambda will retrieve from your event source at the time of invoking your function. Your function receives an event with all the retrieved records.

", - "UpdateEventSourceMappingRequest$BatchSize": "

The maximum number of stream records that can be sent to your Lambda function for a single invocation.

" + "UpdateEventSourceMappingRequest$BatchSize": "

The largest number of records that AWS Lambda will retrieve from your event source at the time of invoking your function. Your function receives an event with all the retrieved records.

" } }, "Blob": { "base": null, "refs": { - "FunctionCode$ZipFile": "

The contents of your zip file containing your deployment package. If you are using the web API directly, the contents of the zip file must be base64-encoded. If you are using the AWS SDKs or the AWS CLI, the SDKs or CLI will do the encoding for you. For more information about creating a .zip file, see Execution Permissions in the AWS Lambda Developer Guide.

", + "FunctionCode$ZipFile": "

The base64-encoded contents of your zip file containing your deployment package. AWS SDK and AWS CLI clients handle the encoding for you.

", "InvocationRequest$Payload": "

JSON that you want to provide to your Lambda function as input.

", "InvocationResponse$Payload": "

It is the JSON representation of the object returned by the Lambda function. This is present only if the invocation type is RequestResponse.

In the event of a function error this field contains a message describing the error. For the Handled errors the Lambda function will report this message. For Unhandled errors AWS Lambda reports the message.

", "UpdateFunctionCodeRequest$ZipFile": "

The contents of your zip file containing your deployment package. If you are using the web API directly, the contents of the zip file must be base64-encoded. If you are using the AWS SDKs or the AWS CLI, the SDKs or CLI will do the encoding for you. For more information about creating a .zip file, see Execution Permissions.

" @@ -139,7 +139,7 @@ "Boolean": { "base": null, "refs": { - "CreateFunctionRequest$Publish": "

This boolean parameter can be used to request AWS Lambda to create the Lambda function and publish a version as an atomic operation.

", + "CreateFunctionRequest$Publish": "

Set to true to publish the first version of the function during creation.

", "UpdateFunctionCodeRequest$Publish": "

This boolean parameter can be used to request AWS Lambda to update the Lambda function and publish a version as an atomic operation.

", "UpdateFunctionCodeRequest$DryRun": "

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 of the provided code will also be computed and returned in the response.

" } @@ -152,7 +152,7 @@ "Concurrency": { "base": null, "refs": { - "GetFunctionResponse$Concurrency": "

The concurrent execution limit set for this function. For more information, see concurrent-executions.

" + "GetFunctionResponse$Concurrency": "

The concurrent execution limit set for this function. For more information, see Managing Concurrency.

" } }, "CreateAliasRequest": { @@ -161,12 +161,12 @@ } }, "CreateEventSourceMappingRequest": { - "base": "

", + "base": null, "refs": { } }, "CreateFunctionRequest": { - "base": "

", + "base": null, "refs": { } }, @@ -178,11 +178,11 @@ } }, "DeadLetterConfig": { - "base": "

The Amazon Resource Name (ARN) of an Amazon SQS queue or Amazon SNS topic you specify as your Dead Letter Queue (DLQ). For more information, see dlq.

", + "base": "

The dead letter queue for failed asynchronous invocations.

", "refs": { - "CreateFunctionRequest$DeadLetterConfig": "

The parent object that contains the target ARN (Amazon Resource Name) of an Amazon SQS queue or Amazon SNS topic. For more information, see dlq.

", - "FunctionConfiguration$DeadLetterConfig": "

The parent object that contains the target ARN (Amazon Resource Name) of an Amazon SQS queue or Amazon SNS topic. For more information, see dlq.

", - "UpdateFunctionConfigurationRequest$DeadLetterConfig": "

The parent object that contains the target ARN (Amazon Resource Name) of an Amazon SQS queue or Amazon SNS topic. For more information, see dlq.

" + "CreateFunctionRequest$DeadLetterConfig": "

A dead letter queue configuration that specifies the queue or topic where Lambda sends asynchronous events when they fail processing. For more information, see Dead Letter Queues.

", + "FunctionConfiguration$DeadLetterConfig": "

The function's dead letter queue.

", + "UpdateFunctionConfigurationRequest$DeadLetterConfig": "

A dead letter queue configuration that specifies the queue or topic where Lambda sends asynchronous events when they fail processing. For more information, see Dead Letter Queues.

" } }, "DeleteAliasRequest": { @@ -191,7 +191,7 @@ } }, "DeleteEventSourceMappingRequest": { - "base": "

", + "base": null, "refs": { } }, @@ -210,15 +210,15 @@ "refs": { "AliasConfiguration$Description": "

Alias description.

", "CreateAliasRequest$Description": "

Description of the alias.

", - "CreateFunctionRequest$Description": "

A short, user-defined function description. Lambda does not use this value. Assign a meaningful description as you see fit.

", - "FunctionConfiguration$Description": "

The user-provided description.

", + "CreateFunctionRequest$Description": "

A description of the function.

", + "FunctionConfiguration$Description": "

The function's description.

", "PublishVersionRequest$Description": "

The description for the version you are publishing. If not provided, AWS Lambda copies the description from the $LATEST version.

", "UpdateAliasRequest$Description": "

You can change the description of the alias using this parameter.

", "UpdateFunctionConfigurationRequest$Description": "

A short user-defined function description. AWS Lambda does not use this value. Assign a meaningful description as you see fit.

" } }, "EC2AccessDeniedException": { - "base": "

", + "base": "

Need additional permissions to configure VPC settings.

", "refs": { } }, @@ -240,27 +240,27 @@ "Enabled": { "base": null, "refs": { - "CreateEventSourceMappingRequest$Enabled": "

Indicates whether AWS Lambda should begin polling the event source. By default, Enabled is true.

", + "CreateEventSourceMappingRequest$Enabled": "

Set to false to disable the event source upon creation.

", "UpdateEventSourceMappingRequest$Enabled": "

Specifies whether AWS Lambda should actively poll the stream or not. If disabled, AWS Lambda will not poll the stream.

" } }, "Environment": { - "base": "

The parent object that contains your environment's configuration settings.

", + "base": "

A function's environment variable settings.

", "refs": { - "CreateFunctionRequest$Environment": null, + "CreateFunctionRequest$Environment": "

Environment variables that are accessible from function code during execution.

", "UpdateFunctionConfigurationRequest$Environment": "

The parent object that contains your environment's configuration settings.

" } }, "EnvironmentError": { - "base": "

The parent object that contains error information associated with your configuration settings.

", + "base": "

Error messages for environment variables that could not be applied.

", "refs": { - "EnvironmentResponse$Error": null + "EnvironmentResponse$Error": "

Error messages for environment variables that could not be applied.

" } }, "EnvironmentResponse": { - "base": "

The parent object returned that contains your environment's configuration settings or any error information associated with your configuration settings.

", + "base": "

The results of a configuration update that applied environment variables.

", "refs": { - "FunctionConfiguration$Environment": "

The parent object that contains your environment's configuration settings.

" + "FunctionConfiguration$Environment": "

The function's environment variables.

" } }, "EnvironmentVariableName": { @@ -278,12 +278,12 @@ "EnvironmentVariables": { "base": null, "refs": { - "Environment$Variables": "

The key-value pairs that represent your environment's configuration settings.

", - "EnvironmentResponse$Variables": "

The key-value pairs returned that represent your environment's configuration settings or error information.

" + "Environment$Variables": "

Environment variable key-value pairs.

", + "EnvironmentResponse$Variables": "

Environment variable key-value pairs.

" } }, "EventSourceMappingConfiguration": { - "base": "

Describes mapping between an Amazon Kinesis or DynamoDB stream or an Amazon SQS queue and a Lambda function.

", + "base": "

Describes mapping between an Amazon Kinesis or DynamoDB stream and a Lambda function.

", "refs": { "EventSourceMappingsList$member": null } @@ -311,29 +311,29 @@ "refs": { "AliasConfiguration$AliasArn": "

Lambda function ARN that is qualified using the alias name as the suffix. For example, if you create an alias called BETA that points to a helloworld function version, the ARN is arn:aws:lambda:aws-regions:acct-id:function:helloworld:BETA.

", "EventSourceMappingConfiguration$FunctionArn": "

The Lambda function to invoke when AWS Lambda detects an event on the poll-based source.

", - "FunctionConfiguration$MasterArn": "

Returns the ARN (Amazon Resource Name) of the master function.

", + "FunctionConfiguration$MasterArn": "

The ARN of the master function.

", "ListTagsRequest$Resource": "

The ARN (Amazon Resource Name) of the function. For more information, see Tagging Lambda Functions in the AWS Lambda Developer Guide.

", "TagResourceRequest$Resource": "

The ARN (Amazon Resource Name) of the Lambda function. For more information, see Tagging Lambda Functions in the AWS Lambda Developer Guide.

", "UntagResourceRequest$Resource": "

The ARN (Amazon Resource Name) of the function. For more information, see Tagging Lambda Functions in the AWS Lambda Developer Guide.

" } }, "FunctionCode": { - "base": "

The code for the Lambda function.

", + "base": "

The code for the Lambda function. You can specify either an S3 location, or upload a deployment package directly.

", "refs": { - "CreateFunctionRequest$Code": "

The code for the Lambda function.

" + "CreateFunctionRequest$Code": "

The code for the function.

" } }, "FunctionCodeLocation": { "base": "

The object for the Lambda function location.

", "refs": { - "GetFunctionResponse$Code": null + "GetFunctionResponse$Code": "

The function's code.

" } }, "FunctionConfiguration": { - "base": "

A complex type that describes function metadata.

", + "base": "

A Lambda function's configuration settings.

", "refs": { "FunctionList$member": null, - "GetFunctionResponse$Configuration": null + "GetFunctionResponse$Configuration": "

The function's configuration.

" } }, "FunctionList": { @@ -346,29 +346,29 @@ "FunctionName": { "base": null, "refs": { - "AddPermissionRequest$FunctionName": "

Name of the Lambda function whose resource policy you are updating by adding a new permission.

You can specify a function name (for example, Thumbnail) or you can specify Amazon Resource Name (ARN) of the function (for example, arn:aws:lambda:us-west-2:account-id:function:ThumbNail). AWS Lambda also allows you to specify partial ARN (for example, account-id:Thumbnail). Note that the length constraint applies only to the ARN. If you specify only the function name, it is limited to 64 characters in length.

", - "CreateAliasRequest$FunctionName": "

Name of the Lambda function for which you want to create an alias. Note that the length constraint applies only to the ARN. If you specify only the function name, it is limited to 64 characters in length.

", - "CreateEventSourceMappingRequest$FunctionName": "

The Lambda function to invoke when AWS Lambda detects an event on the stream.

You can specify the function name (for example, Thumbnail) or you can specify Amazon Resource Name (ARN) of the function (for example, arn:aws:lambda:us-west-2:account-id:function:ThumbNail).

If you are using versioning, you can also provide a qualified function ARN (ARN that is qualified with function version or alias name as suffix). For more information about versioning, see AWS Lambda Function Versioning and Aliases

AWS Lambda also allows you to specify only the function name with the account ID qualifier (for example, account-id:Thumbnail).

Note that the length constraint applies only to the ARN. If you specify only the function name, it is limited to 64 characters in length.

", - "CreateFunctionRequest$FunctionName": "

The name you want to assign to the function you are uploading. The function names appear in the console and are returned in the ListFunctions API. Function names are used to specify functions to other AWS Lambda API operations, such as Invoke. Note that the length constraint applies only to the ARN. If you specify only the function name, it is limited to 64 characters in length.

", - "DeleteAliasRequest$FunctionName": "

The Lambda function name for which the alias is created. Deleting an alias does not delete the function version to which it is pointing. Note that the length constraint applies only to the ARN. If you specify only the function name, it is limited to 64 characters in length.

", - "DeleteFunctionConcurrencyRequest$FunctionName": "

The name of the function you are removing concurrent execution limits from. For more information, see concurrent-executions.

", - "DeleteFunctionRequest$FunctionName": "

The Lambda function to delete.

You can specify the function name (for example, Thumbnail) or you can specify Amazon Resource Name (ARN) of the function (for example, arn:aws:lambda:us-west-2:account-id:function:ThumbNail). If you are using versioning, you can also provide a qualified function ARN (ARN that is qualified with function version or alias name as suffix). AWS Lambda also allows you to specify only the function name with the account ID qualifier (for example, account-id:Thumbnail). Note that the length constraint applies only to the ARN. If you specify only the function name, it is limited to 64 characters in length.

", - "GetAliasRequest$FunctionName": "

Function name for which the alias is created. An alias is a subresource that exists only in the context of an existing Lambda function so you must specify the function name. Note that the length constraint applies only to the ARN. If you specify only the function name, it is limited to 64 characters in length.

", - "ListAliasesRequest$FunctionName": "

Lambda function name for which the alias is created. Note that the length constraint applies only to the ARN. If you specify only the function name, it is limited to 64 characters in length.

", - "ListEventSourceMappingsRequest$FunctionName": "

The name of the Lambda function.

You can specify the function name (for example, Thumbnail) or you can specify Amazon Resource Name (ARN) of the function (for example, arn:aws:lambda:us-west-2:account-id:function:ThumbNail). If you are using versioning, you can also provide a qualified function ARN (ARN that is qualified with function version or alias name as suffix). AWS Lambda also allows you to specify only the function name with the account ID qualifier (for example, account-id:Thumbnail). Note that the length constraint applies only to the ARN. If you specify only the function name, it is limited to 64 characters in length.

", - "PublishVersionRequest$FunctionName": "

The Lambda function name. You can specify a function name (for example, Thumbnail) or you can specify Amazon Resource Name (ARN) of the function (for example, arn:aws:lambda:us-west-2:account-id:function:ThumbNail). AWS Lambda also allows you to specify a partial ARN (for example, account-id:Thumbnail). Note that the length constraint applies only to the ARN. If you specify only the function name, it is limited to 64 characters in length.

", - "PutFunctionConcurrencyRequest$FunctionName": "

The name of the function you are setting concurrent execution limits on. For more information, see concurrent-executions.

", - "RemovePermissionRequest$FunctionName": "

Lambda function whose resource policy you want to remove a permission from.

You can specify a function name (for example, Thumbnail) or you can specify Amazon Resource Name (ARN) of the function (for example, arn:aws:lambda:us-west-2:account-id:function:ThumbNail). AWS Lambda also allows you to specify a partial ARN (for example, account-id:Thumbnail). Note that the length constraint applies only to the ARN. If you specify only the function name, it is limited to 64 characters in length.

", - "UpdateAliasRequest$FunctionName": "

The function name for which the alias is created. Note that the length constraint applies only to the ARN. If you specify only the function name, it is limited to 64 characters in length.

", - "UpdateEventSourceMappingRequest$FunctionName": "

The Lambda function to which you want the stream records sent.

You can specify a function name (for example, Thumbnail) or you can specify Amazon Resource Name (ARN) of the function (for example, arn:aws:lambda:us-west-2:account-id:function:ThumbNail). AWS Lambda also allows you to specify a partial ARN (for example, account-id:Thumbnail). Note that the length constraint applies only to the ARN. If you specify only the function name, it is limited to 64 characters in length.

If you are using versioning, you can also provide a qualified function ARN (ARN that is qualified with function version or alias name as suffix). For more information about versioning, see AWS Lambda Function Versioning and Aliases

Note that the length constraint applies only to the ARN. If you specify only the function name, it is limited to 64 character in length.

", - "UpdateFunctionCodeRequest$FunctionName": "

The existing Lambda function name whose code you want to replace.

You can specify a function name (for example, Thumbnail) or you can specify Amazon Resource Name (ARN) of the function (for example, arn:aws:lambda:us-west-2:account-id:function:ThumbNail). AWS Lambda also allows you to specify a partial ARN (for example, account-id:Thumbnail). Note that the length constraint applies only to the ARN. If you specify only the function name, it is limited to 64 characters in length.

", - "UpdateFunctionConfigurationRequest$FunctionName": "

The name of the Lambda function.

You can specify a function name (for example, Thumbnail) or you can specify Amazon Resource Name (ARN) of the function (for example, arn:aws:lambda:us-west-2:account-id:function:ThumbNail). AWS Lambda also allows you to specify a partial ARN (for example, account-id:Thumbnail). Note that the length constraint applies only to the ARN. If you specify only the function name, it is limited to 64 character in length.

" + "AddPermissionRequest$FunctionName": "

The name of the lambda function.

Name formats

The length constraint applies only to the full ARN. If you specify only the function name, it is limited to 64 characters in length.

", + "CreateAliasRequest$FunctionName": "

The name of the lambda function.

Name formats

The length constraint applies only to the full ARN. If you specify only the function name, it is limited to 64 characters in length.

", + "CreateEventSourceMappingRequest$FunctionName": "

The name of the lambda function.

Name formats

The length constraint applies only to the full ARN. If you specify only the function name, it is limited to 64 characters in length.

", + "CreateFunctionRequest$FunctionName": "

The name of the lambda function.

Name formats

The length constraint applies only to the full ARN. If you specify only the function name, it is limited to 64 characters in length.

", + "DeleteAliasRequest$FunctionName": "

The name of the lambda function.

Name formats

The length constraint applies only to the full ARN. If you specify only the function name, it is limited to 64 characters in length.

", + "DeleteFunctionConcurrencyRequest$FunctionName": "

The name of the lambda function.

Name formats

The length constraint applies only to the full ARN. If you specify only the function name, it is limited to 64 characters in length.

", + "DeleteFunctionRequest$FunctionName": "

The name of the lambda function.

Name formats

The length constraint applies only to the full ARN. If you specify only the function name, it is limited to 64 characters in length.

", + "GetAliasRequest$FunctionName": "

The name of the lambda function.

Name formats

The length constraint applies only to the full ARN. If you specify only the function name, it is limited to 64 characters in length.

", + "ListAliasesRequest$FunctionName": "

The name of the lambda function.

Name formats

The length constraint applies only to the full ARN. If you specify only the function name, it is limited to 64 characters in length.

", + "ListEventSourceMappingsRequest$FunctionName": "

The name of the lambda function.

Name formats

The length constraint applies only to the full ARN. If you specify only the function name, it is limited to 64 characters in length.

", + "PublishVersionRequest$FunctionName": "

The name of the lambda function.

Name formats

The length constraint applies only to the full ARN. If you specify only the function name, it is limited to 64 characters in length.

", + "PutFunctionConcurrencyRequest$FunctionName": "

The name of the lambda function.

Name formats

The length constraint applies only to the full ARN. If you specify only the function name, it is limited to 64 characters in length.

", + "RemovePermissionRequest$FunctionName": "

The name of the lambda function.

Name formats

The length constraint applies only to the full ARN. If you specify only the function name, it is limited to 64 characters in length.

", + "UpdateAliasRequest$FunctionName": "

The name of the lambda function.

Name formats

The length constraint applies only to the full ARN. If you specify only the function name, it is limited to 64 characters in length.

", + "UpdateEventSourceMappingRequest$FunctionName": "

The name of the lambda function.

Name formats

The length constraint applies only to the full ARN. If you specify only the function name, it is limited to 64 characters in length.

", + "UpdateFunctionCodeRequest$FunctionName": "

The name of the lambda function.

Name formats

The length constraint applies only to the full ARN. If you specify only the function name, it is limited to 64 characters in length.

", + "UpdateFunctionConfigurationRequest$FunctionName": "

The name of the lambda function.

Name formats

The length constraint applies only to the full ARN. If you specify only the function name, it is limited to 64 characters in length.

" } }, "FunctionVersion": { "base": null, "refs": { - "ListFunctionsRequest$FunctionVersion": "

Optional string. If not specified, only the unqualified functions ARNs (Amazon Resource Names) will be returned.

Valid value:

ALL: Will return all versions, including $LATEST which will have fully qualified ARNs (Amazon Resource Names).

" + "ListFunctionsRequest$FunctionVersion": "

Set to ALL to list all published versions. If not specified, only the latest unpublished version ARN is returned.

" } }, "GetAccountSettingsRequest": { @@ -387,17 +387,17 @@ } }, "GetEventSourceMappingRequest": { - "base": "

", + "base": null, "refs": { } }, "GetFunctionConfigurationRequest": { - "base": "

", + "base": null, "refs": { } }, "GetFunctionRequest": { - "base": "

", + "base": null, "refs": { } }, @@ -407,19 +407,19 @@ } }, "GetPolicyRequest": { - "base": "

", + "base": null, "refs": { } }, "GetPolicyResponse": { - "base": "

", + "base": null, "refs": { } }, "Handler": { "base": null, "refs": { - "CreateFunctionRequest$Handler": "

The function within your code that Lambda calls to begin execution. For Node.js, it is the module-name.export value in your function. For Java, it can be package.class-name::handler or package.class-name. For more information, see Lambda Function Handler (Java).

", + "CreateFunctionRequest$Handler": "

The name of the method within your code that Lambda calls to execute your function. For more information, see Programming Model.

", "FunctionConfiguration$Handler": "

The function Lambda calls to begin executing your function.

", "UpdateFunctionConfigurationRequest$Handler": "

The function that Lambda calls to begin executing your function. For Node.js, it is the module-name.export value in your function.

" } @@ -433,7 +433,7 @@ "Integer": { "base": null, "refs": { - "AccountLimit$ConcurrentExecutions": "

Number of simultaneous executions of your function per region. For more information or to request a limit increase for concurrent executions, see Lambda Function Concurrent Executions. The default limit is 1000.

", + "AccountLimit$ConcurrentExecutions": "

Number of simultaneous executions of your function per region. The default limit is 1000.

", "InvocationResponse$StatusCode": "

The HTTP status code will be in the 200 range for successful request. For the RequestResponse invocation type this status code will be 200. For the Event invocation type this status code will be 202. For the DryRun invocation type the status code will be 204.

" } }, @@ -463,12 +463,12 @@ } }, "InvalidZipFileException": { - "base": "

AWS Lambda could not unzip the function zip file.

", + "base": "

AWS Lambda could not unzip the deployment package.

", "refs": { } }, "InvocationRequest": { - "base": "

", + "base": null, "refs": { } }, @@ -480,11 +480,11 @@ "InvocationType": { "base": null, "refs": { - "InvocationRequest$InvocationType": "

By default, the Invoke API assumes RequestResponse invocation type. You can optionally request asynchronous execution by specifying Event as the InvocationType. You can also use this parameter to request AWS Lambda to not execute the function but do some verification, such as if the caller is authorized to invoke the function and if the inputs are valid. You request this by specifying DryRun as the InvocationType. This is useful in a cross-account scenario when you want to verify access to a function without running it.

" + "InvocationRequest$InvocationType": "

Choose from the following options.

" } }, "InvokeAsyncRequest": { - "base": "

", + "base": null, "refs": { } }, @@ -511,8 +511,8 @@ "KMSKeyArn": { "base": null, "refs": { - "CreateFunctionRequest$KMSKeyArn": "

The Amazon Resource Name (ARN) of the KMS key used to encrypt your function's environment variables. If not provided, AWS Lambda will use a default service key.

", - "FunctionConfiguration$KMSKeyArn": "

The Amazon Resource Name (ARN) of the KMS key used to encrypt your function's environment variables. If empty, it means you are using the AWS Lambda default service key.

", + "CreateFunctionRequest$KMSKeyArn": "

The ARN of the KMS key used to encrypt your function's environment variables. If not provided, AWS Lambda will use a default service key.

", + "FunctionConfiguration$KMSKeyArn": "

The KMS key used to encrypt the function's environment variables. Only returned if you've configured a customer managed CMK.

", "UpdateFunctionConfigurationRequest$KMSKeyArn": "

The Amazon Resource Name (ARN) of the KMS key used to encrypt your function's environment variables. If you elect to use the AWS Lambda default service key, pass in an empty string (\"\") for this parameter.

" } }, @@ -532,7 +532,7 @@ } }, "ListEventSourceMappingsRequest": { - "base": "

", + "base": null, "refs": { } }, @@ -542,12 +542,12 @@ } }, "ListFunctionsRequest": { - "base": "

", + "base": null, "refs": { } }, "ListFunctionsResponse": { - "base": "

Contains a list of AWS Lambda function configurations (see FunctionConfiguration.

", + "base": "

A list of Lambda functions.

", "refs": { } }, @@ -562,12 +562,12 @@ } }, "ListVersionsByFunctionRequest": { - "base": "

", + "base": null, "refs": { } }, "ListVersionsByFunctionResponse": { - "base": "

", + "base": null, "refs": { } }, @@ -585,13 +585,13 @@ "AccountLimit$CodeSizeZipped": "

Size, in bytes, of a single zipped code/dependencies package you can upload for your Lambda function(.zip/.jar file). Try using Amazon S3 for uploading larger files. Default limit is 50 MB.

", "AccountUsage$TotalCodeSize": "

Total size, in bytes, of the account's deployment packages per region.

", "AccountUsage$FunctionCount": "

The number of your account's existing functions per region.

", - "FunctionConfiguration$CodeSize": "

The size, in bytes, of the function .zip file you uploaded.

" + "FunctionConfiguration$CodeSize": "

The size of the function's deployment package in bytes.

" } }, "MasterRegion": { "base": null, "refs": { - "ListFunctionsRequest$MasterRegion": "

Optional string. If not specified, will return only regular function versions (i.e., non-replicated versions).

Valid values are:

The region from which the functions are replicated. For example, if you specify us-east-1, only functions replicated from that region will be returned.

ALL: Will return all functions from any region. If specified, you also must specify a valid FunctionVersion parameter.

" + "ListFunctionsRequest$MasterRegion": "

Specify a region (e.g. us-east-2) to only list functions that were created in that region, or ALL to include functions replicated from any region. If specified, you also must specify the FunctionVersion.

" } }, "MaxListItems": { @@ -599,34 +599,34 @@ "refs": { "ListAliasesRequest$MaxItems": "

Optional integer. Specifies the maximum number of aliases to return in response. This parameter value must be greater than 0.

", "ListEventSourceMappingsRequest$MaxItems": "

Optional integer. Specifies the maximum number of event sources to return in response. This value must be greater than 0.

", - "ListFunctionsRequest$MaxItems": "

Optional integer. Specifies the maximum number of AWS Lambda functions to return in response. This parameter value must be greater than 0.

", + "ListFunctionsRequest$MaxItems": "

Optional integer. Specifies the maximum number of AWS Lambda functions to return in response. This parameter value must be greater than 0. The absolute maximum of AWS Lambda functions that can be returned is 50.

", "ListVersionsByFunctionRequest$MaxItems": "

Optional integer. Specifies the maximum number of AWS Lambda function versions to return in response. This parameter value must be greater than 0.

" } }, "MemorySize": { "base": null, "refs": { - "CreateFunctionRequest$MemorySize": "

The amount of memory, in MB, your Lambda function is given. Lambda uses this memory size to infer the amount of CPU and memory allocated to your function. Your function use-case determines your CPU and memory requirements. For example, a database operation might need less memory compared to an image processing function. The default value is 128 MB. The value must be a multiple of 64 MB.

", - "FunctionConfiguration$MemorySize": "

The memory size, in MB, you configured for the function. Must be a multiple of 64 MB.

", + "CreateFunctionRequest$MemorySize": "

The amount of memory that your function has access to. Increasing the function's memory also increases it's CPU allocation. The default value is 128 MB. The value must be a multiple of 64 MB.

", + "FunctionConfiguration$MemorySize": "

The memory allocated to the function

", "UpdateFunctionConfigurationRequest$MemorySize": "

The amount of memory, in MB, your Lambda function is given. AWS Lambda uses this memory size to infer the amount of CPU allocated to your function. Your function use-case determines your CPU and memory requirements. For example, a database operation might need less memory compared to an image processing function. The default value is 128 MB. The value must be a multiple of 64 MB.

" } }, "NameSpacedFunctionArn": { "base": null, "refs": { - "FunctionConfiguration$FunctionArn": "

The Amazon Resource Name (ARN) assigned to the function.

" + "FunctionConfiguration$FunctionArn": "

The function's Amazon Resource Name.

" } }, "NamespacedFunctionName": { "base": null, "refs": { - "FunctionConfiguration$FunctionName": "

The name of the function. Note that the length constraint applies only to the ARN. If you specify only the function name, it is limited to 64 characters in length.

", - "GetFunctionConfigurationRequest$FunctionName": "

The name of the Lambda function for which you want to retrieve the configuration information.

You can specify a function name (for example, Thumbnail) or you can specify Amazon Resource Name (ARN) of the function (for example, arn:aws:lambda:us-west-2:account-id:function:ThumbNail). AWS Lambda also allows you to specify a partial ARN (for example, account-id:Thumbnail). Note that the length constraint applies only to the ARN. If you specify only the function name, it is limited to 64 characters in length.

", - "GetFunctionRequest$FunctionName": "

The Lambda function name.

You can specify a function name (for example, Thumbnail) or you can specify Amazon Resource Name (ARN) of the function (for example, arn:aws:lambda:us-west-2:account-id:function:ThumbNail). AWS Lambda also allows you to specify a partial ARN (for example, account-id:Thumbnail). Note that the length constraint applies only to the ARN. If you specify only the function name, it is limited to 64 characters in length.

", - "GetPolicyRequest$FunctionName": "

Function name whose resource policy you want to retrieve.

You can specify the function name (for example, Thumbnail) or you can specify Amazon Resource Name (ARN) of the function (for example, arn:aws:lambda:us-west-2:account-id:function:ThumbNail). If you are using versioning, you can also provide a qualified function ARN (ARN that is qualified with function version or alias name as suffix). AWS Lambda also allows you to specify only the function name with the account ID qualifier (for example, account-id:Thumbnail). Note that the length constraint applies only to the ARN. If you specify only the function name, it is limited to 64 characters in length.

", - "InvocationRequest$FunctionName": "

The Lambda function name.

You can specify a function name (for example, Thumbnail) or you can specify Amazon Resource Name (ARN) of the function (for example, arn:aws:lambda:us-west-2:account-id:function:ThumbNail). AWS Lambda also allows you to specify a partial ARN (for example, account-id:Thumbnail). Note that the length constraint applies only to the ARN. If you specify only the function name, it is limited to 64 characters in length.

", - "InvokeAsyncRequest$FunctionName": "

The Lambda function name. Note that the length constraint applies only to the ARN. If you specify only the function name, it is limited to 64 characters in length.

", - "ListVersionsByFunctionRequest$FunctionName": "

Function name whose versions to list. You can specify a function name (for example, Thumbnail) or you can specify Amazon Resource Name (ARN) of the function (for example, arn:aws:lambda:us-west-2:account-id:function:ThumbNail). AWS Lambda also allows you to specify a partial ARN (for example, account-id:Thumbnail). Note that the length constraint applies only to the ARN. If you specify only the function name, it is limited to 64 characters in length.

" + "FunctionConfiguration$FunctionName": "

The name of the function.

", + "GetFunctionConfigurationRequest$FunctionName": "

The name of the lambda function.

Name formats

The length constraint applies only to the full ARN. If you specify only the function name, it is limited to 64 characters in length.

", + "GetFunctionRequest$FunctionName": "

The name of the lambda function.

Name formats

The length constraint applies only to the full ARN. If you specify only the function name, it is limited to 64 characters in length.

", + "GetPolicyRequest$FunctionName": "

The name of the lambda function.

Name formats

The length constraint applies only to the full ARN. If you specify only the function name, it is limited to 64 characters in length.

", + "InvocationRequest$FunctionName": "

The name of the lambda function.

Name formats

The length constraint applies only to the full ARN. If you specify only the function name, it is limited to 64 characters in length.

", + "InvokeAsyncRequest$FunctionName": "

The name of the lambda function.

Name formats

The length constraint applies only to the full ARN. If you specify only the function name, it is limited to 64 characters in length.

", + "ListVersionsByFunctionRequest$FunctionName": "

The name of the lambda function.

Name formats

The length constraint applies only to the full ARN. If you specify only the function name, it is limited to 64 characters in length.

" } }, "NamespacedStatementId": { @@ -648,11 +648,11 @@ "Principal": { "base": null, "refs": { - "AddPermissionRequest$Principal": "

The principal who is getting this permission. It can be Amazon S3 service Principal (s3.amazonaws.com) if you want Amazon S3 to invoke the function, an AWS account ID if you are granting cross-account permission, or any valid AWS service principal such as sns.amazonaws.com. For example, you might want to allow a custom application in another AWS account to push events to AWS Lambda by invoking your function.

" + "AddPermissionRequest$Principal": "

The principal who is getting this permission. The principal can be an AWS service (e.g. s3.amazonaws.com or sns.amazonaws.com) for service triggers, or an account ID for cross-account access. If you specify a service as a principal, use the SourceArn parameter to limit who can invoke the function through that service.

" } }, "PublishVersionRequest": { - "base": "

", + "base": null, "refs": { } }, @@ -664,17 +664,17 @@ "Qualifier": { "base": null, "refs": { - "AddPermissionRequest$Qualifier": "

You can use this optional query parameter to describe a qualified ARN using a function version or an alias name. The permission will then apply to the specific qualified ARN. For example, if you specify function version 2 as the qualifier, then permission applies only when request is made using qualified function ARN:

arn:aws:lambda:aws-region:acct-id:function:function-name:2

If you specify an alias name, for example PROD, then the permission is valid only for requests made using the alias ARN:

arn:aws:lambda:aws-region:acct-id:function:function-name:PROD

If the qualifier is not specified, the permission is valid only when requests is made using unqualified function ARN.

arn:aws:lambda:aws-region:acct-id:function:function-name

", - "DeleteFunctionRequest$Qualifier": "

Using this optional parameter you can specify a function version (but not the $LATEST version) to direct AWS Lambda to delete a specific function version. If the function version has one or more aliases pointing to it, you will get an error because you cannot have aliases pointing to it. You can delete any function version but not the $LATEST, that is, you cannot specify $LATEST as the value of this parameter. The $LATEST version can be deleted only when you want to delete all the function versions and aliases.

You can only specify a function version, not an alias name, using this parameter. You cannot delete a function version using its alias.

If you don't specify this parameter, AWS Lambda will delete the function, including all of its versions and aliases.

", - "GetFunctionConfigurationRequest$Qualifier": "

Using this optional parameter you can specify a function version or an alias name. If you specify function version, the API uses qualified function ARN and returns information about the specific function version. If you specify an alias name, the API uses the alias ARN and returns information about the function version to which the alias points.

If you don't specify this parameter, the API uses unqualified function ARN, and returns information about the $LATEST function version.

", - "GetFunctionRequest$Qualifier": "

Use this optional parameter to specify a function version or an alias name. If you specify function version, the API uses qualified function ARN for the request and returns information about the specific Lambda function version. If you specify an alias name, the API uses the alias ARN and returns information about the function version to which the alias points. If you don't provide this parameter, the API uses unqualified function ARN and returns information about the $LATEST version of the Lambda function.

", + "AddPermissionRequest$Qualifier": "

Specify a version or alias to add permissions to a published version of the function.

", + "DeleteFunctionRequest$Qualifier": "

Specify a version to delete. You cannot delete a version that is referenced by an alias.

", + "GetFunctionConfigurationRequest$Qualifier": "

Specify a version or alias to get details about a published version of the function.

", + "GetFunctionRequest$Qualifier": "

Specify a version or alias to get details about a published version of the function.

", "GetPolicyRequest$Qualifier": "

You can specify this optional query parameter to specify a function version or an alias name in which case this API will return all permissions associated with the specific qualified ARN. If you don't provide this parameter, the API will return permissions that apply to the unqualified function ARN.

", - "InvocationRequest$Qualifier": "

You can use this optional parameter to specify a Lambda function version or alias name. If you specify a function version, the API uses the qualified function ARN to invoke a specific Lambda function. If you specify an alias name, the API uses the alias ARN to invoke the Lambda function version to which the alias points.

If you don't provide this parameter, then the API uses unqualified function ARN which results in invocation of the $LATEST version.

", - "RemovePermissionRequest$Qualifier": "

You can specify this optional parameter to remove permission associated with a specific function version or function alias. If you don't specify this parameter, the API removes permission associated with the unqualified function ARN.

" + "InvocationRequest$Qualifier": "

Specify a version or alias to invoke a published version of the function.

", + "RemovePermissionRequest$Qualifier": "

Specify a version or alias to remove permissions from a published version of the function.

" } }, "RemovePermissionRequest": { - "base": "

", + "base": null, "refs": { } }, @@ -686,14 +686,14 @@ "ReservedConcurrentExecutions": { "base": null, "refs": { - "Concurrency$ReservedConcurrentExecutions": "

The number of concurrent executions reserved for this function. For more information, see concurrent-executions.

", - "PutFunctionConcurrencyRequest$ReservedConcurrentExecutions": "

The concurrent execution limit reserved for this function. For more information, see concurrent-executions.

" + "Concurrency$ReservedConcurrentExecutions": "

The number of concurrent executions reserved for this function. For more information, see Managing Concurrency.

", + "PutFunctionConcurrencyRequest$ReservedConcurrentExecutions": "

The concurrent execution limit reserved for this function.

" } }, "ResourceArn": { "base": null, "refs": { - "DeadLetterConfig$TargetArn": "

The Amazon Resource Name (ARN) of an Amazon SQS queue or Amazon SNS topic you specify as your Dead Letter Queue (DLQ). dlq. For more information, see dlq.

" + "DeadLetterConfig$TargetArn": "

The Amazon Resource Name (ARN) of an Amazon SQS queue or Amazon SNS topic.

" } }, "ResourceConflictException": { @@ -714,37 +714,37 @@ "RoleArn": { "base": null, "refs": { - "CreateFunctionRequest$Role": "

The Amazon Resource Name (ARN) of the IAM role that Lambda assumes when it executes your function to access any other Amazon Web Services (AWS) resources. For more information, see AWS Lambda: How it Works.

", - "FunctionConfiguration$Role": "

The Amazon Resource Name (ARN) of the IAM role that Lambda assumes when it executes your function to access any other Amazon Web Services (AWS) resources.

", + "CreateFunctionRequest$Role": "

The Amazon Resource Name (ARN) of the function's execution role.

", + "FunctionConfiguration$Role": "

The function's execution role.

", "UpdateFunctionConfigurationRequest$Role": "

The Amazon Resource Name (ARN) of the IAM role that Lambda will assume when it executes your function.

" } }, "Runtime": { "base": null, "refs": { - "CreateFunctionRequest$Runtime": "

The runtime environment for the Lambda function you are uploading.

To use the Python runtime v3.6, set the value to \"python3.6\". To use the Python runtime v2.7, set the value to \"python2.7\". To use the Node.js runtime v6.10, set the value to \"nodejs6.10\". To use the Node.js runtime v4.3, set the value to \"nodejs4.3\". To use the .NET Core runtime v1.0, set the value to \"dotnetcore1.0\". To use the .NET Core runtime v2.0, set the value to \"dotnetcore2.0\".

Node v0.10.42 is currently marked as deprecated. You must migrate existing functions to the newer Node.js runtime versions available on AWS Lambda (nodejs4.3 or nodejs6.10) as soon as possible. Failure to do so will result in an invalid parameter error being returned. Note that you will have to follow this procedure for each region that contains functions written in the Node v0.10.42 runtime.

", + "CreateFunctionRequest$Runtime": "

The runtime version for the function.

", "FunctionConfiguration$Runtime": "

The runtime environment for the Lambda function.

", - "UpdateFunctionConfigurationRequest$Runtime": "

The runtime environment for the Lambda function.

To use the Python runtime v3.6, set the value to \"python3.6\". To use the Python runtime v2.7, set the value to \"python2.7\". To use the Node.js runtime v6.10, set the value to \"nodejs6.10\". To use the Node.js runtime v4.3, set the value to \"nodejs4.3\". To use the .NET Core runtime v1.0, set the value to \"dotnetcore1.0\". To use the .NET Core runtime v2.0, set the value to \"dotnetcore2.0\".

Node v0.10.42 is currently marked as deprecated. You must migrate existing functions to the newer Node.js runtime versions available on AWS Lambda (nodejs4.3 or nodejs6.10) as soon as possible. Failure to do so will result in an invalid parameter error being returned. Note that you will have to follow this procedure for each region that contains functions written in the Node v0.10.42 runtime.

" + "UpdateFunctionConfigurationRequest$Runtime": "

The runtime version for the function.

" } }, "S3Bucket": { "base": null, "refs": { - "FunctionCode$S3Bucket": "

Amazon S3 bucket name where the .zip file containing your deployment package is stored. This bucket must reside in the same AWS region where you are creating the Lambda function.

", + "FunctionCode$S3Bucket": "

An Amazon S3 bucket in the same region as your function.

", "UpdateFunctionCodeRequest$S3Bucket": "

Amazon S3 bucket name where the .zip file containing your deployment package is stored. This bucket must reside in the same AWS Region where you are creating the Lambda function.

" } }, "S3Key": { "base": null, "refs": { - "FunctionCode$S3Key": "

The Amazon S3 object (the deployment package) key name you want to upload.

", + "FunctionCode$S3Key": "

The Amazon S3 key of the deployment package.

", "UpdateFunctionCodeRequest$S3Key": "

The Amazon S3 object (the deployment package) key name you want to upload.

" } }, "S3ObjectVersion": { "base": null, "refs": { - "FunctionCode$S3ObjectVersion": "

The Amazon S3 object (the deployment package) version you want to upload.

", + "FunctionCode$S3ObjectVersion": "

For versioned objects, the version of the deployment package object to use.

", "UpdateFunctionCodeRequest$S3ObjectVersion": "

The Amazon S3 object (the deployment package) version you want to upload.

" } }, @@ -757,14 +757,14 @@ "SecurityGroupIds": { "base": null, "refs": { - "VpcConfig$SecurityGroupIds": "

A list of one or more security groups IDs in your VPC.

", - "VpcConfigResponse$SecurityGroupIds": "

A list of security group IDs associated with the Lambda function.

" + "VpcConfig$SecurityGroupIds": "

A list of VPC security groups IDs.

", + "VpcConfigResponse$SecurityGroupIds": "

A list of VPC security groups IDs.

" } }, "SensitiveString": { "base": null, "refs": { - "EnvironmentError$Message": "

The message returned by the environment error object.

" + "EnvironmentError$Message": "

The error message.

" } }, "ServiceException": { @@ -787,10 +787,10 @@ "String": { "base": null, "refs": { - "AddPermissionRequest$RevisionId": "

An optional value you can use to ensure you are updating the latest update of the function version or alias. If the RevisionID you pass doesn't match the latest RevisionId of the function or alias, it will fail with an error message, advising you to retrieve the latest function version or alias RevisionID using either or .

", + "AddPermissionRequest$RevisionId": "

An optional value you can use to ensure you are updating the latest update of the function version or alias. If the RevisionID you pass doesn't match the latest RevisionId of the function or alias, it will fail with an error message, advising you to retrieve the latest function version or alias RevisionID using either GetFunction or GetAlias

", "AddPermissionResponse$Statement": "

The permission statement you specified in the request. The response returns the same as a string using a backslash (\"\\\") as an escape character in the JSON.

", "AliasConfiguration$RevisionId": "

Represents the latest updated revision of the function or alias.

", - "CodeStorageExceededException$Type": "

", + "CodeStorageExceededException$Type": "

The exception type.

", "CodeStorageExceededException$message": null, "DeleteEventSourceMappingRequest$UUID": "

The event source mapping ID.

", "EC2AccessDeniedException$Type": null, @@ -802,22 +802,22 @@ "EC2UnexpectedException$EC2ErrorCode": null, "ENILimitReachedException$Type": null, "ENILimitReachedException$Message": null, - "EnvironmentError$ErrorCode": "

The error code returned by the environment error object.

", + "EnvironmentError$ErrorCode": "

The error code.

", "EventSourceMappingConfiguration$UUID": "

The AWS Lambda assigned opaque identifier for the mapping.

", - "EventSourceMappingConfiguration$LastProcessingResult": "

The result of the last AWS Lambda invocation of your Lambda function.

", + "EventSourceMappingConfiguration$LastProcessingResult": "

The result of the last AWS Lambda invocation of your Lambda function. This value will be null if an SQS queue is the event source.

", "EventSourceMappingConfiguration$State": "

The state of the event source mapping. It can be Creating, Enabled, Disabled, Enabling, Disabling, Updating, or Deleting.

", "EventSourceMappingConfiguration$StateTransitionReason": "

The reason the event source mapping is in its current state. It is either user-requested or an AWS Lambda-initiated state transition.

", "FunctionCodeLocation$RepositoryType": "

The repository from which you can download the function.

", "FunctionCodeLocation$Location": "

The presigned URL you can use to download the function's .zip file that you previously uploaded. The URL is valid for up to 10 minutes.

", - "FunctionConfiguration$CodeSha256": "

It is the SHA256 hash of your function deployment package.

", + "FunctionConfiguration$CodeSha256": "

The SHA256 hash of the function's deployment package.

", "FunctionConfiguration$RevisionId": "

Represents the latest updated revision of the function or alias.

", "GetEventSourceMappingRequest$UUID": "

The AWS Lambda assigned ID of the event source mapping.

", "GetPolicyResponse$Policy": "

The resource policy associated with the specified function. The response returns the same as a string using a backslash (\"\\\") as an escape character in the JSON.

", "GetPolicyResponse$RevisionId": "

Represents the latest updated revision of the function or alias.

", - "InvalidParameterValueException$Type": "

", - "InvalidParameterValueException$message": "

", - "InvalidRequestContentException$Type": "

", - "InvalidRequestContentException$message": "

", + "InvalidParameterValueException$Type": "

The exception type.

", + "InvalidParameterValueException$message": "

The exception message.

", + "InvalidRequestContentException$Type": "

The exception type.

", + "InvalidRequestContentException$message": "

The exception message.

", "InvalidRuntimeException$Type": null, "InvalidRuntimeException$Message": null, "InvalidSecurityGroupIDException$Type": null, @@ -826,7 +826,7 @@ "InvalidSubnetIDException$Message": null, "InvalidZipFileException$Type": null, "InvalidZipFileException$Message": null, - "InvocationRequest$ClientContext": "

Using the ClientContext you can pass client-specific information to the Lambda function you are invoking. You can then process the client information in your Lambda function as you choose through the context variable. For an example of a ClientContext JSON, see PutEvents in the Amazon Mobile Analytics API Reference and User Guide.

The ClientContext JSON must be base64-encoded and has a maximum size of 3583 bytes.

", + "InvocationRequest$ClientContext": "

Using the ClientContext you can pass client-specific information to the Lambda function you are invoking. You can then process the client information in your Lambda function as you choose through the context variable. For an example of a ClientContext JSON, see PutEvents in the Amazon Mobile Analytics API Reference and User Guide.

The ClientContext JSON must be base64-encoded and has a maximum size of 3583 bytes.

ClientContext information is returned only if you use the synchronous (RequestResponse) invocation type.

", "InvocationResponse$FunctionError": "

Indicates whether an error occurred while executing the Lambda function. If an error occurred this field will have one of two values; Handled or Unhandled. Handled errors are errors that are reported by the function while the Unhandled errors are those detected and reported by AWS Lambda. Unhandled errors include out of memory errors and function timeouts. For information about how to report an Handled error, see Programming Model.

", "InvocationResponse$LogResult": "

It is the base64-encoded logs for the Lambda function invocation. This is present only if the invocation type is RequestResponse and the logs were requested.

", "KMSAccessDeniedException$Type": null, @@ -847,15 +847,15 @@ "ListVersionsByFunctionResponse$NextMarker": "

A string, present if there are more function versions.

", "PolicyLengthExceededException$Type": null, "PolicyLengthExceededException$message": null, - "PreconditionFailedException$Type": "

", - "PreconditionFailedException$message": "

", + "PreconditionFailedException$Type": "

The exception type.

", + "PreconditionFailedException$message": "

The exception message.

", "PublishVersionRequest$CodeSha256": "

The SHA256 hash of the deployment package you want to publish. This provides validation on the code you are publishing. If you provide this parameter, the value must match the SHA256 of the $LATEST version for the publication to succeed. You can use the DryRun parameter of UpdateFunctionCode to verify the hash value that will be returned before publishing your new version.

", - "PublishVersionRequest$RevisionId": "

An optional value you can use to ensure you are updating the latest update of the function version or alias. If the RevisionID you pass doesn't match the latest RevisionId of the function or alias, it will fail with an error message, advising you to retrieve the latest function version or alias RevisionID using either or .

", - "RemovePermissionRequest$RevisionId": "

An optional value you can use to ensure you are updating the latest update of the function version or alias. If the RevisionID you pass doesn't match the latest RevisionId of the function or alias, it will fail with an error message, advising you to retrieve the latest function version or alias RevisionID using either or .

", + "PublishVersionRequest$RevisionId": "

An optional value you can use to ensure you are updating the latest update of the function version or alias. If the RevisionID you pass doesn't match the latest RevisionId of the function or alias, it will fail with an error message, advising you retrieve the latest function version or alias RevisionID using either GetFunction or GetAlias.

", + "RemovePermissionRequest$RevisionId": "

An optional value you can use to ensure you are updating the latest update of the function version or alias. If the RevisionID you pass doesn't match the latest RevisionId of the function or alias, it will fail with an error message, advising you to retrieve the latest function version or alias RevisionID using either GetFunction or GetAlias.

", "RequestTooLargeException$Type": null, "RequestTooLargeException$message": null, - "ResourceConflictException$Type": "

", - "ResourceConflictException$message": "

", + "ResourceConflictException$Type": "

The exception type.

", + "ResourceConflictException$message": "

The exception message.

", "ResourceInUseException$Type": null, "ResourceInUseException$Message": null, "ResourceNotFoundException$Type": null, @@ -869,10 +869,10 @@ "TooManyRequestsException$message": null, "UnsupportedMediaTypeException$Type": null, "UnsupportedMediaTypeException$message": null, - "UpdateAliasRequest$RevisionId": "

An optional value you can use to ensure you are updating the latest update of the function version or alias. If the RevisionID you pass doesn't match the latest RevisionId of the function or alias, it will fail with an error message, advising you to retrieve the latest function version or alias RevisionID using either or .

", + "UpdateAliasRequest$RevisionId": "

An optional value you can use to ensure you are updating the latest update of the function version or alias. If the RevisionID you pass doesn't match the latest RevisionId of the function or alias, it will fail with an error message, advising you retrieve the latest function version or alias RevisionID using either GetFunction or GetAlias.

", "UpdateEventSourceMappingRequest$UUID": "

The event source mapping identifier.

", - "UpdateFunctionCodeRequest$RevisionId": "

An optional value you can use to ensure you are updating the latest update of the function version or alias. If the RevisionID you pass doesn't match the latest RevisionId of the function or alias, it will fail with an error message, advising you to retrieve the latest function version or alias RevisionID using either or .

", - "UpdateFunctionConfigurationRequest$RevisionId": "

An optional value you can use to ensure you are updating the latest update of the function version or alias. If the RevisionID you pass doesn't match the latest RevisionId of the function or alias, it will fail with an error message, advising you to retrieve the latest function version or alias RevisionID using either or .

" + "UpdateFunctionCodeRequest$RevisionId": "

An optional value you can use to ensure you are updating the latest update of the function version or alias. If the RevisionID you pass doesn't match the latest RevisionId of the function or alias, it will fail with an error message, advising you to retrieve the latest function version or alias RevisionID using either using using either GetFunction or GetAlias.

", + "UpdateFunctionConfigurationRequest$RevisionId": "

An optional value you can use to ensure you are updating the latest update of the function version or alias. If the RevisionID you pass doesn't match the latest RevisionId of the function or alias, it will fail with an error message, advising you to retrieve the latest function version or alias RevisionID using either GetFunction or GetAlias.

" } }, "SubnetIPAddressLimitReachedException": { @@ -889,8 +889,8 @@ "SubnetIds": { "base": null, "refs": { - "VpcConfig$SubnetIds": "

A list of one or more subnet IDs in your VPC.

", - "VpcConfigResponse$SubnetIds": "

A list of subnet IDs associated with the Lambda function.

" + "VpcConfig$SubnetIds": "

A list of VPC subnet IDs.

", + "VpcConfigResponse$SubnetIds": "

A list of VPC subnet IDs.

" } }, "TagKey": { @@ -935,46 +935,46 @@ "Timeout": { "base": null, "refs": { - "CreateFunctionRequest$Timeout": "

The function execution time at which Lambda should terminate the function. Because the execution time has cost implications, we recommend you set this value based on your expected execution time. The default is 3 seconds.

", - "FunctionConfiguration$Timeout": "

The function execution time at which Lambda should terminate the function. Because the execution time has cost implications, we recommend you set this value based on your expected execution time. The default is 3 seconds.

", - "UpdateFunctionConfigurationRequest$Timeout": "

The function execution time at which AWS Lambda should terminate the function. Because the execution time has cost implications, we recommend you set this value based on your expected execution time. The default is 3 seconds.

" + "CreateFunctionRequest$Timeout": "

The amount of time that Lambda allows a function to run before terminating it. The default is 3 seconds. The maximum allowed value is 900 seconds.

", + "FunctionConfiguration$Timeout": "

The amount of time that Lambda allows a function to run before terminating it.

", + "UpdateFunctionConfigurationRequest$Timeout": "

The amount of time that Lambda allows a function to run before terminating it. The default is 3 seconds. The maximum allowed value is 900 seconds.

" } }, "Timestamp": { "base": null, "refs": { - "FunctionConfiguration$LastModified": "

The time stamp of the last time you updated the function. The time stamp is conveyed as a string complying with ISO-8601 in this way YYYY-MM-DDThh:mm:ssTZD (e.g., 1997-07-16T19:20:30+01:00). For more information, see Date and Time Formats.

" + "FunctionConfiguration$LastModified": "

The date and time that the function was last updated, in ISO-8601 format (YYYY-MM-DDThh:mm:ssTZD).

" } }, "TooManyRequestsException": { - "base": "

", + "base": "

Request throughput limit exceeded

", "refs": { } }, "TracingConfig": { - "base": "

The parent object that contains your function's tracing settings.

", + "base": "

The function's AWS X-Ray tracing configuration.

", "refs": { - "CreateFunctionRequest$TracingConfig": "

The parent object that contains your function's tracing settings.

", - "UpdateFunctionConfigurationRequest$TracingConfig": "

The parent object that contains your function's tracing settings.

" + "CreateFunctionRequest$TracingConfig": "

Set Mode to Active to sample and trace a subset of incoming requests with AWS X-Ray.

", + "UpdateFunctionConfigurationRequest$TracingConfig": "

Set Mode to Active to sample and trace a subset of incoming requests with AWS X-Ray.

" } }, "TracingConfigResponse": { - "base": "

Parent object of the tracing information associated with your Lambda function.

", + "base": "

The function's AWS X-Ray tracing configuration.

", "refs": { - "FunctionConfiguration$TracingConfig": "

The parent object that contains your function's tracing settings.

" + "FunctionConfiguration$TracingConfig": "

The function's AWS X-Ray tracing configuration.

" } }, "TracingMode": { "base": null, "refs": { - "TracingConfig$Mode": "

Can be either PassThrough or Active. If PassThrough, Lambda will only trace the request from an upstream service if it contains a tracing header with \"sampled=1\". If Active, Lambda will respect any tracing header it receives from an upstream service. If no tracing header is received, Lambda will call X-Ray for a tracing decision.

", - "TracingConfigResponse$Mode": "

The tracing mode associated with your Lambda function.

" + "TracingConfig$Mode": "

The tracing mode.

", + "TracingConfigResponse$Mode": "

The tracing mode.

" } }, "UnreservedConcurrentExecutions": { "base": null, "refs": { - "AccountLimit$UnreservedConcurrentExecutions": "

The number of concurrent executions available to functions that do not have concurrency limits set. For more information, see concurrent-executions.

" + "AccountLimit$UnreservedConcurrentExecutions": "

The number of concurrent executions available to functions that do not have concurrency limits set. For more information, see Managing Concurrency.

" } }, "UnsupportedMediaTypeException": { @@ -993,17 +993,17 @@ } }, "UpdateEventSourceMappingRequest": { - "base": "

", + "base": null, "refs": { } }, "UpdateFunctionCodeRequest": { - "base": "

", + "base": null, "refs": { } }, "UpdateFunctionConfigurationRequest": { - "base": "

", + "base": null, "refs": { } }, @@ -1013,28 +1013,28 @@ "AliasConfiguration$FunctionVersion": "

Function version to which the alias points.

", "CreateAliasRequest$FunctionVersion": "

Lambda function version for which you are creating the alias.

", "FunctionConfiguration$Version": "

The version of the Lambda function.

", - "InvocationResponse$ExecutedVersion": "

The function version that has been executed. This value is returned only if the invocation type is RequestResponse. For more information, see lambda-traffic-shifting-using-aliases.

", + "InvocationResponse$ExecutedVersion": "

The function version that has been executed. This value is returned only if the invocation type is RequestResponse. For more information, see Traffic Shifting Using Aliases.

", "ListAliasesRequest$FunctionVersion": "

If you specify this optional parameter, the API returns only the aliases that are pointing to the specific Lambda function version, otherwise the API returns all of the aliases created for the Lambda function.

", "UpdateAliasRequest$FunctionVersion": "

Using this parameter you can change the Lambda function version to which the alias points.

" } }, "VpcConfig": { - "base": "

If your Lambda function accesses resources in a VPC, you provide this parameter identifying the list of security group IDs and subnet IDs. These must belong to the same VPC. You must provide at least one security group and one subnet ID.

", + "base": "

The VPC security groups and subnets attached to a Lambda function.

", "refs": { "CreateFunctionRequest$VpcConfig": "

If your Lambda function accesses resources in a VPC, you provide this parameter identifying the list of security group IDs and subnet IDs. These must belong to the same VPC. You must provide at least one security group and one subnet ID.

", - "UpdateFunctionConfigurationRequest$VpcConfig": null + "UpdateFunctionConfigurationRequest$VpcConfig": "

Specify security groups and subnets in a VPC to which your Lambda function needs access.

" } }, "VpcConfigResponse": { - "base": "

VPC configuration associated with your Lambda function.

", + "base": "

The VPC security groups and subnets attached to a Lambda function.

", "refs": { - "FunctionConfiguration$VpcConfig": "

VPC configuration associated with your Lambda function.

" + "FunctionConfiguration$VpcConfig": "

The function's networking configuration.

" } }, "VpcId": { "base": null, "refs": { - "VpcConfigResponse$VpcId": "

The VPC ID associated with you Lambda function.

" + "VpcConfigResponse$VpcId": "

The ID of the VPC.

" } }, "Weight": { diff --git a/models/apis/mediaconvert/2017-08-29/paginators-1.json b/models/apis/mediaconvert/2017-08-29/paginators-1.json new file mode 100644 index 00000000000..24b088e9cd8 --- /dev/null +++ b/models/apis/mediaconvert/2017-08-29/paginators-1.json @@ -0,0 +1,34 @@ +{ + "pagination": { + "DescribeEndpoints": { + "input_token": "NextToken", + "output_token": "NextToken", + "limit_key": "MaxResults", + "result_key": "Endpoints" + }, + "ListJobs": { + "input_token": "NextToken", + "output_token": "NextToken", + "limit_key": "MaxResults", + "result_key": "Jobs" + }, + "ListPresets": { + "input_token": "NextToken", + "output_token": "NextToken", + "limit_key": "MaxResults", + "result_key": "Presets" + }, + "ListJobTemplates": { + "input_token": "NextToken", + "output_token": "NextToken", + "limit_key": "MaxResults", + "result_key": "JobTemplates" + }, + "ListQueues": { + "input_token": "NextToken", + "output_token": "NextToken", + "limit_key": "MaxResults", + "result_key": "Queues" + } + } +} \ No newline at end of file diff --git a/models/apis/rds/2014-10-31/api-2.json b/models/apis/rds/2014-10-31/api-2.json index d3bfc5b891d..b383fa2f41c 100644 --- a/models/apis/rds/2014-10-31/api-2.json +++ b/models/apis/rds/2014-10-31/api-2.json @@ -5182,6 +5182,7 @@ "EnableCloudwatchLogsExports":{"shape":"LogTypeList"}, "EngineMode":{"shape":"String"}, "ScalingConfiguration":{"shape":"ScalingConfiguration"}, + "DBClusterParameterGroupName":{"shape":"String"}, "DeletionProtection":{"shape":"BooleanOptional"} } }, @@ -5212,6 +5213,7 @@ "EnableIAMDatabaseAuthentication":{"shape":"BooleanOptional"}, "BacktrackWindow":{"shape":"LongOptional"}, "EnableCloudwatchLogsExports":{"shape":"LogTypeList"}, + "DBClusterParameterGroupName":{"shape":"String"}, "DeletionProtection":{"shape":"BooleanOptional"} } }, @@ -5253,6 +5255,7 @@ "EnableCloudwatchLogsExports":{"shape":"LogTypeList"}, "ProcessorFeatures":{"shape":"ProcessorFeatureList"}, "UseDefaultProcessorFeatures":{"shape":"BooleanOptional"}, + "DBParameterGroupName":{"shape":"String"}, "DeletionProtection":{"shape":"BooleanOptional"} } }, @@ -5359,6 +5362,7 @@ "EnableCloudwatchLogsExports":{"shape":"LogTypeList"}, "ProcessorFeatures":{"shape":"ProcessorFeatureList"}, "UseDefaultProcessorFeatures":{"shape":"BooleanOptional"}, + "DBParameterGroupName":{"shape":"String"}, "DeletionProtection":{"shape":"BooleanOptional"} } }, diff --git a/models/apis/rds/2014-10-31/docs-2.json b/models/apis/rds/2014-10-31/docs-2.json index 4aeaf286400..a245964a9dd 100644 --- a/models/apis/rds/2014-10-31/docs-2.json +++ b/models/apis/rds/2014-10-31/docs-2.json @@ -209,7 +209,7 @@ "DBCluster$AvailabilityZones": "

Provides the list of EC2 Availability Zones that instances in the DB cluster can be created in.

", "DBClusterSnapshot$AvailabilityZones": "

Provides the list of EC2 Availability Zones that instances in the DB cluster snapshot can be restored in.

", "RestoreDBClusterFromS3Message$AvailabilityZones": "

A list of EC2 Availability Zones that instances in the restored DB cluster can be created in.

", - "RestoreDBClusterFromSnapshotMessage$AvailabilityZones": "

Provides the list of EC2 Availability Zones that instances in the restored DB cluster can be created in.

" + "RestoreDBClusterFromSnapshotMessage$AvailabilityZones": "

Provides the list of Amazon EC2 Availability Zones that instances in the restored DB cluster can be created in.

" } }, "AvailableProcessorFeature": { @@ -296,8 +296,8 @@ "ReservedDBInstancesOffering$MultiAZ": "

Indicates if the offering applies to Multi-AZ deployments.

", "ResetDBClusterParameterGroupMessage$ResetAllParameters": "

A value that is set to true to reset all parameters in the DB cluster parameter group to their default values, and false otherwise. You can't use this parameter if there is a list of parameter names specified for the Parameters parameter.

", "ResetDBParameterGroupMessage$ResetAllParameters": "

Specifies whether (true) or not (false) to reset all parameters in the DB parameter group to default values.

Default: true

", - "RestoreDBClusterToPointInTimeMessage$UseLatestRestorableTime": "

A value that is set to true to restore the DB cluster to the latest restorable backup time, and false otherwise.

Default: false

Constraints: Cannot be specified if RestoreToTime parameter is provided.

", - "RestoreDBInstanceToPointInTimeMessage$UseLatestRestorableTime": "

Specifies whether (true) or not (false) the DB instance is restored from the latest backup time.

Default: false

Constraints: Cannot be specified if RestoreTime parameter is provided.

", + "RestoreDBClusterToPointInTimeMessage$UseLatestRestorableTime": "

A value that is set to true to restore the DB cluster to the latest restorable backup time, and false otherwise.

Default: false

Constraints: Can't be specified if RestoreToTime parameter is provided.

", + "RestoreDBInstanceToPointInTimeMessage$UseLatestRestorableTime": "

Specifies whether (true) or not (false) the DB instance is restored from the latest backup time.

Default: false

Constraints: Can't be specified if RestoreTime parameter is provided.

", "UpgradeTarget$AutoUpgrade": "

A value that indicates whether the target version is applied to any source DB instances that have AutoMinorVersionUpgrade set to true.

", "UpgradeTarget$IsMajorVersionUpgrade": "

A value that indicates whether a database engine is upgraded to a major version.

" } @@ -1620,9 +1620,9 @@ "CreateDBClusterMessage$BackupRetentionPeriod": "

The number of days for which automated backups are retained. You must specify a minimum value of 1.

Default: 1

Constraints:

", "CreateDBClusterMessage$Port": "

The port number on which the instances in the DB cluster accept connections.

Default: 3306 if engine is set as aurora or 5432 if set to aurora-postgresql.

", "CreateDBInstanceMessage$AllocatedStorage": "

The amount of storage (in gibibytes) to allocate for the DB instance.

Type: Integer

Amazon Aurora

Not applicable. Aurora cluster volumes automatically grow as the amount of data in your database increases, though you are only charged for the space that you use in an Aurora cluster volume.

MySQL

Constraints to the amount of storage for each storage type are the following:

MariaDB

Constraints to the amount of storage for each storage type are the following:

PostgreSQL

Constraints to the amount of storage for each storage type are the following:

Oracle

Constraints to the amount of storage for each storage type are the following:

SQL Server

Constraints to the amount of storage for each storage type are the following:

", - "CreateDBInstanceMessage$BackupRetentionPeriod": "

The number of days for which automated backups are retained. Setting this parameter to a positive number enables backups. Setting this parameter to 0 disables automated backups.

Amazon Aurora

Not applicable. The retention period for automated backups is managed by the DB cluster. For more information, see CreateDBCluster.

Default: 1

Constraints:

", + "CreateDBInstanceMessage$BackupRetentionPeriod": "

The number of days for which automated backups are retained. Setting this parameter to a positive number enables backups. Setting this parameter to 0 disables automated backups.

Amazon Aurora

Not applicable. The retention period for automated backups is managed by the DB cluster. For more information, see CreateDBCluster.

Default: 1

Constraints:

", "CreateDBInstanceMessage$Port": "

The port number on which the database accepts connections.

MySQL

Default: 3306

Valid Values: 1150-65535

Type: Integer

MariaDB

Default: 3306

Valid Values: 1150-65535

Type: Integer

PostgreSQL

Default: 5432

Valid Values: 1150-65535

Type: Integer

Oracle

Default: 1521

Valid Values: 1150-65535

SQL Server

Default: 1433

Valid Values: 1150-65535 except for 1434, 3389, 47001, 49152, and 49152 through 49156.

Amazon Aurora

Default: 3306

Valid Values: 1150-65535

Type: Integer

", - "CreateDBInstanceMessage$Iops": "

The amount of Provisioned IOPS (input/output operations per second) to be initially allocated for the DB instance. For information about valid Iops values, see see Amazon RDS Provisioned IOPS Storage to Improve Performance in the Amazon RDS User Guide.

Constraints: Must be a multiple between 1 and 50 of the storage amount for the DB instance. Must also be an integer multiple of 1000. For example, if the size of your DB instance is 500 GiB, then your Iops value can be 2000, 3000, 4000, or 5000.

", + "CreateDBInstanceMessage$Iops": "

The amount of Provisioned IOPS (input/output operations per second) to be initially allocated for the DB instance. For information about valid Iops values, see see Amazon RDS Provisioned IOPS Storage to Improve Performance in the Amazon RDS User Guide.

Constraints: Must be a multiple between 1 and 50 of the storage amount for the DB instance.

", "CreateDBInstanceMessage$MonitoringInterval": "

The interval, in seconds, between points when Enhanced Monitoring metrics are collected for the DB instance. To disable collecting Enhanced Monitoring metrics, specify 0. The default is 0.

If MonitoringRoleArn is specified, then you must also set MonitoringInterval to a value other than 0.

Valid Values: 0, 1, 5, 10, 15, 30, 60

", "CreateDBInstanceMessage$PromotionTier": "

A value that specifies the order in which an Aurora Replica is promoted to the primary instance after a failure of the existing primary instance. For more information, see Fault Tolerance for an Aurora DB Cluster in the Amazon Aurora User Guide.

Default: 1

Valid Values: 0 - 15

", "CreateDBInstanceMessage$PerformanceInsightsRetentionPeriod": "

The amount of time, in days, to retain Performance Insights data. Valid values are 7 or 731 (2 years).

", @@ -1674,7 +1674,7 @@ "ModifyDBClusterMessage$BackupRetentionPeriod": "

The number of days for which automated backups are retained. You must specify a minimum value of 1.

Default: 1

Constraints:

", "ModifyDBClusterMessage$Port": "

The port number on which the DB cluster accepts connections.

Constraints: Value must be 1150-65535

Default: The same port as the original DB cluster.

", "ModifyDBInstanceMessage$AllocatedStorage": "

The new amount of storage (in gibibytes) to allocate for the DB instance.

For MariaDB, MySQL, Oracle, and PostgreSQL, the value supplied must be at least 10% greater than the current value. Values that are not at least 10% greater than the existing value are rounded up so that they are 10% greater than the current value.

For the valid values for allocated storage for each engine, see CreateDBInstance.

", - "ModifyDBInstanceMessage$BackupRetentionPeriod": "

The number of days to retain automated backups. Setting this parameter to a positive number enables backups. Setting this parameter to 0 disables automated backups.

Changing this parameter can result in an outage if you change from 0 to a non-zero value or from a non-zero value to 0. These changes are applied during the next maintenance window unless the ApplyImmediately parameter is set to true for this request. If you change the parameter from one non-zero value to another non-zero value, the change is asynchronously applied as soon as possible.

Amazon Aurora

Not applicable. The retention period for automated backups is managed by the DB cluster. For more information, see ModifyDBCluster.

Default: Uses existing setting

Constraints:

", + "ModifyDBInstanceMessage$BackupRetentionPeriod": "

The number of days to retain automated backups. Setting this parameter to a positive number enables backups. Setting this parameter to 0 disables automated backups.

Changing this parameter can result in an outage if you change from 0 to a non-zero value or from a non-zero value to 0. These changes are applied during the next maintenance window unless the ApplyImmediately parameter is set to true for this request. If you change the parameter from one non-zero value to another non-zero value, the change is asynchronously applied as soon as possible.

Amazon Aurora

Not applicable. The retention period for automated backups is managed by the DB cluster. For more information, see ModifyDBCluster.

Default: Uses existing setting

Constraints:

", "ModifyDBInstanceMessage$Iops": "

The new Provisioned IOPS (I/O operations per second) value for the RDS instance.

Changing this setting doesn't result in an outage and the change is applied during the next maintenance window unless the ApplyImmediately parameter is set to true for this request. If you are migrating from Provisioned IOPS to standard storage, set this value to 0. The DB instance will require a reboot for the change in storage type to take effect.

If you choose to migrate your DB instance from using standard storage to using Provisioned IOPS, or from using Provisioned IOPS to using standard storage, the process can take time. The duration of the migration depends on several factors such as database load, storage size, storage type (standard or Provisioned IOPS), amount of IOPS provisioned (if any), and the number of prior scale storage operations. Typical migration times are under 24 hours, but the process can take up to several days in some cases. During the migration, the DB instance is available for use, but might experience performance degradation. While the migration takes place, nightly backups for the instance are suspended. No other Amazon RDS operations can take place for the instance, including modifying the instance, rebooting the instance, deleting the instance, creating a Read Replica for the instance, and creating a DB snapshot of the instance.

Constraints: For MariaDB, MySQL, Oracle, and PostgreSQL, the value supplied must be at least 10% greater than the current value. Values that are not at least 10% greater than the existing value are rounded up so that they are 10% greater than the current value.

Default: Uses existing setting

", "ModifyDBInstanceMessage$MonitoringInterval": "

The interval, in seconds, between points when Enhanced Monitoring metrics are collected for the DB instance. To disable collecting Enhanced Monitoring metrics, specify 0. The default is 0.

If MonitoringRoleArn is specified, then you must also set MonitoringInterval to a value other than 0.

Valid Values: 0, 1, 5, 10, 15, 30, 60

", "ModifyDBInstanceMessage$DBPortNumber": "

The port number on which the database accepts connections.

The value of the DBPortNumber parameter must not match any of the port values specified for options in the option group for the DB instance.

Your database will restart when you change the DBPortNumber value regardless of the value of the ApplyImmediately parameter.

MySQL

Default: 3306

Valid Values: 1150-65535

MariaDB

Default: 3306

Valid Values: 1150-65535

PostgreSQL

Default: 5432

Valid Values: 1150-65535

Type: Integer

Oracle

Default: 1521

Valid Values: 1150-65535

SQL Server

Default: 1433

Valid Values: 1150-65535 except for 1434, 3389, 47001, 49152, and 49152 through 49156.

Amazon Aurora

Default: 3306

Valid Values: 1150-65535

", @@ -1696,7 +1696,7 @@ "Range$Step": "

The step value for the range. For example, if you have a range of 5,000 to 10,000, with a step value of 1,000, the valid values start at 5,000 and step up by 1,000. Even though 7,500 is within the range, it isn't a valid value for the range. The valid values are 5,000, 6,000, 7,000, 8,000...

", "RestoreDBClusterFromS3Message$BackupRetentionPeriod": "

The number of days for which automated backups of the restored DB cluster are retained. You must specify a minimum value of 1.

Default: 1

Constraints:

", "RestoreDBClusterFromS3Message$Port": "

The port number on which the instances in the restored DB cluster accept connections.

Default: 3306

", - "RestoreDBClusterFromSnapshotMessage$Port": "

The port number on which the new DB cluster accepts connections.

Constraints: Value must be 1150-65535

Default: The same port as the original DB cluster.

", + "RestoreDBClusterFromSnapshotMessage$Port": "

The port number on which the new DB cluster accepts connections.

Constraints: This value must be 1150-65535

Default: The same port as the original DB cluster.

", "RestoreDBClusterToPointInTimeMessage$Port": "

The port number on which the new DB cluster accepts connections.

Constraints: A value from 1150-65535.

Default: The default port for the engine.

", "RestoreDBInstanceFromDBSnapshotMessage$Port": "

The port number on which the database accepts connections.

Default: The same port as the original DB instance

Constraints: Value must be 1150-65535

", "RestoreDBInstanceFromDBSnapshotMessage$Iops": "

Specifies the amount of provisioned IOPS for the DB instance, expressed in I/O operations per second. If this parameter is not specified, the IOPS value is taken from the backup. If this parameter is set to 0, the new instance is converted to a non-PIOPS instance. The conversion takes additional time, though your DB instance is available for connections before the conversion starts.

The provisioned IOPS value must follow the requirements for your database engine. For more information, see Amazon RDS Provisioned IOPS Storage to Improve Performance in the Amazon RDS User Guide.

Constraints: Must be an integer greater than 1000.

", @@ -1826,7 +1826,7 @@ "PendingCloudwatchLogsExports$LogTypesToEnable": "

Log types that are in the process of being deactivated. After they are deactivated, these log types aren't exported to CloudWatch Logs.

", "PendingCloudwatchLogsExports$LogTypesToDisable": "

Log types that are in the process of being enabled. After they are enabled, these log types are exported to CloudWatch Logs.

", "RestoreDBClusterFromS3Message$EnableCloudwatchLogsExports": "

The list of logs that the restored DB cluster is to export to CloudWatch Logs. The values in the list depend on the DB engine being used. For more information, see Publishing Database Logs to Amazon CloudWatch Logs in the Amazon Aurora User Guide.

", - "RestoreDBClusterFromSnapshotMessage$EnableCloudwatchLogsExports": "

The list of logs that the restored DB cluster is to export to CloudWatch Logs. The values in the list depend on the DB engine being used. For more information, see Publishing Database Logs to Amazon CloudWatch Logs in the Amazon Aurora User Guide.

", + "RestoreDBClusterFromSnapshotMessage$EnableCloudwatchLogsExports": "

The list of logs that the restored DB cluster is to export to Amazon CloudWatch Logs. The values in the list depend on the DB engine being used. For more information, see Publishing Database Logs to Amazon CloudWatch Logs in the Amazon Aurora User Guide.

", "RestoreDBClusterToPointInTimeMessage$EnableCloudwatchLogsExports": "

The list of logs that the restored DB cluster is to export to CloudWatch Logs. The values in the list depend on the DB engine being used. For more information, see Publishing Database Logs to Amazon CloudWatch Logs in the Amazon Aurora User Guide.

", "RestoreDBInstanceFromDBSnapshotMessage$EnableCloudwatchLogsExports": "

The list of logs that the restored DB instance is to export to CloudWatch Logs. The values in the list depend on the DB engine being used. For more information, see Publishing Database Logs to Amazon CloudWatch Logs in the Amazon Aurora User Guide.

", "RestoreDBInstanceFromS3Message$EnableCloudwatchLogsExports": "

The list of logs that the restored DB instance is to export to CloudWatch Logs. The values in the list depend on the DB engine being used. For more information, see Publishing Database Logs to Amazon CloudWatch Logs in the Amazon RDS User Guide.

", @@ -2611,7 +2611,7 @@ "AvailableProcessorFeature$Name": "

The name of the processor feature. Valid names are coreCount and threadsPerCore.

", "AvailableProcessorFeature$DefaultValue": "

The default value for the processor feature of the DB instance class.

", "AvailableProcessorFeature$AllowedValues": "

The allowed values for the processor feature of the DB instance class.

", - "BacktrackDBClusterMessage$DBClusterIdentifier": "

The DB cluster identifier of the DB cluster to be backtracked. This parameter is stored as a lowercase string.

Constraints:

Example: my-cluster1

", + "BacktrackDBClusterMessage$DBClusterIdentifier": "

The DB cluster identifier of the DB cluster to be backtracked. This parameter is stored as a lowercase string.

Constraints:

Example: my-cluster1

", "Certificate$CertificateIdentifier": "

The unique key that identifies a certificate.

", "Certificate$CertificateType": "

The type of the certificate.

", "Certificate$Thumbprint": "

The thumbprint of the certificate.

", @@ -2620,31 +2620,31 @@ "CharacterSet$CharacterSetName": "

The name of the character set.

", "CharacterSet$CharacterSetDescription": "

The description of the character set.

", "CopyDBClusterParameterGroupMessage$SourceDBClusterParameterGroupIdentifier": "

The identifier or Amazon Resource Name (ARN) for the source DB cluster parameter group. For information about creating an ARN, see Constructing an ARN for Amazon RDS in the Amazon Aurora User Guide.

Constraints:

", - "CopyDBClusterParameterGroupMessage$TargetDBClusterParameterGroupIdentifier": "

The identifier for the copied DB cluster parameter group.

Constraints:

Example: my-cluster-param-group1

", + "CopyDBClusterParameterGroupMessage$TargetDBClusterParameterGroupIdentifier": "

The identifier for the copied DB cluster parameter group.

Constraints:

Example: my-cluster-param-group1

", "CopyDBClusterParameterGroupMessage$TargetDBClusterParameterGroupDescription": "

A description for the copied DB cluster parameter group.

", "CopyDBClusterSnapshotMessage$SourceDBClusterSnapshotIdentifier": "

The identifier of the DB cluster snapshot to copy. This parameter is not case-sensitive.

You can't copy an encrypted, shared DB cluster snapshot from one AWS Region to another.

Constraints:

Example: my-cluster-snapshot1

", - "CopyDBClusterSnapshotMessage$TargetDBClusterSnapshotIdentifier": "

The identifier of the new DB cluster snapshot to create from the source DB cluster snapshot. This parameter is not case-sensitive.

Constraints:

Example: my-cluster-snapshot2

", + "CopyDBClusterSnapshotMessage$TargetDBClusterSnapshotIdentifier": "

The identifier of the new DB cluster snapshot to create from the source DB cluster snapshot. This parameter is not case-sensitive.

Constraints:

Example: my-cluster-snapshot2

", "CopyDBClusterSnapshotMessage$KmsKeyId": "

The AWS AWS KMS key ID for an encrypted DB cluster snapshot. The KMS key ID is the Amazon Resource Name (ARN), KMS key identifier, or the KMS key alias for the KMS encryption key.

If you copy an encrypted DB cluster snapshot from your AWS account, you can specify a value for KmsKeyId to encrypt the copy with a new KMS encryption key. If you don't specify a value for KmsKeyId, then the copy of the DB cluster snapshot is encrypted with the same KMS key as the source DB cluster snapshot.

If you copy an encrypted DB cluster snapshot that is shared from another AWS account, then you must specify a value for KmsKeyId.

To copy an encrypted DB cluster snapshot to another AWS Region, you must set KmsKeyId to the KMS key ID you want to use to encrypt the copy of the DB cluster snapshot in the destination AWS Region. KMS encryption keys are specific to the AWS Region that they are created in, and you can't use encryption keys from one AWS Region in another AWS Region.

If you copy an unencrypted DB cluster snapshot and specify a value for the KmsKeyId parameter, an error is returned.

", "CopyDBClusterSnapshotMessage$PreSignedUrl": "

The URL that contains a Signature Version 4 signed request for the CopyDBClusterSnapshot API action in the AWS Region that contains the source DB cluster snapshot to copy. The PreSignedUrl parameter must be used when copying an encrypted DB cluster snapshot from another AWS Region.

The pre-signed URL must be a valid request for the CopyDBSClusterSnapshot API action that can be executed in the source AWS Region that contains the encrypted DB cluster snapshot to be copied. The pre-signed URL request must contain the following parameter values:

To learn how to generate a Signature Version 4 signed request, see Authenticating Requests: Using Query Parameters (AWS Signature Version 4) and Signature Version 4 Signing Process.

", "CopyDBParameterGroupMessage$SourceDBParameterGroupIdentifier": "

The identifier or ARN for the source DB parameter group. For information about creating an ARN, see Constructing an ARN for Amazon RDS in the Amazon RDS User Guide.

Constraints:

", - "CopyDBParameterGroupMessage$TargetDBParameterGroupIdentifier": "

The identifier for the copied DB parameter group.

Constraints:

Example: my-db-parameter-group

", + "CopyDBParameterGroupMessage$TargetDBParameterGroupIdentifier": "

The identifier for the copied DB parameter group.

Constraints:

Example: my-db-parameter-group

", "CopyDBParameterGroupMessage$TargetDBParameterGroupDescription": "

A description for the copied DB parameter group.

", "CopyDBSnapshotMessage$SourceDBSnapshotIdentifier": "

The identifier for the source DB snapshot.

If the source snapshot is in the same AWS Region as the copy, specify a valid DB snapshot identifier. For example, you might specify rds:mysql-instance1-snapshot-20130805.

If the source snapshot is in a different AWS Region than the copy, specify a valid DB snapshot ARN. For example, you might specify arn:aws:rds:us-west-2:123456789012:snapshot:mysql-instance1-snapshot-20130805.

If you are copying from a shared manual DB snapshot, this parameter must be the Amazon Resource Name (ARN) of the shared DB snapshot.

If you are copying an encrypted snapshot this parameter must be in the ARN format for the source AWS Region, and must match the SourceDBSnapshotIdentifier in the PreSignedUrl parameter.

Constraints:

Example: rds:mydb-2012-04-02-00-01

Example: arn:aws:rds:us-west-2:123456789012:snapshot:mysql-instance1-snapshot-20130805

", - "CopyDBSnapshotMessage$TargetDBSnapshotIdentifier": "

The identifier for the copy of the snapshot.

Constraints:

Example: my-db-snapshot

", + "CopyDBSnapshotMessage$TargetDBSnapshotIdentifier": "

The identifier for the copy of the snapshot.

Constraints:

Example: my-db-snapshot

", "CopyDBSnapshotMessage$KmsKeyId": "

The AWS KMS key ID for an encrypted DB snapshot. The KMS key ID is the Amazon Resource Name (ARN), KMS key identifier, or the KMS key alias for the KMS encryption key.

If you copy an encrypted DB snapshot from your AWS account, you can specify a value for this parameter to encrypt the copy with a new KMS encryption key. If you don't specify a value for this parameter, then the copy of the DB snapshot is encrypted with the same KMS key as the source DB snapshot.

If you copy an encrypted DB snapshot that is shared from another AWS account, then you must specify a value for this parameter.

If you specify this parameter when you copy an unencrypted snapshot, the copy is encrypted.

If you copy an encrypted snapshot to a different AWS Region, then you must specify a KMS key for the destination AWS Region. KMS encryption keys are specific to the AWS Region that they are created in, and you can't use encryption keys from one AWS Region in another AWS Region.

", "CopyDBSnapshotMessage$PreSignedUrl": "

The URL that contains a Signature Version 4 signed request for the CopyDBSnapshot API action in the source AWS Region that contains the source DB snapshot to copy.

You must specify this parameter when you copy an encrypted DB snapshot from another AWS Region by using the Amazon RDS API. You can specify the --source-region option instead of this parameter when you copy an encrypted DB snapshot from another AWS Region by using the AWS CLI.

The presigned URL must be a valid request for the CopyDBSnapshot API action that can be executed in the source AWS Region that contains the encrypted DB snapshot to be copied. The presigned URL request must contain the following parameter values:

To learn how to generate a Signature Version 4 signed request, see Authenticating Requests: Using Query Parameters (AWS Signature Version 4) and Signature Version 4 Signing Process.

", "CopyDBSnapshotMessage$OptionGroupName": "

The name of an option group to associate with the copy of the snapshot.

Specify this option if you are copying a snapshot from one AWS Region to another, and your DB instance uses a nondefault option group. If your source DB instance uses Transparent Data Encryption for Oracle or Microsoft SQL Server, you must specify this option when copying across AWS Regions. For more information, see Option Group Considerations in the Amazon RDS User Guide.

", "CopyOptionGroupMessage$SourceOptionGroupIdentifier": "

The identifier or ARN for the source option group. For information about creating an ARN, see Constructing an ARN for Amazon RDS in the Amazon RDS User Guide.

Constraints:

", - "CopyOptionGroupMessage$TargetOptionGroupIdentifier": "

The identifier for the copied option group.

Constraints:

Example: my-option-group

", + "CopyOptionGroupMessage$TargetOptionGroupIdentifier": "

The identifier for the copied option group.

Constraints:

Example: my-option-group

", "CopyOptionGroupMessage$TargetOptionGroupDescription": "

The description for the copied option group.

", "CreateDBClusterMessage$CharacterSetName": "

A value that indicates that the DB cluster should be associated with the specified CharacterSet.

", "CreateDBClusterMessage$DatabaseName": "

The name for your database of up to 64 alpha-numeric characters. If you do not provide a name, Amazon RDS will not create a database in the DB cluster you are creating.

", - "CreateDBClusterMessage$DBClusterIdentifier": "

The DB cluster identifier. This parameter is stored as a lowercase string.

Constraints:

Example: my-cluster1

", - "CreateDBClusterMessage$DBClusterParameterGroupName": "

The name of the DB cluster parameter group to associate with this DB cluster. If this argument is omitted, default.aurora5.6 is used.

Constraints:

", + "CreateDBClusterMessage$DBClusterIdentifier": "

The DB cluster identifier. This parameter is stored as a lowercase string.

Constraints:

Example: my-cluster1

", + "CreateDBClusterMessage$DBClusterParameterGroupName": "

The name of the DB cluster parameter group to associate with this DB cluster. If this argument is omitted, default.aurora5.6 is used.

Constraints:

", "CreateDBClusterMessage$DBSubnetGroupName": "

A DB subnet group to associate with this DB cluster.

Constraints: Must match the name of an existing DBSubnetGroup. Must not be default.

Example: mySubnetgroup

", "CreateDBClusterMessage$Engine": "

The name of the database engine to be used for this DB cluster.

Valid Values: aurora (for MySQL 5.6-compatible Aurora), aurora-mysql (for MySQL 5.7-compatible Aurora), and aurora-postgresql

", "CreateDBClusterMessage$EngineVersion": "

The version number of the database engine to use.

Aurora MySQL

Example: 5.6.10a, 5.7.12

Aurora PostgreSQL

Example: 9.6.3

", - "CreateDBClusterMessage$MasterUsername": "

The name of the master user for the DB cluster.

Constraints:

", + "CreateDBClusterMessage$MasterUsername": "

The name of the master user for the DB cluster.

Constraints:

", "CreateDBClusterMessage$MasterUserPassword": "

The password for the master database user. This password can contain any printable ASCII character except \"/\", \"\"\", or \"@\".

Constraints: Must contain from 8 to 41 characters.

", "CreateDBClusterMessage$OptionGroupName": "

A value that indicates that the DB cluster should be associated with the specified option group.

Permanent options can't be removed from an option group. The option group can't be removed from a DB cluster once it is associated with a DB cluster.

", "CreateDBClusterMessage$PreferredBackupWindow": "

The daily time range during which automated backups are created if automated backups are enabled using the BackupRetentionPeriod parameter.

The default is a 30-minute window selected at random from an 8-hour block of time for each AWS Region. To see the time blocks available, see Adjusting the Preferred DB Cluster Maintenance Window in the Amazon Aurora User Guide.

Constraints:

", @@ -2653,21 +2653,21 @@ "CreateDBClusterMessage$KmsKeyId": "

The AWS KMS key identifier for an encrypted DB cluster.

The KMS key identifier is the Amazon Resource Name (ARN) for the KMS encryption key. If you are creating a DB cluster with the same AWS account that owns the KMS encryption key used to encrypt the new DB cluster, then you can use the KMS key alias instead of the ARN for the KMS encryption key.

If an encryption key is not specified in KmsKeyId:

AWS KMS creates the default encryption key for your AWS account. Your AWS account has a different default encryption key for each AWS Region.

If you create a Read Replica of an encrypted DB cluster in another AWS Region, you must set KmsKeyId to a KMS key ID that is valid in the destination AWS Region. This key is used to encrypt the Read Replica in that AWS Region.

", "CreateDBClusterMessage$PreSignedUrl": "

A URL that contains a Signature Version 4 signed request for the CreateDBCluster action to be called in the source AWS Region where the DB cluster is replicated from. You only need to specify PreSignedUrl when you are performing cross-region replication from an encrypted DB cluster.

The pre-signed URL must be a valid request for the CreateDBCluster API action that can be executed in the source AWS Region that contains the encrypted DB cluster to be copied.

The pre-signed URL request must contain the following parameter values:

To learn how to generate a Signature Version 4 signed request, see Authenticating Requests: Using Query Parameters (AWS Signature Version 4) and Signature Version 4 Signing Process.

", "CreateDBClusterMessage$EngineMode": "

The DB engine mode of the DB cluster, either provisioned, serverless, or parallelquery.

", - "CreateDBClusterParameterGroupMessage$DBClusterParameterGroupName": "

The name of the DB cluster parameter group.

Constraints:

This value is stored as a lowercase string.

", + "CreateDBClusterParameterGroupMessage$DBClusterParameterGroupName": "

The name of the DB cluster parameter group.

Constraints:

This value is stored as a lowercase string.

", "CreateDBClusterParameterGroupMessage$DBParameterGroupFamily": "

The DB cluster parameter group family name. A DB cluster parameter group can be associated with one and only one DB cluster parameter group family, and can be applied only to a DB cluster running a database engine and engine version compatible with that DB cluster parameter group family.

Aurora MySQL

Example: aurora5.6, aurora-mysql5.7

Aurora PostgreSQL

Example: aurora-postgresql9.6

", "CreateDBClusterParameterGroupMessage$Description": "

The description for the DB cluster parameter group.

", - "CreateDBClusterSnapshotMessage$DBClusterSnapshotIdentifier": "

The identifier of the DB cluster snapshot. This parameter is stored as a lowercase string.

Constraints:

Example: my-cluster1-snapshot1

", + "CreateDBClusterSnapshotMessage$DBClusterSnapshotIdentifier": "

The identifier of the DB cluster snapshot. This parameter is stored as a lowercase string.

Constraints:

Example: my-cluster1-snapshot1

", "CreateDBClusterSnapshotMessage$DBClusterIdentifier": "

The identifier of the DB cluster to create a snapshot for. This parameter is not case-sensitive.

Constraints:

Example: my-cluster1

", - "CreateDBInstanceMessage$DBName": "

The meaning of this parameter differs according to the database engine you use.

Type: String

MySQL

The name of the database to create when the DB instance is created. If this parameter is not specified, no database is created in the DB instance.

Constraints:

MariaDB

The name of the database to create when the DB instance is created. If this parameter is not specified, no database is created in the DB instance.

Constraints:

PostgreSQL

The name of the database to create when the DB instance is created. If this parameter is not specified, the default \"postgres\" database is created in the DB instance.

Constraints:

Oracle

The Oracle System ID (SID) of the created DB instance. If you specify null, the default value ORCL is used. You can't specify the string NULL, or any other reserved word, for DBName.

Default: ORCL

Constraints:

SQL Server

Not applicable. Must be null.

Amazon Aurora

The name of the database to create when the primary instance of the DB cluster is created. If this parameter is not specified, no database is created in the DB instance.

Constraints:

", - "CreateDBInstanceMessage$DBInstanceIdentifier": "

The DB instance identifier. This parameter is stored as a lowercase string.

Constraints:

Example: mydbinstance

", + "CreateDBInstanceMessage$DBName": "

The meaning of this parameter differs according to the database engine you use.

Type: String

MySQL

The name of the database to create when the DB instance is created. If this parameter is not specified, no database is created in the DB instance.

Constraints:

MariaDB

The name of the database to create when the DB instance is created. If this parameter is not specified, no database is created in the DB instance.

Constraints:

PostgreSQL

The name of the database to create when the DB instance is created. If this parameter is not specified, the default \"postgres\" database is created in the DB instance.

Constraints:

Oracle

The Oracle System ID (SID) of the created DB instance. If you specify null, the default value ORCL is used. You can't specify the string NULL, or any other reserved word, for DBName.

Default: ORCL

Constraints:

SQL Server

Not applicable. Must be null.

Amazon Aurora

The name of the database to create when the primary instance of the DB cluster is created. If this parameter is not specified, no database is created in the DB instance.

Constraints:

", + "CreateDBInstanceMessage$DBInstanceIdentifier": "

The DB instance identifier. This parameter is stored as a lowercase string.

Constraints:

Example: mydbinstance

", "CreateDBInstanceMessage$DBInstanceClass": "

The compute and memory capacity of the DB instance, for example, db.m4.large. Not all DB instance classes are available in all AWS Regions, or for all database engines. For the full list of DB instance classes, and availability for your engine, see DB Instance Class in the Amazon RDS User Guide.

", "CreateDBInstanceMessage$Engine": "

The name of the database engine to be used for this instance.

Not every database engine is available for every AWS Region.

Valid Values:

", - "CreateDBInstanceMessage$MasterUsername": "

The name for the master user.

Amazon Aurora

Not applicable. The name for the master user is managed by the DB cluster. For more information, see CreateDBCluster.

MariaDB

Constraints:

Microsoft SQL Server

Constraints:

MySQL

Constraints:

Oracle

Constraints:

PostgreSQL

Constraints:

", + "CreateDBInstanceMessage$MasterUsername": "

The name for the master user.

Amazon Aurora

Not applicable. The name for the master user is managed by the DB cluster. For more information, see CreateDBCluster.

MariaDB

Constraints:

Microsoft SQL Server

Constraints:

MySQL

Constraints:

Oracle

Constraints:

PostgreSQL

Constraints:

", "CreateDBInstanceMessage$MasterUserPassword": "

The password for the master user. The password can include any printable ASCII character except \"/\", \"\"\", or \"@\".

Amazon Aurora

Not applicable. The password for the master user is managed by the DB cluster. For more information, see CreateDBCluster.

MariaDB

Constraints: Must contain from 8 to 41 characters.

Microsoft SQL Server

Constraints: Must contain from 8 to 128 characters.

MySQL

Constraints: Must contain from 8 to 41 characters.

Oracle

Constraints: Must contain from 8 to 30 characters.

PostgreSQL

Constraints: Must contain from 8 to 128 characters.

", "CreateDBInstanceMessage$AvailabilityZone": "

The EC2 Availability Zone that the DB instance is created in. For information on AWS Regions and Availability Zones, see Regions and Availability Zones.

Default: A random, system-chosen Availability Zone in the endpoint's AWS Region.

Example: us-east-1d

Constraint: The AvailabilityZone parameter can't be specified if the MultiAZ parameter is set to true. The specified Availability Zone must be in the same AWS Region as the current endpoint.

", "CreateDBInstanceMessage$DBSubnetGroupName": "

A DB subnet group to associate with this DB instance.

If there is no DB subnet group, then it is a non-VPC DB instance.

", "CreateDBInstanceMessage$PreferredMaintenanceWindow": "

The time range each week during which system maintenance can occur, in Universal Coordinated Time (UTC). For more information, see Amazon RDS Maintenance Window.

Format: ddd:hh24:mi-ddd:hh24:mi

The default is a 30-minute window selected at random from an 8-hour block of time for each AWS Region, occurring on a random day of the week.

Valid Days: Mon, Tue, Wed, Thu, Fri, Sat, Sun.

Constraints: Minimum 30-minute window.

", - "CreateDBInstanceMessage$DBParameterGroupName": "

The name of the DB parameter group to associate with this DB instance. If this argument is omitted, the default DBParameterGroup for the specified engine is used.

Constraints:

", + "CreateDBInstanceMessage$DBParameterGroupName": "

The name of the DB parameter group to associate with this DB instance. If this argument is omitted, the default DBParameterGroup for the specified engine is used.

Constraints:

", "CreateDBInstanceMessage$PreferredBackupWindow": "

The daily time range during which automated backups are created if automated backups are enabled, using the BackupRetentionPeriod parameter. For more information, see The Backup Window in the Amazon RDS User Guide.

Amazon Aurora

Not applicable. The daily time range for creating automated backups is managed by the DB cluster. For more information, see CreateDBCluster.

The default is a 30-minute window selected at random from an 8-hour block of time for each AWS Region. To see the time blocks available, see Adjusting the Preferred DB Instance Maintenance Window in the Amazon RDS User Guide.

Constraints:

", "CreateDBInstanceMessage$EngineVersion": "

The version number of the database engine to use.

For a list of valid engine versions, call DescribeDBEngineVersions.

The following are the database engines and links to information about the major and minor versions that are available with Amazon RDS. Not every database engine is available for every AWS Region.

Amazon Aurora

Not applicable. The version number of the database engine to be used by the DB instance is managed by the DB cluster. For more information, see CreateDBCluster.

MariaDB

See MariaDB on Amazon RDS Versions in the Amazon RDS User Guide.

Microsoft SQL Server

See Version and Feature Support on Amazon RDS in the Amazon RDS User Guide.

MySQL

See MySQL on Amazon RDS Versions in the Amazon RDS User Guide.

Oracle

See Oracle Database Engine Release Notes in the Amazon RDS User Guide.

PostgreSQL

See Supported PostgreSQL Database Versions in the Amazon RDS User Guide.

", "CreateDBInstanceMessage$LicenseModel": "

License model information for this DB instance.

Valid values: license-included | bring-your-own-license | general-public-license

", @@ -2694,19 +2694,19 @@ "CreateDBInstanceReadReplicaMessage$KmsKeyId": "

The AWS KMS key ID for an encrypted Read Replica. The KMS key ID is the Amazon Resource Name (ARN), KMS key identifier, or the KMS key alias for the KMS encryption key.

If you specify this parameter when you create a Read Replica from an unencrypted DB instance, the Read Replica is encrypted.

If you create an encrypted Read Replica in the same AWS Region as the source DB instance, then you do not have to specify a value for this parameter. The Read Replica is encrypted with the same KMS key as the source DB instance.

If you create an encrypted Read Replica in a different AWS Region, then you must specify a KMS key for the destination AWS Region. KMS encryption keys are specific to the AWS Region that they are created in, and you can't use encryption keys from one AWS Region in another AWS Region.

", "CreateDBInstanceReadReplicaMessage$PreSignedUrl": "

The URL that contains a Signature Version 4 signed request for the CreateDBInstanceReadReplica API action in the source AWS Region that contains the source DB instance.

You must specify this parameter when you create an encrypted Read Replica from another AWS Region by using the Amazon RDS API. You can specify the --source-region option instead of this parameter when you create an encrypted Read Replica from another AWS Region by using the AWS CLI.

The presigned URL must be a valid request for the CreateDBInstanceReadReplica API action that can be executed in the source AWS Region that contains the encrypted source DB instance. The presigned URL request must contain the following parameter values:

To learn how to generate a Signature Version 4 signed request, see Authenticating Requests: Using Query Parameters (AWS Signature Version 4) and Signature Version 4 Signing Process.

", "CreateDBInstanceReadReplicaMessage$PerformanceInsightsKMSKeyId": "

The AWS KMS key identifier for encryption of Performance Insights data. The KMS key ID is the Amazon Resource Name (ARN), KMS key identifier, or the KMS key alias for the KMS encryption key.

", - "CreateDBParameterGroupMessage$DBParameterGroupName": "

The name of the DB parameter group.

Constraints:

This value is stored as a lowercase string.

", + "CreateDBParameterGroupMessage$DBParameterGroupName": "

The name of the DB parameter group.

Constraints:

This value is stored as a lowercase string.

", "CreateDBParameterGroupMessage$DBParameterGroupFamily": "

The DB parameter group family name. A DB parameter group can be associated with one and only one DB parameter group family, and can be applied only to a DB instance running a database engine and engine version compatible with that DB parameter group family.

To list all of the available parameter group families, use the following command:

aws rds describe-db-engine-versions --query \"DBEngineVersions[].DBParameterGroupFamily\"

The output contains duplicates.

", "CreateDBParameterGroupMessage$Description": "

The description for the DB parameter group.

", - "CreateDBSecurityGroupMessage$DBSecurityGroupName": "

The name for the DB security group. This value is stored as a lowercase string.

Constraints:

Example: mysecuritygroup

", + "CreateDBSecurityGroupMessage$DBSecurityGroupName": "

The name for the DB security group. This value is stored as a lowercase string.

Constraints:

Example: mysecuritygroup

", "CreateDBSecurityGroupMessage$DBSecurityGroupDescription": "

The description for the DB security group.

", - "CreateDBSnapshotMessage$DBSnapshotIdentifier": "

The identifier for the DB snapshot.

Constraints:

Example: my-snapshot-id

", + "CreateDBSnapshotMessage$DBSnapshotIdentifier": "

The identifier for the DB snapshot.

Constraints:

Example: my-snapshot-id

", "CreateDBSnapshotMessage$DBInstanceIdentifier": "

The identifier of the DB instance that you want to create the snapshot of.

Constraints:

", "CreateDBSubnetGroupMessage$DBSubnetGroupName": "

The name for the DB subnet group. This value is stored as a lowercase string.

Constraints: Must contain no more than 255 letters, numbers, periods, underscores, spaces, or hyphens. Must not be default.

Example: mySubnetgroup

", "CreateDBSubnetGroupMessage$DBSubnetGroupDescription": "

The description for the DB subnet group.

", "CreateEventSubscriptionMessage$SubscriptionName": "

The name of the subscription.

Constraints: The name must be less than 255 characters.

", "CreateEventSubscriptionMessage$SnsTopicArn": "

The Amazon Resource Name (ARN) of the SNS topic created for event notification. The ARN is created by Amazon SNS when you create a topic and subscribe to it.

", "CreateEventSubscriptionMessage$SourceType": "

The type of source that is generating the events. For example, if you want to be notified of events generated by a DB instance, you would set this parameter to db-instance. if this value is not specified, all events are returned.

Valid values: db-instance | db-cluster | db-parameter-group | db-security-group | db-snapshot | db-cluster-snapshot

", - "CreateOptionGroupMessage$OptionGroupName": "

Specifies the name of the option group to be created.

Constraints:

Example: myoptiongroup

", + "CreateOptionGroupMessage$OptionGroupName": "

Specifies the name of the option group to be created.

Constraints:

Example: myoptiongroup

", "CreateOptionGroupMessage$EngineName": "

Specifies the name of the engine that this option group should be associated with.

", "CreateOptionGroupMessage$MajorEngineVersion": "

Specifies the major version of the engine that this option group should be associated with.

", "CreateOptionGroupMessage$OptionGroupDescription": "

The description of the option group.

", @@ -2747,7 +2747,7 @@ "DBClusterParameterGroup$Description": "

Provides the customer-specified description for this DB cluster parameter group.

", "DBClusterParameterGroup$DBClusterParameterGroupArn": "

The Amazon Resource Name (ARN) for the DB cluster parameter group.

", "DBClusterParameterGroupDetails$Marker": "

An optional pagination token provided by a previous DescribeDBClusterParameters request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords .

", - "DBClusterParameterGroupNameMessage$DBClusterParameterGroupName": "

The name of the DB cluster parameter group.

Constraints:

This value is stored as a lowercase string.

", + "DBClusterParameterGroupNameMessage$DBClusterParameterGroupName": "

The name of the DB cluster parameter group.

Constraints:

This value is stored as a lowercase string.

", "DBClusterParameterGroupsMessage$Marker": "

An optional pagination token provided by a previous DescribeDBClusterParameterGroups request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.

", "DBClusterRole$RoleArn": "

The Amazon Resource Name (ARN) of the IAM role that is associated with the DB cluster.

", "DBClusterRole$Status": "

Describes the state of association between the IAM role and the DB cluster. The Status property returns one of the following values:

", @@ -2848,20 +2848,20 @@ "DBSubnetGroup$DBSubnetGroupArn": "

The Amazon Resource Name (ARN) for the DB subnet group.

", "DBSubnetGroupMessage$Marker": "

An optional pagination token provided by a previous request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.

", "DeleteDBClusterMessage$DBClusterIdentifier": "

The DB cluster identifier for the DB cluster to be deleted. This parameter isn't case-sensitive.

Constraints:

", - "DeleteDBClusterMessage$FinalDBSnapshotIdentifier": "

The DB cluster snapshot identifier of the new DB cluster snapshot created when SkipFinalSnapshot is set to false.

Specifying this parameter and also setting the SkipFinalShapshot parameter to true results in an error.

Constraints:

", - "DeleteDBClusterParameterGroupMessage$DBClusterParameterGroupName": "

The name of the DB cluster parameter group.

Constraints:

", + "DeleteDBClusterMessage$FinalDBSnapshotIdentifier": "

The DB cluster snapshot identifier of the new DB cluster snapshot created when SkipFinalSnapshot is set to false.

Specifying this parameter and also setting the SkipFinalShapshot parameter to true results in an error.

Constraints:

", + "DeleteDBClusterParameterGroupMessage$DBClusterParameterGroupName": "

The name of the DB cluster parameter group.

Constraints:

", "DeleteDBClusterSnapshotMessage$DBClusterSnapshotIdentifier": "

The identifier of the DB cluster snapshot to delete.

Constraints: Must be the name of an existing DB cluster snapshot in the available state.

", "DeleteDBInstanceMessage$DBInstanceIdentifier": "

The DB instance identifier for the DB instance to be deleted. This parameter isn't case-sensitive.

Constraints:

", - "DeleteDBInstanceMessage$FinalDBSnapshotIdentifier": "

The DBSnapshotIdentifier of the new DBSnapshot created when SkipFinalSnapshot is set to false.

Specifying this parameter and also setting the SkipFinalShapshot parameter to true results in an error.

Constraints:

", - "DeleteDBParameterGroupMessage$DBParameterGroupName": "

The name of the DB parameter group.

Constraints:

", - "DeleteDBSecurityGroupMessage$DBSecurityGroupName": "

The name of the DB security group to delete.

You can't delete the default DB security group.

Constraints:

", + "DeleteDBInstanceMessage$FinalDBSnapshotIdentifier": "

The DBSnapshotIdentifier of the new DBSnapshot created when SkipFinalSnapshot is set to false.

Specifying this parameter and also setting the SkipFinalShapshot parameter to true results in an error.

Constraints:

", + "DeleteDBParameterGroupMessage$DBParameterGroupName": "

The name of the DB parameter group.

Constraints:

", + "DeleteDBSecurityGroupMessage$DBSecurityGroupName": "

The name of the DB security group to delete.

You can't delete the default DB security group.

Constraints:

", "DeleteDBSnapshotMessage$DBSnapshotIdentifier": "

The DBSnapshot identifier.

Constraints: Must be the name of an existing DB snapshot in the available state.

", "DeleteDBSubnetGroupMessage$DBSubnetGroupName": "

The name of the database subnet group to delete.

You can't delete the default subnet group.

Constraints:

Constraints: Must match the name of an existing DBSubnetGroup. Must not be default.

Example: mySubnetgroup

", "DeleteEventSubscriptionMessage$SubscriptionName": "

The name of the RDS event notification subscription you want to delete.

", "DeleteOptionGroupMessage$OptionGroupName": "

The name of the option group to be deleted.

You can't delete default option groups.

", "DescribeCertificatesMessage$CertificateIdentifier": "

The user-supplied certificate identifier. If this parameter is specified, information for only the identified certificate is returned. This parameter isn't case-sensitive.

Constraints:

", "DescribeCertificatesMessage$Marker": "

An optional pagination token provided by a previous DescribeCertificates request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.

", - "DescribeDBClusterBacktracksMessage$DBClusterIdentifier": "

The DB cluster identifier of the DB cluster to be described. This parameter is stored as a lowercase string.

Constraints:

Example: my-cluster1

", + "DescribeDBClusterBacktracksMessage$DBClusterIdentifier": "

The DB cluster identifier of the DB cluster to be described. This parameter is stored as a lowercase string.

Constraints:

Example: my-cluster1

", "DescribeDBClusterBacktracksMessage$BacktrackIdentifier": "

If specified, this value is the backtrack identifier of the backtrack to be described.

Constraints:

Example: 123e4567-e89b-12d3-a456-426655440000

", "DescribeDBClusterBacktracksMessage$Marker": "

An optional pagination token provided by a previous DescribeDBClusterBacktracks request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.

", "DescribeDBClusterParameterGroupsMessage$DBClusterParameterGroupName": "

The name of a specific DB cluster parameter group to return details for.

Constraints:

", @@ -2908,12 +2908,12 @@ "DescribeEventCategoriesMessage$SourceType": "

The type of source that is generating the events.

Valid values: db-instance | db-parameter-group | db-security-group | db-snapshot

", "DescribeEventSubscriptionsMessage$SubscriptionName": "

The name of the RDS event notification subscription you want to describe.

", "DescribeEventSubscriptionsMessage$Marker": "

An optional pagination token provided by a previous DescribeOrderableDBInstanceOptions request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords .

", - "DescribeEventsMessage$SourceIdentifier": "

The identifier of the event source for which events are returned. If not specified, then all sources are included in the response.

Constraints:

", + "DescribeEventsMessage$SourceIdentifier": "

The identifier of the event source for which events are returned. If not specified, then all sources are included in the response.

Constraints:

", "DescribeEventsMessage$Marker": "

An optional pagination token provided by a previous DescribeEvents request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.

", "DescribeOptionGroupOptionsMessage$EngineName": "

A required parameter. Options available for the given engine name are described.

", "DescribeOptionGroupOptionsMessage$MajorEngineVersion": "

If specified, filters the results to include only options for the specified major engine version.

", "DescribeOptionGroupOptionsMessage$Marker": "

An optional pagination token provided by a previous request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.

", - "DescribeOptionGroupsMessage$OptionGroupName": "

The name of the option group to describe. Cannot be supplied together with EngineName or MajorEngineVersion.

", + "DescribeOptionGroupsMessage$OptionGroupName": "

The name of the option group to describe. Can't be supplied together with EngineName or MajorEngineVersion.

", "DescribeOptionGroupsMessage$Marker": "

An optional pagination token provided by a previous DescribeOptionGroups request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.

", "DescribeOptionGroupsMessage$EngineName": "

Filters the list of option groups to only include groups associated with a specific database engine.

", "DescribeOptionGroupsMessage$MajorEngineVersion": "

Filters the list of option groups to only include groups associated with a specific database engine version. If specified, then EngineName must also be specified.

", @@ -2986,7 +2986,7 @@ "ModifyCurrentDBClusterCapacityMessage$DBClusterIdentifier": "

The DB cluster identifier for the cluster being modified. This parameter is not case-sensitive.

Constraints:

", "ModifyCurrentDBClusterCapacityMessage$TimeoutAction": "

The action to take when the timeout is reached, either ForceApplyCapacityChange or RollbackCapacityChange.

ForceApplyCapacityChange, the default, sets the capacity to the specified value as soon as possible.

RollbackCapacityChange ignores the capacity change if a scaling point is not found in the timeout period.

", "ModifyDBClusterMessage$DBClusterIdentifier": "

The DB cluster identifier for the cluster being modified. This parameter is not case-sensitive.

Constraints:

", - "ModifyDBClusterMessage$NewDBClusterIdentifier": "

The new DB cluster identifier for the DB cluster when renaming a DB cluster. This value is stored as a lowercase string.

Constraints:

Example: my-cluster2

", + "ModifyDBClusterMessage$NewDBClusterIdentifier": "

The new DB cluster identifier for the DB cluster when renaming a DB cluster. This value is stored as a lowercase string.

Constraints:

Example: my-cluster2

", "ModifyDBClusterMessage$DBClusterParameterGroupName": "

The name of the DB cluster parameter group to use for the DB cluster.

", "ModifyDBClusterMessage$MasterUserPassword": "

The new password for the master database user. This password can contain any printable ASCII character except \"/\", \"\"\", or \"@\".

Constraints: Must contain from 8 to 41 characters.

", "ModifyDBClusterMessage$OptionGroupName": "

A value that indicates that the DB cluster should be associated with the specified option group. Changing this parameter doesn't result in an outage except in the following case, and the change is applied during the next maintenance window unless the ApplyImmediately parameter is set to true for this request. If the parameter change results in an option group that enables OEM, this change can cause a brief (sub-second) period during which new connections are rejected but existing connections are not interrupted.

Permanent options can't be removed from an option group. The option group can't be removed from a DB cluster once it is associated with a DB cluster.

", @@ -3006,7 +3006,7 @@ "ModifyDBInstanceMessage$EngineVersion": "

The version number of the database engine to upgrade to. Changing this parameter results in an outage and the change is applied during the next maintenance window unless the ApplyImmediately parameter is set to true for this request.

For major version upgrades, if a nondefault DB parameter group is currently in use, a new DB parameter group in the DB parameter group family for the new engine version must be specified. The new DB parameter group can be the default for that DB parameter group family.

For information about valid engine versions, see CreateDBInstance, or call DescribeDBEngineVersions.

", "ModifyDBInstanceMessage$LicenseModel": "

The license model for the DB instance.

Valid values: license-included | bring-your-own-license | general-public-license

", "ModifyDBInstanceMessage$OptionGroupName": "

Indicates that the DB instance should be associated with the specified option group. Changing this parameter doesn't result in an outage except in the following case and the change is applied during the next maintenance window unless the ApplyImmediately parameter is set to true for this request. If the parameter change results in an option group that enables OEM, this change can cause a brief (sub-second) period during which new connections are rejected but existing connections are not interrupted.

Permanent options, such as the TDE option for Oracle Advanced Security TDE, can't be removed from an option group, and that option group can't be removed from a DB instance once it is associated with a DB instance

", - "ModifyDBInstanceMessage$NewDBInstanceIdentifier": "

The new DB instance identifier for the DB instance when renaming a DB instance. When you change the DB instance identifier, an instance reboot will occur immediately if you set Apply Immediately to true, or will occur during the next maintenance window if Apply Immediately to false. This value is stored as a lowercase string.

Constraints:

Example: mydbinstance

", + "ModifyDBInstanceMessage$NewDBInstanceIdentifier": "

The new DB instance identifier for the DB instance when renaming a DB instance. When you change the DB instance identifier, an instance reboot will occur immediately if you set Apply Immediately to true, or will occur during the next maintenance window if Apply Immediately to false. This value is stored as a lowercase string.

Constraints:

Example: mydbinstance

", "ModifyDBInstanceMessage$StorageType": "

Specifies the storage type to be associated with the DB instance.

If you specify Provisioned IOPS (io1), you must also include a value for the Iops parameter.

If you choose to migrate your DB instance from using standard storage to using Provisioned IOPS, or from using Provisioned IOPS to using standard storage, the process can take time. The duration of the migration depends on several factors such as database load, storage size, storage type (standard or Provisioned IOPS), amount of IOPS provisioned (if any), and the number of prior scale storage operations. Typical migration times are under 24 hours, but the process can take up to several days in some cases. During the migration, the DB instance is available for use, but might experience performance degradation. While the migration takes place, nightly backups for the instance are suspended. No other Amazon RDS operations can take place for the instance, including modifying the instance, rebooting the instance, deleting the instance, creating a Read Replica for the instance, and creating a DB snapshot of the instance.

Valid values: standard | gp2 | io1

Default: io1 if the Iops parameter is specified, otherwise standard

", "ModifyDBInstanceMessage$TdeCredentialArn": "

The ARN from the key store with which to associate the instance for TDE encryption.

", "ModifyDBInstanceMessage$TdeCredentialPassword": "

The password for the given ARN from the key store in order to access the device.

", @@ -3126,12 +3126,12 @@ "ResourcePendingMaintenanceActions$ResourceIdentifier": "

The ARN of the resource that has pending maintenance actions.

", "RestoreDBClusterFromS3Message$CharacterSetName": "

A value that indicates that the restored DB cluster should be associated with the specified CharacterSet.

", "RestoreDBClusterFromS3Message$DatabaseName": "

The database name for the restored DB cluster.

", - "RestoreDBClusterFromS3Message$DBClusterIdentifier": "

The name of the DB cluster to create from the source data in the Amazon S3 bucket. This parameter is isn't case-sensitive.

Constraints:

Example: my-cluster1

", + "RestoreDBClusterFromS3Message$DBClusterIdentifier": "

The name of the DB cluster to create from the source data in the Amazon S3 bucket. This parameter is isn't case-sensitive.

Constraints:

Example: my-cluster1

", "RestoreDBClusterFromS3Message$DBClusterParameterGroupName": "

The name of the DB cluster parameter group to associate with the restored DB cluster. If this argument is omitted, default.aurora5.6 is used.

Constraints:

", "RestoreDBClusterFromS3Message$DBSubnetGroupName": "

A DB subnet group to associate with the restored DB cluster.

Constraints: If supplied, must match the name of an existing DBSubnetGroup.

Example: mySubnetgroup

", "RestoreDBClusterFromS3Message$Engine": "

The name of the database engine to be used for the restored DB cluster.

Valid Values: aurora, aurora-postgresql

", "RestoreDBClusterFromS3Message$EngineVersion": "

The version number of the database engine to use.

Aurora MySQL

Example: 5.6.10a

Aurora PostgreSQL

Example: 9.6.3

", - "RestoreDBClusterFromS3Message$MasterUsername": "

The name of the master user for the restored DB cluster.

Constraints:

", + "RestoreDBClusterFromS3Message$MasterUsername": "

The name of the master user for the restored DB cluster.

Constraints:

", "RestoreDBClusterFromS3Message$MasterUserPassword": "

The password for the master database user. This password can contain any printable ASCII character except \"/\", \"\"\", or \"@\".

Constraints: Must contain from 8 to 41 characters.

", "RestoreDBClusterFromS3Message$OptionGroupName": "

A value that indicates that the restored DB cluster should be associated with the specified option group.

Permanent options can't be removed from an option group. An option group can't be removed from a DB cluster once it is associated with a DB cluster.

", "RestoreDBClusterFromS3Message$PreferredBackupWindow": "

The daily time range during which automated backups are created if automated backups are enabled using the BackupRetentionPeriod parameter.

The default is a 30-minute window selected at random from an 8-hour block of time for each AWS Region. To see the time blocks available, see Adjusting the Preferred Maintenance Window in the Amazon Aurora User Guide.

Constraints:

", @@ -3142,22 +3142,24 @@ "RestoreDBClusterFromS3Message$S3BucketName": "

The name of the Amazon S3 bucket that contains the data used to create the Amazon Aurora DB cluster.

", "RestoreDBClusterFromS3Message$S3Prefix": "

The prefix for all of the file names that contain the data used to create the Amazon Aurora DB cluster. If you do not specify a SourceS3Prefix value, then the Amazon Aurora DB cluster is created by using all of the files in the Amazon S3 bucket.

", "RestoreDBClusterFromS3Message$S3IngestionRoleArn": "

The Amazon Resource Name (ARN) of the AWS Identity and Access Management (IAM) role that authorizes Amazon RDS to access the Amazon S3 bucket on your behalf.

", - "RestoreDBClusterFromSnapshotMessage$DBClusterIdentifier": "

The name of the DB cluster to create from the DB snapshot or DB cluster snapshot. This parameter isn't case-sensitive.

Constraints:

Example: my-snapshot-id

", + "RestoreDBClusterFromSnapshotMessage$DBClusterIdentifier": "

The name of the DB cluster to create from the DB snapshot or DB cluster snapshot. This parameter isn't case-sensitive.

Constraints:

Example: my-snapshot-id

", "RestoreDBClusterFromSnapshotMessage$SnapshotIdentifier": "

The identifier for the DB snapshot or DB cluster snapshot to restore from.

You can use either the name or the Amazon Resource Name (ARN) to specify a DB cluster snapshot. However, you can use only the ARN to specify a DB snapshot.

Constraints:

", "RestoreDBClusterFromSnapshotMessage$Engine": "

The database engine to use for the new DB cluster.

Default: The same as source

Constraint: Must be compatible with the engine of the source

", "RestoreDBClusterFromSnapshotMessage$EngineVersion": "

The version of the database engine to use for the new DB cluster.

", - "RestoreDBClusterFromSnapshotMessage$DBSubnetGroupName": "

The name of the DB subnet group to use for the new DB cluster.

Constraints: If supplied, must match the name of an existing DBSubnetGroup.

Example: mySubnetgroup

", + "RestoreDBClusterFromSnapshotMessage$DBSubnetGroupName": "

The name of the DB subnet group to use for the new DB cluster.

Constraints: If supplied, must match the name of an existing DB subnet group.

Example: mySubnetgroup

", "RestoreDBClusterFromSnapshotMessage$DatabaseName": "

The database name for the restored DB cluster.

", "RestoreDBClusterFromSnapshotMessage$OptionGroupName": "

The name of the option group to use for the restored DB cluster.

", - "RestoreDBClusterFromSnapshotMessage$KmsKeyId": "

The AWS KMS key identifier to use when restoring an encrypted DB cluster from a DB snapshot or DB cluster snapshot.

The KMS key identifier is the Amazon Resource Name (ARN) for the KMS encryption key. If you are restoring a DB cluster with the same AWS account that owns the KMS encryption key used to encrypt the new DB cluster, then you can use the KMS key alias instead of the ARN for the KMS encryption key.

If you do not specify a value for the KmsKeyId parameter, then the following will occur:

", + "RestoreDBClusterFromSnapshotMessage$KmsKeyId": "

The AWS KMS key identifier to use when restoring an encrypted DB cluster from a DB snapshot or DB cluster snapshot.

The KMS key identifier is the Amazon Resource Name (ARN) for the KMS encryption key. If you are restoring a DB cluster with the same AWS account that owns the KMS encryption key used to encrypt the new DB cluster, then you can use the KMS key alias instead of the ARN for the KMS encryption key.

If you don't specify a value for the KmsKeyId parameter, then the following occurs:

", "RestoreDBClusterFromSnapshotMessage$EngineMode": "

The DB engine mode of the DB cluster, either provisioned, serverless, or parallelquery.

", - "RestoreDBClusterToPointInTimeMessage$DBClusterIdentifier": "

The name of the new DB cluster to be created.

Constraints:

", + "RestoreDBClusterFromSnapshotMessage$DBClusterParameterGroupName": "

The name of the DB cluster parameter group to associate with this DB cluster. If this argument is omitted, the default DB cluster parameter group for the specified engine is used.

Constraints:

", + "RestoreDBClusterToPointInTimeMessage$DBClusterIdentifier": "

The name of the new DB cluster to be created.

Constraints:

", "RestoreDBClusterToPointInTimeMessage$RestoreType": "

The type of restore to be performed. You can specify one of the following values:

Constraints: You can't specify copy-on-write if the engine version of the source DB cluster is earlier than 1.11.

If you don't specify a RestoreType value, then the new DB cluster is restored as a full copy of the source DB cluster.

", "RestoreDBClusterToPointInTimeMessage$SourceDBClusterIdentifier": "

The identifier of the source DB cluster from which to restore.

Constraints:

", "RestoreDBClusterToPointInTimeMessage$DBSubnetGroupName": "

The DB subnet group name to use for the new DB cluster.

Constraints: If supplied, must match the name of an existing DBSubnetGroup.

Example: mySubnetgroup

", "RestoreDBClusterToPointInTimeMessage$OptionGroupName": "

The name of the option group for the new DB cluster.

", - "RestoreDBClusterToPointInTimeMessage$KmsKeyId": "

The AWS KMS key identifier to use when restoring an encrypted DB cluster from an encrypted DB cluster.

The KMS key identifier is the Amazon Resource Name (ARN) for the KMS encryption key. If you are restoring a DB cluster with the same AWS account that owns the KMS encryption key used to encrypt the new DB cluster, then you can use the KMS key alias instead of the ARN for the KMS encryption key.

You can restore to a new DB cluster and encrypt the new DB cluster with a KMS key that is different than the KMS key used to encrypt the source DB cluster. The new DB cluster is encrypted with the KMS key identified by the KmsKeyId parameter.

If you do not specify a value for the KmsKeyId parameter, then the following will occur:

If DBClusterIdentifier refers to a DB cluster that is not encrypted, then the restore request is rejected.

", - "RestoreDBInstanceFromDBSnapshotMessage$DBInstanceIdentifier": "

Name of the DB instance to create from the DB snapshot. This parameter isn't case-sensitive.

Constraints:

Example: my-snapshot-id

", + "RestoreDBClusterToPointInTimeMessage$KmsKeyId": "

The AWS KMS key identifier to use when restoring an encrypted DB cluster from an encrypted DB cluster.

The KMS key identifier is the Amazon Resource Name (ARN) for the KMS encryption key. If you are restoring a DB cluster with the same AWS account that owns the KMS encryption key used to encrypt the new DB cluster, then you can use the KMS key alias instead of the ARN for the KMS encryption key.

You can restore to a new DB cluster and encrypt the new DB cluster with a KMS key that is different than the KMS key used to encrypt the source DB cluster. The new DB cluster is encrypted with the KMS key identified by the KmsKeyId parameter.

If you don't specify a value for the KmsKeyId parameter, then the following occurs:

If DBClusterIdentifier refers to a DB cluster that is not encrypted, then the restore request is rejected.

", + "RestoreDBClusterToPointInTimeMessage$DBClusterParameterGroupName": "

The name of the DB cluster parameter group to associate with this DB cluster. If this argument is omitted, the default DB cluster parameter group for the specified engine is used.

Constraints:

", + "RestoreDBInstanceFromDBSnapshotMessage$DBInstanceIdentifier": "

Name of the DB instance to create from the DB snapshot. This parameter isn't case-sensitive.

Constraints:

Example: my-snapshot-id

", "RestoreDBInstanceFromDBSnapshotMessage$DBSnapshotIdentifier": "

The identifier for the DB snapshot to restore from.

Constraints:

", "RestoreDBInstanceFromDBSnapshotMessage$DBInstanceClass": "

The compute and memory capacity of the Amazon RDS DB instance, for example, db.m4.large. Not all DB instance classes are available in all AWS Regions, or for all database engines. For the full list of DB instance classes, and availability for your engine, see DB Instance Class in the Amazon RDS User Guide.

Default: The same DBInstanceClass as the original DB instance.

", "RestoreDBInstanceFromDBSnapshotMessage$AvailabilityZone": "

The EC2 Availability Zone that the DB instance is created in.

Default: A random, system-chosen Availability Zone.

Constraint: You can't specify the AvailabilityZone parameter if the MultiAZ parameter is set to true.

Example: us-east-1a

", @@ -3171,11 +3173,12 @@ "RestoreDBInstanceFromDBSnapshotMessage$TdeCredentialPassword": "

The password for the given ARN from the key store in order to access the device.

", "RestoreDBInstanceFromDBSnapshotMessage$Domain": "

Specify the Active Directory Domain to restore the instance in.

", "RestoreDBInstanceFromDBSnapshotMessage$DomainIAMRoleName": "

Specify the name of the IAM role to be used when making API calls to the Directory Service.

", + "RestoreDBInstanceFromDBSnapshotMessage$DBParameterGroupName": "

The name of the DB parameter group to associate with this DB instance. If this argument is omitted, the default DBParameterGroup for the specified engine is used.

Constraints:

", "RestoreDBInstanceFromS3Message$DBName": "

The name of the database to create when the DB instance is created. Follow the naming rules specified in CreateDBInstance.

", - "RestoreDBInstanceFromS3Message$DBInstanceIdentifier": "

The DB instance identifier. This parameter is stored as a lowercase string.

Constraints:

Example: mydbinstance

", + "RestoreDBInstanceFromS3Message$DBInstanceIdentifier": "

The DB instance identifier. This parameter is stored as a lowercase string.

Constraints:

Example: mydbinstance

", "RestoreDBInstanceFromS3Message$DBInstanceClass": "

The compute and memory capacity of the DB instance, for example, db.m4.large. Not all DB instance classes are available in all AWS Regions, or for all database engines. For the full list of DB instance classes, and availability for your engine, see DB Instance Class in the Amazon RDS User Guide.

Importing from Amazon S3 is not supported on the db.t2.micro DB instance class.

", "RestoreDBInstanceFromS3Message$Engine": "

The name of the database engine to be used for this instance.

Valid Values: mysql

", - "RestoreDBInstanceFromS3Message$MasterUsername": "

The name for the master user.

Constraints:

", + "RestoreDBInstanceFromS3Message$MasterUsername": "

The name for the master user.

Constraints:

", "RestoreDBInstanceFromS3Message$MasterUserPassword": "

The password for the master user. The password can include any printable ASCII character except \"/\", \"\"\", or \"@\".

Constraints: Must contain from 8 to 41 characters.

", "RestoreDBInstanceFromS3Message$AvailabilityZone": "

The Availability Zone that the DB instance is created in. For information about AWS Regions and Availability Zones, see Regions and Availability Zones in the Amazon RDS User Guide.

Default: A random, system-chosen Availability Zone in the endpoint's AWS Region.

Example: us-east-1d

Constraint: The AvailabilityZone parameter can't be specified if the MultiAZ parameter is set to true. The specified Availability Zone must be in the same AWS Region as the current endpoint.

", "RestoreDBInstanceFromS3Message$DBSubnetGroupName": "

A DB subnet group to associate with this DB instance.

", @@ -3195,7 +3198,7 @@ "RestoreDBInstanceFromS3Message$S3IngestionRoleArn": "

An AWS Identity and Access Management (IAM) role to allow Amazon RDS to access your Amazon S3 bucket.

", "RestoreDBInstanceFromS3Message$PerformanceInsightsKMSKeyId": "

The AWS KMS key identifier for encryption of Performance Insights data. The KMS key ID is the Amazon Resource Name (ARN), the KMS key identifier, or the KMS key alias for the KMS encryption key.

", "RestoreDBInstanceToPointInTimeMessage$SourceDBInstanceIdentifier": "

The identifier of the source DB instance from which to restore.

Constraints:

", - "RestoreDBInstanceToPointInTimeMessage$TargetDBInstanceIdentifier": "

The name of the new DB instance to be created.

Constraints:

", + "RestoreDBInstanceToPointInTimeMessage$TargetDBInstanceIdentifier": "

The name of the new DB instance to be created.

Constraints:

", "RestoreDBInstanceToPointInTimeMessage$DBInstanceClass": "

The compute and memory capacity of the Amazon RDS DB instance, for example, db.m4.large. Not all DB instance classes are available in all AWS Regions, or for all database engines. For the full list of DB instance classes, and availability for your engine, see DB Instance Class in the Amazon RDS User Guide.

Default: The same DBInstanceClass as the original DB instance.

", "RestoreDBInstanceToPointInTimeMessage$AvailabilityZone": "

The EC2 Availability Zone that the DB instance is created in.

Default: A random, system-chosen Availability Zone.

Constraint: You can't specify the AvailabilityZone parameter if the MultiAZ parameter is set to true.

Example: us-east-1a

", "RestoreDBInstanceToPointInTimeMessage$DBSubnetGroupName": "

The DB subnet group name to use for the new instance.

Constraints: If supplied, must match the name of an existing DBSubnetGroup.

Example: mySubnetgroup

", @@ -3208,6 +3211,7 @@ "RestoreDBInstanceToPointInTimeMessage$TdeCredentialPassword": "

The password for the given ARN from the key store in order to access the device.

", "RestoreDBInstanceToPointInTimeMessage$Domain": "

Specify the Active Directory Domain to restore the instance in.

", "RestoreDBInstanceToPointInTimeMessage$DomainIAMRoleName": "

Specify the name of the IAM role to be used when making API calls to the Directory Service.

", + "RestoreDBInstanceToPointInTimeMessage$DBParameterGroupName": "

The name of the DB parameter group to associate with this DB instance. If this argument is omitted, the default DBParameterGroup for the specified engine is used.

Constraints:

", "RevokeDBSecurityGroupIngressMessage$DBSecurityGroupName": "

The name of the DB security group to revoke ingress from.

", "RevokeDBSecurityGroupIngressMessage$CIDRIP": "

The IP range to revoke access from. Must be a valid CIDR range. If CIDRIP is specified, EC2SecurityGroupName, EC2SecurityGroupId and EC2SecurityGroupOwnerId can't be provided.

", "RevokeDBSecurityGroupIngressMessage$EC2SecurityGroupName": "

The name of the EC2 security group to revoke access from. For VPC DB security groups, EC2SecurityGroupId must be provided. Otherwise, EC2SecurityGroupOwnerId and either EC2SecurityGroupName or EC2SecurityGroupId must be provided.

", @@ -3292,7 +3296,7 @@ "TStamp": { "base": null, "refs": { - "BacktrackDBClusterMessage$BacktrackTo": "

The timestamp of the time to backtrack the DB cluster to, specified in ISO 8601 format. For more information about ISO 8601, see the ISO8601 Wikipedia page.

If the specified time is not a consistent time for the DB cluster, Aurora automatically chooses the nearest possible consistent time for the DB cluster.

Constraints:

Example: 2017-07-08T18:00Z

", + "BacktrackDBClusterMessage$BacktrackTo": "

The timestamp of the time to backtrack the DB cluster to, specified in ISO 8601 format. For more information about ISO 8601, see the ISO8601 Wikipedia page.

If the specified time is not a consistent time for the DB cluster, Aurora automatically chooses the nearest possible consistent time for the DB cluster.

Constraints:

Example: 2017-07-08T18:00Z

", "Certificate$ValidFrom": "

The starting date from which the certificate is valid.

", "Certificate$ValidTill": "

The final date that the certificate continues to be valid.

", "DBCluster$EarliestRestorableTime": "

The earliest time to which a database can be restored with point-in-time restore.

", @@ -3315,8 +3319,8 @@ "PendingMaintenanceAction$ForcedApplyDate": "

The date when the maintenance action is automatically applied. The maintenance action is applied to the resource on this date regardless of the maintenance window for the resource. If this date is specified, any immediate opt-in requests are ignored.

", "PendingMaintenanceAction$CurrentApplyDate": "

The effective date when the pending maintenance action is applied to the resource. This date takes into account opt-in requests received from the ApplyPendingMaintenanceAction API, the AutoAppliedAfterDate, and the ForcedApplyDate. This value is blank if an opt-in request has not been received and nothing has been specified as AutoAppliedAfterDate or ForcedApplyDate.

", "ReservedDBInstance$StartTime": "

The time the reservation started.

", - "RestoreDBClusterToPointInTimeMessage$RestoreToTime": "

The date and time to restore the DB cluster to.

Valid Values: Value must be a time in Universal Coordinated Time (UTC) format

Constraints:

Example: 2015-03-07T23:45:00Z

", - "RestoreDBInstanceToPointInTimeMessage$RestoreTime": "

The date and time to restore from.

Valid Values: Value must be a time in Universal Coordinated Time (UTC) format

Constraints:

Example: 2009-09-07T23:45:00Z

" + "RestoreDBClusterToPointInTimeMessage$RestoreToTime": "

The date and time to restore the DB cluster to.

Valid Values: Value must be a time in Universal Coordinated Time (UTC) format

Constraints:

Example: 2015-03-07T23:45:00Z

", + "RestoreDBInstanceToPointInTimeMessage$RestoreTime": "

The date and time to restore from.

Valid Values: Value must be a time in Universal Coordinated Time (UTC) format

Constraints:

Example: 2009-09-07T23:45:00Z

" } }, "Tag": { diff --git a/models/apis/servicecatalog/2015-12-10/api-2.json b/models/apis/servicecatalog/2015-12-10/api-2.json index 425faeb6d46..db70327b18f 100644 --- a/models/apis/servicecatalog/2015-12-10/api-2.json +++ b/models/apis/servicecatalog/2015-12-10/api-2.json @@ -54,6 +54,20 @@ {"shape":"LimitExceededException"} ] }, + "AssociateServiceActionWithProvisioningArtifact":{ + "name":"AssociateServiceActionWithProvisioningArtifact", + "http":{ + "method":"POST", + "requestUri":"/" + }, + "input":{"shape":"AssociateServiceActionWithProvisioningArtifactInput"}, + "output":{"shape":"AssociateServiceActionWithProvisioningArtifactOutput"}, + "errors":[ + {"shape":"ResourceNotFoundException"}, + {"shape":"DuplicateResourceException"}, + {"shape":"LimitExceededException"} + ] + }, "AssociateTagOptionWithResource":{ "name":"AssociateTagOptionWithResource", "http":{ @@ -71,6 +85,30 @@ {"shape":"InvalidStateException"} ] }, + "BatchAssociateServiceActionWithProvisioningArtifact":{ + "name":"BatchAssociateServiceActionWithProvisioningArtifact", + "http":{ + "method":"POST", + "requestUri":"/" + }, + "input":{"shape":"BatchAssociateServiceActionWithProvisioningArtifactInput"}, + "output":{"shape":"BatchAssociateServiceActionWithProvisioningArtifactOutput"}, + "errors":[ + {"shape":"InvalidParametersException"} + ] + }, + "BatchDisassociateServiceActionFromProvisioningArtifact":{ + "name":"BatchDisassociateServiceActionFromProvisioningArtifact", + "http":{ + "method":"POST", + "requestUri":"/" + }, + "input":{"shape":"BatchDisassociateServiceActionFromProvisioningArtifactInput"}, + "output":{"shape":"BatchDisassociateServiceActionFromProvisioningArtifactOutput"}, + "errors":[ + {"shape":"InvalidParametersException"} + ] + }, "CopyProduct":{ "name":"CopyProduct", "http":{ @@ -169,6 +207,19 @@ {"shape":"LimitExceededException"} ] }, + "CreateServiceAction":{ + "name":"CreateServiceAction", + "http":{ + "method":"POST", + "requestUri":"/" + }, + "input":{"shape":"CreateServiceActionInput"}, + "output":{"shape":"CreateServiceActionOutput"}, + "errors":[ + {"shape":"InvalidParametersException"}, + {"shape":"LimitExceededException"} + ] + }, "CreateTagOption":{ "name":"CreateTagOption", "http":{ @@ -265,6 +316,19 @@ {"shape":"InvalidParametersException"} ] }, + "DeleteServiceAction":{ + "name":"DeleteServiceAction", + "http":{ + "method":"POST", + "requestUri":"/" + }, + "input":{"shape":"DeleteServiceActionInput"}, + "output":{"shape":"DeleteServiceActionOutput"}, + "errors":[ + {"shape":"ResourceNotFoundException"}, + {"shape":"ResourceInUseException"} + ] + }, "DeleteTagOption":{ "name":"DeleteTagOption", "http":{ @@ -415,6 +479,18 @@ {"shape":"ResourceNotFoundException"} ] }, + "DescribeServiceAction":{ + "name":"DescribeServiceAction", + "http":{ + "method":"POST", + "requestUri":"/" + }, + "input":{"shape":"DescribeServiceActionInput"}, + "output":{"shape":"DescribeServiceActionOutput"}, + "errors":[ + {"shape":"ResourceNotFoundException"} + ] + }, "DescribeTagOption":{ "name":"DescribeTagOption", "http":{ @@ -455,6 +531,18 @@ {"shape":"InvalidParametersException"} ] }, + "DisassociateServiceActionFromProvisioningArtifact":{ + "name":"DisassociateServiceActionFromProvisioningArtifact", + "http":{ + "method":"POST", + "requestUri":"/" + }, + "input":{"shape":"DisassociateServiceActionFromProvisioningArtifactInput"}, + "output":{"shape":"DisassociateServiceActionFromProvisioningArtifactOutput"}, + "errors":[ + {"shape":"ResourceNotFoundException"} + ] + }, "DisassociateTagOptionFromResource":{ "name":"DisassociateTagOptionFromResource", "http":{ @@ -482,6 +570,20 @@ {"shape":"InvalidStateException"} ] }, + "ExecuteProvisionedProductServiceAction":{ + "name":"ExecuteProvisionedProductServiceAction", + "http":{ + "method":"POST", + "requestUri":"/" + }, + "input":{"shape":"ExecuteProvisionedProductServiceActionInput"}, + "output":{"shape":"ExecuteProvisionedProductServiceActionOutput"}, + "errors":[ + {"shape":"InvalidParametersException"}, + {"shape":"ResourceNotFoundException"}, + {"shape":"InvalidStateException"} + ] + }, "ListAcceptedPortfolioShares":{ "name":"ListAcceptedPortfolioShares", "http":{ @@ -596,6 +698,19 @@ {"shape":"InvalidParametersException"} ] }, + "ListProvisioningArtifactsForServiceAction":{ + "name":"ListProvisioningArtifactsForServiceAction", + "http":{ + "method":"POST", + "requestUri":"/" + }, + "input":{"shape":"ListProvisioningArtifactsForServiceActionInput"}, + "output":{"shape":"ListProvisioningArtifactsForServiceActionOutput"}, + "errors":[ + {"shape":"ResourceNotFoundException"}, + {"shape":"InvalidParametersException"} + ] + }, "ListRecordHistory":{ "name":"ListRecordHistory", "http":{ @@ -622,6 +737,31 @@ {"shape":"InvalidParametersException"} ] }, + "ListServiceActions":{ + "name":"ListServiceActions", + "http":{ + "method":"POST", + "requestUri":"/" + }, + "input":{"shape":"ListServiceActionsInput"}, + "output":{"shape":"ListServiceActionsOutput"}, + "errors":[ + {"shape":"InvalidParametersException"} + ] + }, + "ListServiceActionsForProvisioningArtifact":{ + "name":"ListServiceActionsForProvisioningArtifact", + "http":{ + "method":"POST", + "requestUri":"/" + }, + "input":{"shape":"ListServiceActionsForProvisioningArtifactInput"}, + "output":{"shape":"ListServiceActionsForProvisioningArtifactOutput"}, + "errors":[ + {"shape":"ResourceNotFoundException"}, + {"shape":"InvalidParametersException"} + ] + }, "ListTagOptions":{ "name":"ListTagOptions", "http":{ @@ -790,6 +930,19 @@ {"shape":"InvalidParametersException"} ] }, + "UpdateServiceAction":{ + "name":"UpdateServiceAction", + "http":{ + "method":"POST", + "requestUri":"/" + }, + "input":{"shape":"UpdateServiceActionInput"}, + "output":{"shape":"UpdateServiceActionOutput"}, + "errors":[ + {"shape":"ResourceNotFoundException"}, + {"shape":"InvalidParametersException"} + ] + }, "UpdateTagOption":{ "name":"UpdateTagOption", "http":{ @@ -807,7 +960,10 @@ } }, "shapes":{ - "AcceptLanguage":{"type":"string"}, + "AcceptLanguage":{ + "type":"string", + "max":100 + }, "AcceptPortfolioShareInput":{ "type":"structure", "required":["PortfolioId"], @@ -893,6 +1049,25 @@ "members":{ } }, + "AssociateServiceActionWithProvisioningArtifactInput":{ + "type":"structure", + "required":[ + "ProductId", + "ProvisioningArtifactId", + "ServiceActionId" + ], + "members":{ + "ProductId":{"shape":"Id"}, + "ProvisioningArtifactId":{"shape":"Id"}, + "ServiceActionId":{"shape":"Id"}, + "AcceptLanguage":{"shape":"AcceptLanguage"} + } + }, + "AssociateServiceActionWithProvisioningArtifactOutput":{ + "type":"structure", + "members":{ + } + }, "AssociateTagOptionWithResourceInput":{ "type":"structure", "required":[ @@ -910,6 +1085,34 @@ } }, "AttributeValue":{"type":"string"}, + "BatchAssociateServiceActionWithProvisioningArtifactInput":{ + "type":"structure", + "required":["ServiceActionAssociations"], + "members":{ + "ServiceActionAssociations":{"shape":"ServiceActionAssociations"}, + "AcceptLanguage":{"shape":"AcceptLanguage"} + } + }, + "BatchAssociateServiceActionWithProvisioningArtifactOutput":{ + "type":"structure", + "members":{ + "FailedServiceActionAssociations":{"shape":"FailedServiceActionAssociations"} + } + }, + "BatchDisassociateServiceActionFromProvisioningArtifactInput":{ + "type":"structure", + "required":["ServiceActionAssociations"], + "members":{ + "ServiceActionAssociations":{"shape":"ServiceActionAssociations"}, + "AcceptLanguage":{"shape":"AcceptLanguage"} + } + }, + "BatchDisassociateServiceActionFromProvisioningArtifactOutput":{ + "type":"structure", + "members":{ + "FailedServiceActionAssociations":{"shape":"FailedServiceActionAssociations"} + } + }, "CausingEntity":{"type":"string"}, "ChangeAction":{ "type":"string", @@ -1175,6 +1378,32 @@ "Status":{"shape":"Status"} } }, + "CreateServiceActionInput":{ + "type":"structure", + "required":[ + "Name", + "DefinitionType", + "Definition", + "IdempotencyToken" + ], + "members":{ + "Name":{"shape":"ServiceActionName"}, + "DefinitionType":{"shape":"ServiceActionDefinitionType"}, + "Definition":{"shape":"ServiceActionDefinitionMap"}, + "Description":{"shape":"ServiceActionDescription"}, + "AcceptLanguage":{"shape":"AcceptLanguage"}, + "IdempotencyToken":{ + "shape":"IdempotencyToken", + "idempotencyToken":true + } + } + }, + "CreateServiceActionOutput":{ + "type":"structure", + "members":{ + "ServiceActionDetail":{"shape":"ServiceActionDetail"} + } + }, "CreateTagOptionInput":{ "type":"structure", "required":[ @@ -1282,6 +1511,19 @@ "members":{ } }, + "DeleteServiceActionInput":{ + "type":"structure", + "required":["Id"], + "members":{ + "Id":{"shape":"Id"}, + "AcceptLanguage":{"shape":"AcceptLanguage"} + } + }, + "DeleteServiceActionOutput":{ + "type":"structure", + "members":{ + } + }, "DeleteTagOptionInput":{ "type":"structure", "required":["Id"], @@ -1483,6 +1725,20 @@ "NextPageToken":{"shape":"PageToken"} } }, + "DescribeServiceActionInput":{ + "type":"structure", + "required":["Id"], + "members":{ + "Id":{"shape":"Id"}, + "AcceptLanguage":{"shape":"AcceptLanguage"} + } + }, + "DescribeServiceActionOutput":{ + "type":"structure", + "members":{ + "ServiceActionDetail":{"shape":"ServiceActionDetail"} + } + }, "DescribeTagOptionInput":{ "type":"structure", "required":["Id"], @@ -1531,6 +1787,25 @@ "members":{ } }, + "DisassociateServiceActionFromProvisioningArtifactInput":{ + "type":"structure", + "required":[ + "ProductId", + "ProvisioningArtifactId", + "ServiceActionId" + ], + "members":{ + "ProductId":{"shape":"Id"}, + "ProvisioningArtifactId":{"shape":"Id"}, + "ServiceActionId":{"shape":"Id"}, + "AcceptLanguage":{"shape":"AcceptLanguage"} + } + }, + "DisassociateServiceActionFromProvisioningArtifactOutput":{ + "type":"structure", + "members":{ + } + }, "DisassociateTagOptionFromResourceInput":{ "type":"structure", "required":[ @@ -1583,11 +1858,50 @@ "RecordDetail":{"shape":"RecordDetail"} } }, + "ExecuteProvisionedProductServiceActionInput":{ + "type":"structure", + "required":[ + "ProvisionedProductId", + "ServiceActionId", + "ExecuteToken" + ], + "members":{ + "ProvisionedProductId":{"shape":"Id"}, + "ServiceActionId":{"shape":"Id"}, + "ExecuteToken":{ + "shape":"IdempotencyToken", + "idempotencyToken":true + }, + "AcceptLanguage":{"shape":"AcceptLanguage"} + } + }, + "ExecuteProvisionedProductServiceActionOutput":{ + "type":"structure", + "members":{ + "RecordDetail":{"shape":"RecordDetail"} + } + }, + "FailedServiceActionAssociation":{ + "type":"structure", + "members":{ + "ServiceActionId":{"shape":"Id"}, + "ProductId":{"shape":"Id"}, + "ProvisioningArtifactId":{"shape":"Id"}, + "ErrorCode":{"shape":"ServiceActionAssociationErrorCode"}, + "ErrorMessage":{"shape":"ServiceActionAssociationErrorMessage"} + } + }, + "FailedServiceActionAssociations":{ + "type":"list", + "member":{"shape":"FailedServiceActionAssociation"}, + "max":50 + }, "HasDefaultPath":{"type":"boolean"}, "Id":{ "type":"string", "max":100, - "min":1 + "min":1, + "pattern":"^[a-zA-Z0-9_\\-]*" }, "IdempotencyToken":{ "type":"string", @@ -1762,6 +2076,23 @@ "NextPageToken":{"shape":"PageToken"} } }, + "ListProvisioningArtifactsForServiceActionInput":{ + "type":"structure", + "required":["ServiceActionId"], + "members":{ + "ServiceActionId":{"shape":"Id"}, + "PageSize":{"shape":"PageSize"}, + "PageToken":{"shape":"PageToken"}, + "AcceptLanguage":{"shape":"AcceptLanguage"} + } + }, + "ListProvisioningArtifactsForServiceActionOutput":{ + "type":"structure", + "members":{ + "ProvisioningArtifactViews":{"shape":"ProvisioningArtifactViews"}, + "NextPageToken":{"shape":"PageToken"} + } + }, "ListProvisioningArtifactsInput":{ "type":"structure", "required":["ProductId"], @@ -1818,6 +2149,42 @@ "PageToken":{"shape":"PageToken"} } }, + "ListServiceActionsForProvisioningArtifactInput":{ + "type":"structure", + "required":[ + "ProductId", + "ProvisioningArtifactId" + ], + "members":{ + "ProductId":{"shape":"Id"}, + "ProvisioningArtifactId":{"shape":"Id"}, + "PageSize":{"shape":"PageSize"}, + "PageToken":{"shape":"PageToken"}, + "AcceptLanguage":{"shape":"AcceptLanguage"} + } + }, + "ListServiceActionsForProvisioningArtifactOutput":{ + "type":"structure", + "members":{ + "ServiceActionSummaries":{"shape":"ServiceActionSummaries"}, + "NextPageToken":{"shape":"PageToken"} + } + }, + "ListServiceActionsInput":{ + "type":"structure", + "members":{ + "AcceptLanguage":{"shape":"AcceptLanguage"}, + "PageSize":{"shape":"PageSize"}, + "PageToken":{"shape":"PageToken"} + } + }, + "ListServiceActionsOutput":{ + "type":"structure", + "members":{ + "ServiceActionSummaries":{"shape":"ServiceActionSummaries"}, + "NextPageToken":{"shape":"PageToken"} + } + }, "ListTagOptionsFilters":{ "type":"structure", "members":{ @@ -1863,6 +2230,7 @@ }, "PageToken":{ "type":"string", + "max":2024, "pattern":"[\\u0009\\u000a\\u000d\\u0020-\\uD7FF\\uE000-\\uFFFD]*" }, "ParameterConstraints":{ @@ -2118,7 +2486,9 @@ "StatusMessage":{"shape":"ProvisionedProductStatusMessage"}, "CreatedTime":{"shape":"CreatedTime"}, "IdempotencyToken":{"shape":"IdempotencyToken"}, - "LastRecordId":{"shape":"LastRequestId"} + "LastRecordId":{"shape":"LastRequestId"}, + "ProductId":{"shape":"Id"}, + "ProvisioningArtifactId":{"shape":"Id"} } }, "ProvisionedProductDetails":{ @@ -2304,6 +2674,17 @@ "MARKETPLACE_CAR" ] }, + "ProvisioningArtifactView":{ + "type":"structure", + "members":{ + "ProductViewSummary":{"shape":"ProductViewSummary"}, + "ProvisioningArtifact":{"shape":"ProvisioningArtifact"} + } + }, + "ProvisioningArtifactViews":{ + "type":"list", + "member":{"shape":"ProvisioningArtifactView"} + }, "ProvisioningArtifacts":{ "type":"list", "member":{"shape":"ProvisioningArtifact"} @@ -2599,6 +2980,95 @@ "max":100, "min":0 }, + "ServiceActionAssociation":{ + "type":"structure", + "required":[ + "ServiceActionId", + "ProductId", + "ProvisioningArtifactId" + ], + "members":{ + "ServiceActionId":{"shape":"Id"}, + "ProductId":{"shape":"Id"}, + "ProvisioningArtifactId":{"shape":"Id"} + } + }, + "ServiceActionAssociationErrorCode":{ + "type":"string", + "enum":[ + "DUPLICATE_RESOURCE", + "INTERNAL_FAILURE", + "LIMIT_EXCEEDED", + "RESOURCE_NOT_FOUND", + "THROTTLING" + ] + }, + "ServiceActionAssociationErrorMessage":{ + "type":"string", + "max":1024, + "min":1 + }, + "ServiceActionAssociations":{ + "type":"list", + "member":{"shape":"ServiceActionAssociation"}, + "max":50, + "min":1 + }, + "ServiceActionDefinitionKey":{ + "type":"string", + "enum":[ + "Name", + "Version", + "AssumeRole", + "Parameters" + ] + }, + "ServiceActionDefinitionMap":{ + "type":"map", + "key":{"shape":"ServiceActionDefinitionKey"}, + "value":{"shape":"ServiceActionDefinitionValue"}, + "max":100, + "min":1 + }, + "ServiceActionDefinitionType":{ + "type":"string", + "enum":["SSM_AUTOMATION"] + }, + "ServiceActionDefinitionValue":{ + "type":"string", + "max":1024, + "min":1 + }, + "ServiceActionDescription":{ + "type":"string", + "max":1024 + }, + "ServiceActionDetail":{ + "type":"structure", + "members":{ + "ServiceActionSummary":{"shape":"ServiceActionSummary"}, + "Definition":{"shape":"ServiceActionDefinitionMap"} + } + }, + "ServiceActionName":{ + "type":"string", + "max":256, + "min":1, + "pattern":"^[a-zA-Z0-9_\\-.]*" + }, + "ServiceActionSummaries":{ + "type":"list", + "member":{"shape":"ServiceActionSummary"} + }, + "ServiceActionSummary":{ + "type":"structure", + "members":{ + "Id":{"shape":"Id"}, + "Name":{"shape":"ServiceActionName"}, + "Description":{"shape":"ServiceActionDescription"}, + "DefinitionType":{"shape":"ServiceActionDefinitionType"} + } + }, "SortField":{"type":"string"}, "SortOrder":{ "type":"string", @@ -2865,6 +3335,23 @@ "type":"list", "member":{"shape":"UpdateProvisioningParameter"} }, + "UpdateServiceActionInput":{ + "type":"structure", + "required":["Id"], + "members":{ + "Id":{"shape":"Id"}, + "Name":{"shape":"ServiceActionName"}, + "Definition":{"shape":"ServiceActionDefinitionMap"}, + "Description":{"shape":"ServiceActionDescription"}, + "AcceptLanguage":{"shape":"AcceptLanguage"} + } + }, + "UpdateServiceActionOutput":{ + "type":"structure", + "members":{ + "ServiceActionDetail":{"shape":"ServiceActionDetail"} + } + }, "UpdateTagOptionInput":{ "type":"structure", "required":["Id"], diff --git a/models/apis/servicecatalog/2015-12-10/docs-2.json b/models/apis/servicecatalog/2015-12-10/docs-2.json index 3d379c0caad..1fa62fbce28 100644 --- a/models/apis/servicecatalog/2015-12-10/docs-2.json +++ b/models/apis/servicecatalog/2015-12-10/docs-2.json @@ -5,7 +5,10 @@ "AcceptPortfolioShare": "

Accepts an offer to share the specified portfolio.

", "AssociatePrincipalWithPortfolio": "

Associates the specified principal ARN with the specified portfolio.

", "AssociateProductWithPortfolio": "

Associates the specified product with the specified portfolio.

", + "AssociateServiceActionWithProvisioningArtifact": "

Associates a self-service action with a provisioning artifact.

", "AssociateTagOptionWithResource": "

Associate the specified TagOption with the specified portfolio or product.

", + "BatchAssociateServiceActionWithProvisioningArtifact": "

Associates multiple self-service actions with provisioning artifacts.

", + "BatchDisassociateServiceActionFromProvisioningArtifact": "

Disassociates a batch of self-service actions from the specified provisioning artifact.

", "CopyProduct": "

Copies the specified source product to the specified target product or a new product.

You can copy a product to the same account or another account. You can copy a product to the same region or another region.

This operation is performed asynchronously. To track the progress of the operation, use DescribeCopyProductStatus.

", "CreateConstraint": "

Creates a constraint.

", "CreatePortfolio": "

Creates a portfolio.

", @@ -13,6 +16,7 @@ "CreateProduct": "

Creates a product.

", "CreateProvisionedProductPlan": "

Creates a plan. A plan includes the list of resources to be created (when provisioning a new product) or modified (when updating a provisioned product) when the plan is executed.

You can create one plan per provisioned product. To create a plan for an existing provisioned product, the product status must be AVAILBLE or TAINTED.

To view the resource changes in the change set, use DescribeProvisionedProductPlan. To create or modify the provisioned product, use ExecuteProvisionedProductPlan.

", "CreateProvisioningArtifact": "

Creates a provisioning artifact (also known as a version) for the specified product.

You cannot create a provisioning artifact for a product that was shared with you.

", + "CreateServiceAction": "

Creates a self-service action.

", "CreateTagOption": "

Creates a TagOption.

", "DeleteConstraint": "

Deletes the specified constraint.

", "DeletePortfolio": "

Deletes the specified portfolio.

You cannot delete a portfolio if it was shared with you or if it has associated products, users, constraints, or shared accounts.

", @@ -20,6 +24,7 @@ "DeleteProduct": "

Deletes the specified product.

You cannot delete a product if it was shared with you or is associated with a portfolio.

", "DeleteProvisionedProductPlan": "

Deletes the specified plan.

", "DeleteProvisioningArtifact": "

Deletes the specified provisioning artifact (also known as a version) for the specified product.

You cannot delete a provisioning artifact associated with a product that was shared with you. You cannot delete the last provisioning artifact for a product, because a product must have at least one provisioning artifact.

", + "DeleteServiceAction": "

Deletes a self-service action.

", "DeleteTagOption": "

Deletes the specified TagOption.

You cannot delete a TagOption if it is associated with a product or portfolio.

", "DescribeConstraint": "

Gets information about the specified constraint.

", "DescribeCopyProductStatus": "

Gets the status of the specified copy product operation.

", @@ -32,11 +37,14 @@ "DescribeProvisioningArtifact": "

Gets information about the specified provisioning artifact (also known as a version) for the specified product.

", "DescribeProvisioningParameters": "

Gets information about the configuration required to provision the specified product using the specified provisioning artifact.

If the output contains a TagOption key with an empty list of values, there is a TagOption conflict for that key. The end user cannot take action to fix the conflict, and launch is not blocked. In subsequent calls to ProvisionProduct, do not include conflicted TagOption keys as tags, or this causes the error \"Parameter validation failed: Missing required parameter in Tags[N]:Value\". Tag the provisioned product with the value sc-tagoption-conflict-portfolioId-productId.

", "DescribeRecord": "

Gets information about the specified request operation.

Use this operation after calling a request operation (for example, ProvisionProduct, TerminateProvisionedProduct, or UpdateProvisionedProduct).

", + "DescribeServiceAction": "

Describes a self-service action.

", "DescribeTagOption": "

Gets information about the specified TagOption.

", "DisassociatePrincipalFromPortfolio": "

Disassociates a previously associated principal ARN from a specified portfolio.

", "DisassociateProductFromPortfolio": "

Disassociates the specified product from the specified portfolio.

", + "DisassociateServiceActionFromProvisioningArtifact": "

Disassociates the specified self-service action association from the specified provisioning artifact.

", "DisassociateTagOptionFromResource": "

Disassociates the specified TagOption from the specified resource.

", "ExecuteProvisionedProductPlan": "

Provisions or modifies a product based on the resource changes for the specified plan.

", + "ExecuteProvisionedProductServiceAction": "

Executes a self-service action against a provisioned product.

", "ListAcceptedPortfolioShares": "

Lists all portfolios for which sharing was accepted by this account.

", "ListConstraintsForPortfolio": "

Lists the constraints for the specified portfolio and product.

", "ListLaunchPaths": "

Lists the paths to the specified product. A path is how the user has access to a specified product, and is necessary when provisioning a product. A path also determines the constraints put on the product.

", @@ -46,8 +54,11 @@ "ListPrincipalsForPortfolio": "

Lists all principal ARNs associated with the specified portfolio.

", "ListProvisionedProductPlans": "

Lists the plans for the specified provisioned product or all plans to which the user has access.

", "ListProvisioningArtifacts": "

Lists all provisioning artifacts (also known as versions) for the specified product.

", + "ListProvisioningArtifactsForServiceAction": "

Lists all provisioning artifacts (also known as versions) for the specified self-service action.

", "ListRecordHistory": "

Lists the specified requests or all performed requests.

", "ListResourcesForTagOption": "

Lists the resources associated with the specified TagOption.

", + "ListServiceActions": "

Lists all self-service actions.

", + "ListServiceActionsForProvisioningArtifact": "

Returns a paginated list of self-service actions associated with the specified Product ID and Provisioning Artifact ID.

", "ListTagOptions": "

Lists the specified TagOptions or all TagOptions.

", "ProvisionProduct": "

Provisions the specified product.

A provisioned product is a resourced instance of a product. For example, provisioning a product based on a CloudFormation template launches a CloudFormation stack and its underlying resources. You can check the status of this request using DescribeRecord.

If the request contains a tag key with an empty list of values, there is a tag conflict for that key. Do not include conflicted keys as tags, or this causes the error \"Parameter validation failed: Missing required parameter in Tags[N]:Value\".

", "RejectPortfolioShare": "

Rejects an offer to share the specified portfolio.

", @@ -61,6 +72,7 @@ "UpdateProduct": "

Updates the specified product.

", "UpdateProvisionedProduct": "

Requests updates to the configuration of the specified provisioned product.

If there are tags associated with the object, they cannot be updated or added. Depending on the specific updates requested, this operation can update with no interruption, with some interruption, or replace the provisioned product entirely.

You can check the status of this request using DescribeRecord.

", "UpdateProvisioningArtifact": "

Updates the specified provisioning artifact (also known as a version) for the specified product.

You cannot update a provisioning artifact for a product that was shared with you.

", + "UpdateServiceAction": "

Updates a self-service action.

", "UpdateTagOption": "

Updates the specified TagOption.

" }, "shapes": { @@ -70,6 +82,9 @@ "AcceptPortfolioShareInput$AcceptLanguage": "

The language code.

", "AssociatePrincipalWithPortfolioInput$AcceptLanguage": "

The language code.

", "AssociateProductWithPortfolioInput$AcceptLanguage": "

The language code.

", + "AssociateServiceActionWithProvisioningArtifactInput$AcceptLanguage": "

The language code.

", + "BatchAssociateServiceActionWithProvisioningArtifactInput$AcceptLanguage": "

The language code.

", + "BatchDisassociateServiceActionFromProvisioningArtifactInput$AcceptLanguage": "

The language code.

", "CopyProductInput$AcceptLanguage": "

The language code.

", "CreateConstraintInput$AcceptLanguage": "

The language code.

", "CreatePortfolioInput$AcceptLanguage": "

The language code.

", @@ -77,12 +92,14 @@ "CreateProductInput$AcceptLanguage": "

The language code.

", "CreateProvisionedProductPlanInput$AcceptLanguage": "

The language code.

", "CreateProvisioningArtifactInput$AcceptLanguage": "

The language code.

", + "CreateServiceActionInput$AcceptLanguage": "

The language code.

", "DeleteConstraintInput$AcceptLanguage": "

The language code.

", "DeletePortfolioInput$AcceptLanguage": "

The language code.

", "DeletePortfolioShareInput$AcceptLanguage": "

The language code.

", "DeleteProductInput$AcceptLanguage": "

The language code.

", "DeleteProvisionedProductPlanInput$AcceptLanguage": "

The language code.

", "DeleteProvisioningArtifactInput$AcceptLanguage": "

The language code.

", + "DeleteServiceActionInput$AcceptLanguage": "

The language code.

", "DescribeConstraintInput$AcceptLanguage": "

The language code.

", "DescribeCopyProductStatusInput$AcceptLanguage": "

The language code.

", "DescribePortfolioInput$AcceptLanguage": "

The language code.

", @@ -94,9 +111,12 @@ "DescribeProvisioningArtifactInput$AcceptLanguage": "

The language code.

", "DescribeProvisioningParametersInput$AcceptLanguage": "

The language code.

", "DescribeRecordInput$AcceptLanguage": "

The language code.

", + "DescribeServiceActionInput$AcceptLanguage": "

The language code.

", "DisassociatePrincipalFromPortfolioInput$AcceptLanguage": "

The language code.

", "DisassociateProductFromPortfolioInput$AcceptLanguage": "

The language code.

", + "DisassociateServiceActionFromProvisioningArtifactInput$AcceptLanguage": "

The language code.

", "ExecuteProvisionedProductPlanInput$AcceptLanguage": "

The language code.

", + "ExecuteProvisionedProductServiceActionInput$AcceptLanguage": "

The language code.

", "ListAcceptedPortfolioSharesInput$AcceptLanguage": "

The language code.

", "ListConstraintsForPortfolioInput$AcceptLanguage": "

The language code.

", "ListLaunchPathsInput$AcceptLanguage": "

The language code.

", @@ -105,8 +125,11 @@ "ListPortfoliosInput$AcceptLanguage": "

The language code.

", "ListPrincipalsForPortfolioInput$AcceptLanguage": "

The language code.

", "ListProvisionedProductPlansInput$AcceptLanguage": "

The language code.

", + "ListProvisioningArtifactsForServiceActionInput$AcceptLanguage": "

The language code.

", "ListProvisioningArtifactsInput$AcceptLanguage": "

The language code.

", "ListRecordHistoryInput$AcceptLanguage": "

The language code.

", + "ListServiceActionsForProvisioningArtifactInput$AcceptLanguage": "

The language code.

", + "ListServiceActionsInput$AcceptLanguage": "

The language code.

", "ProvisionProductInput$AcceptLanguage": "

The language code.

", "RejectPortfolioShareInput$AcceptLanguage": "

The language code.

", "ScanProvisionedProductsInput$AcceptLanguage": "

The language code.

", @@ -118,7 +141,8 @@ "UpdatePortfolioInput$AcceptLanguage": "

The language code.

", "UpdateProductInput$AcceptLanguage": "

The language code.

", "UpdateProvisionedProductInput$AcceptLanguage": "

The language code.

", - "UpdateProvisioningArtifactInput$AcceptLanguage": "

The language code.

" + "UpdateProvisioningArtifactInput$AcceptLanguage": "

The language code.

", + "UpdateServiceActionInput$AcceptLanguage": "

The language code.

" } }, "AcceptPortfolioShareInput": { @@ -214,6 +238,16 @@ "refs": { } }, + "AssociateServiceActionWithProvisioningArtifactInput": { + "base": null, + "refs": { + } + }, + "AssociateServiceActionWithProvisioningArtifactOutput": { + "base": null, + "refs": { + } + }, "AssociateTagOptionWithResourceInput": { "base": null, "refs": { @@ -230,6 +264,26 @@ "ProductViewAggregationValue$Value": "

The value of the product view aggregation.

" } }, + "BatchAssociateServiceActionWithProvisioningArtifactInput": { + "base": null, + "refs": { + } + }, + "BatchAssociateServiceActionWithProvisioningArtifactOutput": { + "base": null, + "refs": { + } + }, + "BatchDisassociateServiceActionFromProvisioningArtifactInput": { + "base": null, + "refs": { + } + }, + "BatchDisassociateServiceActionFromProvisioningArtifactOutput": { + "base": null, + "refs": { + } + }, "CausingEntity": { "base": null, "refs": { @@ -402,6 +456,16 @@ "refs": { } }, + "CreateServiceActionInput": { + "base": null, + "refs": { + } + }, + "CreateServiceActionOutput": { + "base": null, + "refs": { + } + }, "CreateTagOptionInput": { "base": null, "refs": { @@ -495,6 +559,16 @@ "refs": { } }, + "DeleteServiceActionInput": { + "base": null, + "refs": { + } + }, + "DeleteServiceActionOutput": { + "base": null, + "refs": { + } + }, "DeleteTagOptionInput": { "base": null, "refs": { @@ -615,6 +689,16 @@ "refs": { } }, + "DescribeServiceActionInput": { + "base": null, + "refs": { + } + }, + "DescribeServiceActionOutput": { + "base": null, + "refs": { + } + }, "DescribeTagOptionInput": { "base": null, "refs": { @@ -652,6 +736,16 @@ "refs": { } }, + "DisassociateServiceActionFromProvisioningArtifactInput": { + "base": null, + "refs": { + } + }, + "DisassociateServiceActionFromProvisioningArtifactOutput": { + "base": null, + "refs": { + } + }, "DisassociateTagOptionFromResourceInput": { "base": null, "refs": { @@ -695,6 +789,29 @@ "refs": { } }, + "ExecuteProvisionedProductServiceActionInput": { + "base": null, + "refs": { + } + }, + "ExecuteProvisionedProductServiceActionOutput": { + "base": null, + "refs": { + } + }, + "FailedServiceActionAssociation": { + "base": "

An object containing information about the error, along with identifying information about the self-service action and its associations.

", + "refs": { + "FailedServiceActionAssociations$member": null + } + }, + "FailedServiceActionAssociations": { + "base": null, + "refs": { + "BatchAssociateServiceActionWithProvisioningArtifactOutput$FailedServiceActionAssociations": "

An object that contains a list of errors, along with information to help you identify the self-service action.

", + "BatchDisassociateServiceActionFromProvisioningArtifactOutput$FailedServiceActionAssociations": "

An object that contains a list of errors, along with information to help you identify the self-service action.

" + } + }, "HasDefaultPath": { "base": null, "refs": { @@ -709,6 +826,9 @@ "AssociateProductWithPortfolioInput$ProductId": "

The product identifier.

", "AssociateProductWithPortfolioInput$PortfolioId": "

The portfolio identifier.

", "AssociateProductWithPortfolioInput$SourcePortfolioId": "

The identifier of the source portfolio.

", + "AssociateServiceActionWithProvisioningArtifactInput$ProductId": "

The product identifier. For example, prod-abcdzk7xy33qa.

", + "AssociateServiceActionWithProvisioningArtifactInput$ProvisioningArtifactId": "

The identifier of the provisioning artifact. For example, pa-4abcdjnxjj6ne.

", + "AssociateServiceActionWithProvisioningArtifactInput$ServiceActionId": "

The self-service action identifier. For example, act-fs7abcd89wxyz.

", "ConstraintDetail$ConstraintId": "

The identifier of the constraint.

", "CopyProductInput$TargetProductId": "

The identifier of the target product. By default, a new product is created.

", "CopyProductOutput$CopyProductToken": "

The token to use to track the progress of the operation.

", @@ -729,6 +849,7 @@ "DeleteProvisionedProductPlanInput$PlanId": "

The plan identifier.

", "DeleteProvisioningArtifactInput$ProductId": "

The product identifier.

", "DeleteProvisioningArtifactInput$ProvisioningArtifactId": "

The identifier of the provisioning artifact.

", + "DeleteServiceActionInput$Id": "

The self-service action identifier. For example, act-fs7abcd89wxyz.

", "DescribeConstraintInput$Id": "

The identifier of the constraint.

", "DescribeCopyProductStatusInput$CopyProductToken": "

The token for the copy product operation. This token is returned by CopyProduct.

", "DescribeCopyProductStatusOutput$TargetProductId": "

The identifier of the copied product.

", @@ -744,10 +865,19 @@ "DescribeProvisioningParametersInput$ProvisioningArtifactId": "

The identifier of the provisioning artifact.

", "DescribeProvisioningParametersInput$PathId": "

The path identifier of the product. This value is optional if the product has a default path, and required if the product has more than one path. To list the paths for a product, use ListLaunchPaths.

", "DescribeRecordInput$Id": "

The record identifier of the provisioned product. This identifier is returned by the request operation.

", + "DescribeServiceActionInput$Id": "

The self-service action identifier.

", "DisassociatePrincipalFromPortfolioInput$PortfolioId": "

The portfolio identifier.

", "DisassociateProductFromPortfolioInput$ProductId": "

The product identifier.

", "DisassociateProductFromPortfolioInput$PortfolioId": "

The portfolio identifier.

", + "DisassociateServiceActionFromProvisioningArtifactInput$ProductId": "

The product identifier. For example, prod-abcdzk7xy33qa.

", + "DisassociateServiceActionFromProvisioningArtifactInput$ProvisioningArtifactId": "

The identifier of the provisioning artifact. For example, pa-4abcdjnxjj6ne.

", + "DisassociateServiceActionFromProvisioningArtifactInput$ServiceActionId": "

The self-service action identifier. For example, act-fs7abcd89wxyz.

", "ExecuteProvisionedProductPlanInput$PlanId": "

The plan identifier.

", + "ExecuteProvisionedProductServiceActionInput$ProvisionedProductId": "

The identifier of the provisioned product.

", + "ExecuteProvisionedProductServiceActionInput$ServiceActionId": "

The self-service action identifier. For example, act-fs7abcd89wxyz.

", + "FailedServiceActionAssociation$ServiceActionId": "

The self-service action identifier. For example, act-fs7abcd89wxyz.

", + "FailedServiceActionAssociation$ProductId": "

The product identifier. For example, prod-abcdzk7xy33qa.

", + "FailedServiceActionAssociation$ProvisioningArtifactId": "

The identifier of the provisioning artifact. For example, pa-4abcdjnxjj6ne.

", "LaunchPathSummary$Id": "

The identifier of the product path.

", "ListConstraintsForPortfolioInput$PortfolioId": "

The portfolio identifier.

", "ListConstraintsForPortfolioInput$ProductId": "

The product identifier.

", @@ -756,7 +886,10 @@ "ListPortfoliosForProductInput$ProductId": "

The product identifier.

", "ListPrincipalsForPortfolioInput$PortfolioId": "

The portfolio identifier.

", "ListProvisionedProductPlansInput$ProvisionProductId": "

The product identifier.

", + "ListProvisioningArtifactsForServiceActionInput$ServiceActionId": "

The self-service action identifier. For example, act-fs7abcd89wxyz.

", "ListProvisioningArtifactsInput$ProductId": "

The product identifier.

", + "ListServiceActionsForProvisioningArtifactInput$ProductId": "

The product identifier. For example, prod-abcdzk7xy33qa.

", + "ListServiceActionsForProvisioningArtifactInput$ProvisioningArtifactId": "

The identifier of the provisioning artifact. For example, pa-4abcdjnxjj6ne.

", "PortfolioDetail$Id": "

The portfolio identifier.

", "ProductViewSummary$Id": "

The product view identifier.

", "ProductViewSummary$ProductId": "

The product identifier.

", @@ -767,6 +900,8 @@ "ProvisionedProductAttribute$LastRecordId": "

The record identifier of the last request performed on this provisioned product.

", "ProvisionedProductAttribute$ProductId": "

The product identifier.

", "ProvisionedProductAttribute$ProvisioningArtifactId": "

The identifier of the provisioning artifact.

", + "ProvisionedProductDetail$ProductId": "

The product identifier. For example, prod-abcdzk7xy33qa.

", + "ProvisionedProductDetail$ProvisioningArtifactId": "

The identifier of the provisioning artifact. For example, pa-4abcdjnxjj6ne.

", "ProvisionedProductPlanDetails$PathId": "

The path identifier of the product. This value is optional if the product has a default path, and required if the product has more than one path. To list the paths for a product, use ListLaunchPaths.

", "ProvisionedProductPlanDetails$ProductId": "

The product identifier.

", "ProvisionedProductPlanDetails$PlanId": "

The plan identifier.

", @@ -785,6 +920,10 @@ "RecordDetail$PathId": "

The path identifier.

", "RejectPortfolioShareInput$PortfolioId": "

The portfolio identifier.

", "SearchProductsAsAdminInput$PortfolioId": "

The portfolio identifier.

", + "ServiceActionAssociation$ServiceActionId": "

The self-service action identifier. For example, act-fs7abcd89wxyz.

", + "ServiceActionAssociation$ProductId": "

The product identifier. For example, prod-abcdzk7xy33qa.

", + "ServiceActionAssociation$ProvisioningArtifactId": "

The identifier of the provisioning artifact. For example, pa-4abcdjnxjj6ne.

", + "ServiceActionSummary$Id": "

The self-service action identifier.

", "TerminateProvisionedProductInput$ProvisionedProductId": "

The identifier of the provisioned product. You cannot specify both ProvisionedProductName and ProvisionedProductId.

", "UpdateConstraintInput$Id": "

The identifier of the constraint.

", "UpdatePortfolioInput$Id": "

The portfolio identifier.

", @@ -794,7 +933,8 @@ "UpdateProvisionedProductInput$ProvisioningArtifactId": "

The identifier of the provisioning artifact.

", "UpdateProvisionedProductInput$PathId": "

The new path identifier. This value is optional if the product has a default path, and required if the product has more than one path.

", "UpdateProvisioningArtifactInput$ProductId": "

The product identifier.

", - "UpdateProvisioningArtifactInput$ProvisioningArtifactId": "

The identifier of the provisioning artifact.

" + "UpdateProvisioningArtifactInput$ProvisioningArtifactId": "

The identifier of the provisioning artifact.

", + "UpdateServiceActionInput$Id": "

The self-service action identifier.

" } }, "IdempotencyToken": { @@ -806,7 +946,9 @@ "CreateProductInput$IdempotencyToken": "

A unique identifier that you provide to ensure idempotency. If multiple requests differ only by the idempotency token, the same response is returned for each repeated request.

", "CreateProvisionedProductPlanInput$IdempotencyToken": "

A unique identifier that you provide to ensure idempotency. If multiple requests differ only by the idempotency token, the same response is returned for each repeated request.

", "CreateProvisioningArtifactInput$IdempotencyToken": "

A unique identifier that you provide to ensure idempotency. If multiple requests differ only by the idempotency token, the same response is returned for each repeated request.

", + "CreateServiceActionInput$IdempotencyToken": "

A unique identifier that you provide to ensure idempotency. If multiple requests differ only by the idempotency token, the same response is returned for each repeated request.

", "ExecuteProvisionedProductPlanInput$IdempotencyToken": "

A unique identifier that you provide to ensure idempotency. If multiple requests differ only by the idempotency token, the same response is returned for each repeated request.

", + "ExecuteProvisionedProductServiceActionInput$ExecuteToken": "

An idempotency token that uniquely identifies the execute request.

", "ProvisionProductInput$ProvisionToken": "

An idempotency token that uniquely identifies the provisioning request.

", "ProvisionedProductAttribute$IdempotencyToken": "

A unique identifier that you provide to ensure idempotency. If multiple requests differ only by the idempotency token, the same response is returned for each repeated request.

", "ProvisionedProductDetail$IdempotencyToken": "

A unique identifier that you provide to ensure idempotency. If multiple requests differ only by the idempotency token, the same response is returned for each repeated request.

", @@ -946,6 +1088,16 @@ "refs": { } }, + "ListProvisioningArtifactsForServiceActionInput": { + "base": null, + "refs": { + } + }, + "ListProvisioningArtifactsForServiceActionOutput": { + "base": null, + "refs": { + } + }, "ListProvisioningArtifactsInput": { "base": null, "refs": { @@ -982,6 +1134,26 @@ "refs": { } }, + "ListServiceActionsForProvisioningArtifactInput": { + "base": null, + "refs": { + } + }, + "ListServiceActionsForProvisioningArtifactOutput": { + "base": null, + "refs": { + } + }, + "ListServiceActionsInput": { + "base": null, + "refs": { + } + }, + "ListServiceActionsOutput": { + "base": null, + "refs": { + } + }, "ListTagOptionsFilters": { "base": "

Filters to use when listing TagOptions.

", "refs": { @@ -1048,8 +1220,11 @@ "ListPortfoliosInput$PageSize": "

The maximum number of items to return with this call.

", "ListPrincipalsForPortfolioInput$PageSize": "

The maximum number of items to return with this call.

", "ListProvisionedProductPlansInput$PageSize": "

The maximum number of items to return with this call.

", + "ListProvisioningArtifactsForServiceActionInput$PageSize": "

The maximum number of items to return with this call.

", "ListRecordHistoryInput$PageSize": "

The maximum number of items to return with this call.

", "ListResourcesForTagOptionInput$PageSize": "

The maximum number of items to return with this call.

", + "ListServiceActionsForProvisioningArtifactInput$PageSize": "

The maximum number of items to return with this call.

", + "ListServiceActionsInput$PageSize": "

The maximum number of items to return with this call.

", "ListTagOptionsInput$PageSize": "

The maximum number of items to return with this call.

", "ScanProvisionedProductsInput$PageSize": "

The maximum number of items to return with this call.

", "SearchProductsAsAdminInput$PageSize": "

The maximum number of items to return with this call.

", @@ -1078,11 +1253,17 @@ "ListPrincipalsForPortfolioOutput$NextPageToken": "

The page token to use to retrieve the next set of results. If there are no additional results, this value is null.

", "ListProvisionedProductPlansInput$PageToken": "

The page token for the next set of results. To retrieve the first set of results, use null.

", "ListProvisionedProductPlansOutput$NextPageToken": "

The page token to use to retrieve the next set of results. If there are no additional results, this value is null.

", + "ListProvisioningArtifactsForServiceActionInput$PageToken": "

The page token for the next set of results. To retrieve the first set of results, use null.

", + "ListProvisioningArtifactsForServiceActionOutput$NextPageToken": "

The page token to use to retrieve the next set of results. If there are no additional results, this value is null.

", "ListProvisioningArtifactsOutput$NextPageToken": "

The page token to use to retrieve the next set of results. If there are no additional results, this value is null.

", "ListRecordHistoryInput$PageToken": "

The page token for the next set of results. To retrieve the first set of results, use null.

", "ListRecordHistoryOutput$NextPageToken": "

The page token to use to retrieve the next set of results. If there are no additional results, this value is null.

", "ListResourcesForTagOptionInput$PageToken": "

The page token for the next set of results. To retrieve the first set of results, use null.

", "ListResourcesForTagOptionOutput$PageToken": "

The page token for the next set of results. To retrieve the first set of results, use null.

", + "ListServiceActionsForProvisioningArtifactInput$PageToken": "

The page token for the next set of results. To retrieve the first set of results, use null.

", + "ListServiceActionsForProvisioningArtifactOutput$NextPageToken": "

The page token to use to retrieve the next set of results. If there are no additional results, this value is null.

", + "ListServiceActionsInput$PageToken": "

The page token for the next set of results. To retrieve the first set of results, use null.

", + "ListServiceActionsOutput$NextPageToken": "

The page token to use to retrieve the next set of results. If there are no additional results, this value is null.

", "ListTagOptionsInput$PageToken": "

The page token for the next set of results. To retrieve the first set of results, use null.

", "ListTagOptionsOutput$PageToken": "

The page token for the next set of results. To retrieve the first set of results, use null.

", "ScanProvisionedProductsInput$PageToken": "

The page token for the next set of results. To retrieve the first set of results, use null.

", @@ -1347,7 +1528,8 @@ "DescribeProductOutput$ProductViewSummary": "

Summary information about the product view.

", "DescribeProductViewOutput$ProductViewSummary": "

Summary information about the product.

", "ProductViewDetail$ProductViewSummary": "

Summary information about the product view.

", - "ProductViewSummaries$member": null + "ProductViewSummaries$member": null, + "ProvisioningArtifactView$ProductViewSummary": "

Summary information about a product view.

" } }, "PropertyName": { @@ -1517,6 +1699,7 @@ "ProvisioningArtifact": { "base": "

Information about a provisioning artifact. A provisioning artifact is also known as a product version.

", "refs": { + "ProvisioningArtifactView$ProvisioningArtifact": "

Information about a provisioning artifact. A provisioning artifact is also known as a product version.

", "ProvisioningArtifacts$member": null } }, @@ -1642,6 +1825,18 @@ "ProvisioningArtifactProperties$Type": "

The type of provisioning artifact.

" } }, + "ProvisioningArtifactView": { + "base": "

An object that contains summary information about a product view and a provisioning artifact.

", + "refs": { + "ProvisioningArtifactViews$member": null + } + }, + "ProvisioningArtifactViews": { + "base": null, + "refs": { + "ListProvisioningArtifactsForServiceActionOutput$ProvisioningArtifactViews": "

An array of objects with information about product views and provisioning artifacts.

" + } + }, "ProvisioningArtifacts": { "base": null, "refs": { @@ -1666,6 +1861,7 @@ "refs": { "DescribeRecordOutput$RecordDetail": "

Information about the product.

", "ExecuteProvisionedProductPlanOutput$RecordDetail": "

Information about the result of provisioning the product.

", + "ExecuteProvisionedProductServiceActionOutput$RecordDetail": "

An object containing detailed information about the result of provisioning the product.

", "ProvisionProductOutput$RecordDetail": "

Information about the result of provisioning the product.

", "RecordDetails$member": null, "TerminateProvisionedProductOutput$RecordDetail": "

Information about the result of this request.

", @@ -1933,6 +2129,96 @@ "SearchProvisionedProductsInput$PageSize": "

The maximum number of items to return with this call.

" } }, + "ServiceActionAssociation": { + "base": "

A self-service action association consisting of the Action ID, the Product ID, and the Provisioning Artifact ID.

", + "refs": { + "ServiceActionAssociations$member": null + } + }, + "ServiceActionAssociationErrorCode": { + "base": null, + "refs": { + "FailedServiceActionAssociation$ErrorCode": "

The error code. Valid values are listed below.

" + } + }, + "ServiceActionAssociationErrorMessage": { + "base": null, + "refs": { + "FailedServiceActionAssociation$ErrorMessage": "

A text description of the error.

" + } + }, + "ServiceActionAssociations": { + "base": null, + "refs": { + "BatchAssociateServiceActionWithProvisioningArtifactInput$ServiceActionAssociations": "

One or more associations, each consisting of the Action ID, the Product ID, and the Provisioning Artifact ID.

", + "BatchDisassociateServiceActionFromProvisioningArtifactInput$ServiceActionAssociations": "

One or more associations, each consisting of the Action ID, the Product ID, and the Provisioning Artifact ID.

" + } + }, + "ServiceActionDefinitionKey": { + "base": null, + "refs": { + "ServiceActionDefinitionMap$key": null + } + }, + "ServiceActionDefinitionMap": { + "base": null, + "refs": { + "CreateServiceActionInput$Definition": "

The self-service action definition. Can be one of the following:

Name

The name of the AWS Systems Manager Document. For example, AWS-RestartEC2Instance.

Version

The AWS Systems Manager automation document version. For example, \"Version\": \"1\"

AssumeRole

The Amazon Resource Name (ARN) of the role that performs the self-service actions on your behalf. For example, \"AssumeRole\": \"arn:aws:iam::12345678910:role/ActionRole\".

To reuse the provisioned product launch role, set to \"AssumeRole\": \"LAUNCH_ROLE\".

Parameters

The list of parameters in JSON format.

For example: [{\\\"Name\\\":\\\"InstanceId\\\",\\\"Type\\\":\\\"TARGET\\\"}].

", + "ServiceActionDetail$Definition": "

A map that defines the self-service action.

", + "UpdateServiceActionInput$Definition": "

A map that defines the self-service action.

" + } + }, + "ServiceActionDefinitionType": { + "base": null, + "refs": { + "CreateServiceActionInput$DefinitionType": "

The service action definition type. For example, SSM_AUTOMATION.

", + "ServiceActionSummary$DefinitionType": "

The self-service action definition type. For example, SSM_AUTOMATION.

" + } + }, + "ServiceActionDefinitionValue": { + "base": null, + "refs": { + "ServiceActionDefinitionMap$value": null + } + }, + "ServiceActionDescription": { + "base": null, + "refs": { + "CreateServiceActionInput$Description": "

The self-service action description.

", + "ServiceActionSummary$Description": "

The self-service action description.

", + "UpdateServiceActionInput$Description": "

The self-service action description.

" + } + }, + "ServiceActionDetail": { + "base": "

An object containing detailed information about the self-service action.

", + "refs": { + "CreateServiceActionOutput$ServiceActionDetail": "

An object containing information about the self-service action.

", + "DescribeServiceActionOutput$ServiceActionDetail": "

Detailed information about the self-service action.

", + "UpdateServiceActionOutput$ServiceActionDetail": "

Detailed information about the self-service action.

" + } + }, + "ServiceActionName": { + "base": null, + "refs": { + "CreateServiceActionInput$Name": "

The self-service action name.

", + "ServiceActionSummary$Name": "

The self-service action name.

", + "UpdateServiceActionInput$Name": "

The self-service action name.

" + } + }, + "ServiceActionSummaries": { + "base": null, + "refs": { + "ListServiceActionsForProvisioningArtifactOutput$ServiceActionSummaries": "

An object containing information about the self-service actions associated with the provisioning artifact.

", + "ListServiceActionsOutput$ServiceActionSummaries": "

An object containing information about the service actions associated with the provisioning artifact.

" + } + }, + "ServiceActionSummary": { + "base": "

Detailed information about the self-service action.

", + "refs": { + "ServiceActionDetail$ServiceActionSummary": "

Summary information about the self-service action.

", + "ServiceActionSummaries$member": null + } + }, "SortField": { "base": null, "refs": { @@ -2209,6 +2495,16 @@ "UpdateProvisionedProductInput$ProvisioningParameters": "

The new parameters.

" } }, + "UpdateServiceActionInput": { + "base": null, + "refs": { + } + }, + "UpdateServiceActionOutput": { + "base": null, + "refs": { + } + }, "UpdateTagOptionInput": { "base": null, "refs": { diff --git a/models/apis/servicecatalog/2015-12-10/paginators-1.json b/models/apis/servicecatalog/2015-12-10/paginators-1.json index e653bfb9025..780d87174b8 100644 --- a/models/apis/servicecatalog/2015-12-10/paginators-1.json +++ b/models/apis/servicecatalog/2015-12-10/paginators-1.json @@ -30,11 +30,26 @@ "output_token": "NextPageToken", "limit_key": "PageSize" }, + "ListProvisioningArtifactsForServiceAction": { + "input_token": "PageToken", + "output_token": "NextPageToken", + "limit_key": "PageSize" + }, "ListResourcesForTagOption": { "input_token": "PageToken", "output_token": "PageToken", "limit_key": "PageSize" }, + "ListServiceActions": { + "input_token": "PageToken", + "output_token": "NextPageToken", + "limit_key": "PageSize" + }, + "ListServiceActionsForProvisioningArtifact": { + "input_token": "PageToken", + "output_token": "NextPageToken", + "limit_key": "PageSize" + }, "ListTagOptions": { "input_token": "PageToken", "output_token": "PageToken", diff --git a/models/apis/transcribe/2017-10-26/api-2.json b/models/apis/transcribe/2017-10-26/api-2.json index 273c5f74909..b004f41c686 100644 --- a/models/apis/transcribe/2017-10-26/api-2.json +++ b/models/apis/transcribe/2017-10-26/api-2.json @@ -28,6 +28,19 @@ {"shape":"ConflictException"} ] }, + "DeleteTranscriptionJob":{ + "name":"DeleteTranscriptionJob", + "http":{ + "method":"POST", + "requestUri":"/" + }, + "input":{"shape":"DeleteTranscriptionJobRequest"}, + "errors":[ + {"shape":"LimitExceededException"}, + {"shape":"BadRequestException"}, + {"shape":"InternalFailureException"} + ] + }, "DeleteVocabulary":{ "name":"DeleteVocabulary", "http":{ @@ -172,6 +185,13 @@ } }, "DateTime":{"type":"timestamp"}, + "DeleteTranscriptionJobRequest":{ + "type":"structure", + "required":["TranscriptionJobName"], + "members":{ + "TranscriptionJobName":{"shape":"TranscriptionJobName"} + } + }, "DeleteVocabularyRequest":{ "type":"structure", "required":["VocabularyName"], @@ -223,7 +243,10 @@ "type":"string", "enum":[ "en-US", - "es-US" + "es-US", + "en-AU", + "fr-CA", + "en-UK" ] }, "LimitExceededException":{ diff --git a/models/apis/transcribe/2017-10-26/docs-2.json b/models/apis/transcribe/2017-10-26/docs-2.json index c75fb568172..967522ec9b1 100644 --- a/models/apis/transcribe/2017-10-26/docs-2.json +++ b/models/apis/transcribe/2017-10-26/docs-2.json @@ -2,18 +2,19 @@ "version": "2.0", "service": "

Operations and objects for transcribing speech to text.

", "operations": { - "CreateVocabulary": "

Creates a new custom vocabulary that you can use to change the way Amazon Transcribe handles transcription of an audio file.

", + "CreateVocabulary": "

Creates a new custom vocabulary that you can use to change the way Amazon Transcribe handles transcription of an audio file. Note that vocabularies for en-AU, en-UK, and fr-CA languages that are in preview are not available. In the console, the vocabulary section will be greyed-out and SDK will return error message.

", + "DeleteTranscriptionJob": "

Deletes a previously submitted transcription job as well as any other generated results such as the transcription, models, and so on.

", "DeleteVocabulary": "

Deletes a vocabulary from Amazon Transcribe.

", "GetTranscriptionJob": "

Returns information about a transcription job. To see the status of the job, check the TranscriptionJobStatus field. If the status is COMPLETED, the job is finished and you can find the results at the location specified in the TranscriptionFileUri field.

", - "GetVocabulary": "

Gets information about a vocabulary.

", + "GetVocabulary": "

Gets information about a vocabulary. Note that vocabularies for en-AU, en-UK, and fr-CA languages that are in preview are not available. In the console, the vocabulary section will be greyed-out and SDK will return error message.

", "ListTranscriptionJobs": "

Lists transcription jobs with the specified status.

", "ListVocabularies": "

Returns a list of vocabularies that match the specified criteria. If no criteria are specified, returns the entire list of vocabularies.

", - "StartTranscriptionJob": "

Starts an asynchronous job to transcribe speech to text.

", - "UpdateVocabulary": "

Updates an existing vocabulary with new values. The UpdateVocabulary operation overwrites all of the existing information with the values that you provide in the request.

" + "StartTranscriptionJob": "

Starts an asynchronous job to transcribe speech to text. Note that en-AU, en-UK, and fr-CA languages are in preview and are only available to whitelisted customers.

", + "UpdateVocabulary": "

Updates an existing vocabulary with new values. The UpdateVocabulary operation overwrites all of the existing information with the values that you provide in the request. Note that vocabularies for en-AU, en-UK, and fr-CA languages that are in preview are not available. In the console, the vocabulary section will be greyed-out and SDK will return error message.

" }, "shapes": { "BadRequestException": { - "base": "

Your request didn't pass one or more validation tests. For example, a name already exists when creating a resource or a name may not exist when getting a transcription job or custom vocabulary. See the exception Message field for more information.

", + "base": "

Your request didn't pass one or more validation tests. For example, if the transcription you're trying to delete doesn't exist of if it is in a non-terminal state (for example, it's \"in progress\"). See the exception Message field for more information.

", "refs": { } }, @@ -52,6 +53,11 @@ "VocabularyInfo$LastModifiedTime": "

The date and time that the vocabulary was last modified.

" } }, + "DeleteTranscriptionJobRequest": { + "base": null, + "refs": { + } + }, "DeleteVocabularyRequest": { "base": null, "refs": { @@ -237,7 +243,7 @@ } }, "TranscriptionJob": { - "base": "

Describes an asynchronous transcription job that was created with the StartTranscriptionJob operation.

", + "base": "

Describes an asynchronous transcription job that was created with the StartTranscriptionJob operation. Note that en-AU, en-UK, and fr-CA languages are in preview and are only available to whitelisted customers.

", "refs": { "GetTranscriptionJobResponse$TranscriptionJob": "

An object that contains the results of the transcription job.

", "StartTranscriptionJobResponse$TranscriptionJob": "

An object containing details of the asynchronous transcription job.

" @@ -246,6 +252,7 @@ "TranscriptionJobName": { "base": null, "refs": { + "DeleteTranscriptionJobRequest$TranscriptionJobName": "

The name of the transcription job to be deleted.

", "GetTranscriptionJobRequest$TranscriptionJobName": "

The name of the job.

", "ListTranscriptionJobsRequest$JobNameContains": "

When specified, the jobs returned in the list are limited to jobs whose name contains the specified string.

", "StartTranscriptionJobRequest$TranscriptionJobName": "

The name of the job. You can't use the strings \".\" or \"..\" in the job name. The name must be unique within an AWS account.

", @@ -270,7 +277,7 @@ } }, "TranscriptionJobSummary": { - "base": "

Provides a summary of information about a transcription job.

", + "base": "

Provides a summary of information about a transcription job. Note that en-AU, en-UK, and fr-CA languages are in preview and are only available to whitelisted customers.

", "refs": { "TranscriptionJobSummaries$member": null } @@ -300,7 +307,7 @@ } }, "VocabularyInfo": { - "base": "

Provides information about a custom vocabulary.

", + "base": "

Provides information about a custom vocabulary. Note that vocabularies for en-AU, en-UK, and fr-CA languages that are in preview are not available. In the console, the vocabulary section will be greyed-out and SDK will return error message.

", "refs": { "Vocabularies$member": null } diff --git a/service/athena/api.go b/service/athena/api.go index c355c79fd12..bbf510b9476 100644 --- a/service/athena/api.go +++ b/service/athena/api.go @@ -1030,7 +1030,8 @@ func (c *Athena) StartQueryExecutionRequest(input *StartQueryExecutionInput) (re // a required parameter may be missing or out of range. // // * ErrCodeTooManyRequestsException "TooManyRequestsException" -// Indicates that the request was throttled. +// Indicates that the request was throttled and includes the reason for throttling, +// for example, the limit of concurrent queries has been exceeded. // // See also, https://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/StartQueryExecution func (c *Athena) StartQueryExecution(input *StartQueryExecutionInput) (*StartQueryExecutionOutput, error) { @@ -1604,8 +1605,8 @@ func (s DeleteNamedQueryOutput) GoString() string { return s.String() } -// If query results are encrypted in Amazon S3, indicates the Amazon S3 encryption -// option used. +// If query results are encrypted in Amazon S3, indicates the encryption option +// used (for example, SSE-KMS or CSE-KMS) and key information. type EncryptionConfiguration struct { _ struct{} `type:"structure"` @@ -1842,6 +1843,9 @@ type GetQueryResultsOutput struct { // The results of the query execution. ResultSet *ResultSet `type:"structure"` + + // The number of rows inserted with a CREATE TABLE AS SELECT statement. + UpdateCount *int64 `type:"long"` } // String returns the string representation @@ -1866,6 +1870,12 @@ func (s *GetQueryResultsOutput) SetResultSet(v *ResultSet) *GetQueryResultsOutpu return s } +// SetUpdateCount sets the UpdateCount field's value. +func (s *GetQueryResultsOutput) SetUpdateCount(v int64) *GetQueryResultsOutput { + s.UpdateCount = &v + return s +} + type ListNamedQueriesInput struct { _ struct{} `type:"structure"` @@ -2080,8 +2090,14 @@ type QueryExecution struct { // option, if any, used for query results. ResultConfiguration *ResultConfiguration `type:"structure"` + // The type of query statement that was run. DDL indicates DDL query statements. + // DML indicates DML (Data Manipulation Language) query statements, such as + // CREATE TABLE AS SELECT. UTILITY indicates query statements other than DDL + // and DML, such as SHOW CREATE TABLE, or DESCRIBE . + StatementType *string `type:"string" enum:"StatementType"` + // The amount of data scanned during the query execution and the amount of time - // that it took to execute. + // that it took to execute, and the type of statement that was run. Statistics *QueryExecutionStatistics `type:"structure"` // The completion date, current state, submission time, and state change reason @@ -2123,6 +2139,12 @@ func (s *QueryExecution) SetResultConfiguration(v *ResultConfiguration) *QueryEx return s } +// SetStatementType sets the StatementType field's value. +func (s *QueryExecution) SetStatementType(v string) *QueryExecution { + s.StatementType = &v + return s +} + // SetStatistics sets the Statistics field's value. func (s *QueryExecution) SetStatistics(v *QueryExecutionStatistics) *QueryExecution { s.Statistics = v @@ -2173,7 +2195,7 @@ func (s *QueryExecutionContext) SetDatabase(v string) *QueryExecutionContext { } // The amount of data scanned during the query execution and the amount of time -// that it took to execute. +// that it took to execute, and the type of statement that was run. type QueryExecutionStatistics struct { _ struct{} `type:"structure"` @@ -2214,11 +2236,12 @@ type QueryExecutionStatus struct { // The date and time that the query completed. CompletionDateTime *time.Time `type:"timestamp"` - // 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. + // The state of query execution. QUEUED state is listed but is not used by Athena + // and is reserved for future use. RUNNING indicates that the query has been + // submitted to the service, and Athena will execute the query as soon as resources + // are available. 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. @@ -2267,11 +2290,12 @@ func (s *QueryExecutionStatus) SetSubmissionDateTime(v time.Time) *QueryExecutio 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. + // If query results are encrypted in Amazon S3, indicates the 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. + // The location in Amazon S3 where your query results are stored, such as s3://path/to/query/bucket/. + // For more information, see Queries and Query Result Files. (http://docs.aws.amazon.com/athena/latest/ug/querying.html) // // OutputLocation is a required field OutputLocation *string `type:"string" required:"true"` @@ -2357,7 +2381,7 @@ func (s *ResultSet) SetRows(v []*Row) *ResultSet { type ResultSetMetadata struct { _ struct{} `type:"structure"` - // Information about the columns in a query execution result. + // Information about the columns returned in a query result metadata. ColumnInfo []*ColumnInfo `type:"list"` } @@ -2696,6 +2720,19 @@ const ( QueryExecutionStateCancelled = "CANCELLED" ) +const ( + // StatementTypeDdl is a StatementType enum value + StatementTypeDdl = "DDL" + + // StatementTypeDml is a StatementType enum value + StatementTypeDml = "DML" + + // StatementTypeUtility is a StatementType enum value + StatementTypeUtility = "UTILITY" +) + +// The reason for the query throttling, for example, when it exceeds the concurrent +// query limit. const ( // ThrottleReasonConcurrentQueryLimitExceeded is a ThrottleReason enum value ThrottleReasonConcurrentQueryLimitExceeded = "CONCURRENT_QUERY_LIMIT_EXCEEDED" diff --git a/service/athena/doc.go b/service/athena/doc.go index 920fafc0c73..76b6b8989bb 100644 --- a/service/athena/doc.go +++ b/service/athena/doc.go @@ -12,8 +12,13 @@ // 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. // +// If you connect to Athena using the JDBC driver, use version 1.1.0 of the +// driver or later with the Amazon Athena API. Earlier version drivers do not +// support the API. For more information and to download the driver, see Accessing +// Amazon Athena with JDBC (https://docs.aws.amazon.com/athena/latest/ug/connect-with-jdbc.html). +// // 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 +// (https://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. diff --git a/service/athena/errors.go b/service/athena/errors.go index 4060e744e36..abfa4fac398 100644 --- a/service/athena/errors.go +++ b/service/athena/errors.go @@ -21,6 +21,7 @@ const ( // ErrCodeTooManyRequestsException for service response error code // "TooManyRequestsException". // - // Indicates that the request was throttled. + // Indicates that the request was throttled and includes the reason for throttling, + // for example, the limit of concurrent queries has been exceeded. ErrCodeTooManyRequestsException = "TooManyRequestsException" ) diff --git a/service/cloudtrail/api.go b/service/cloudtrail/api.go index 155ea1d2c00..4ce19ade045 100644 --- a/service/cloudtrail/api.go +++ b/service/cloudtrail/api.go @@ -77,7 +77,7 @@ func (c *CloudTrail) AddTagsRequest(input *AddTagsInput) (req *request.Request, // This exception is thrown when an operation is called with an invalid trail // ARN. The format of a trail ARN is: // -// arn:aws:cloudtrail:us-east-1:123456789012:trail/MyTrail +// arn:aws:cloudtrail:us-east-2:123456789012:trail/MyTrail // // * ErrCodeResourceTypeNotSupportedException "ResourceTypeNotSupportedException" // This exception is thrown when the specified resource type is not supported @@ -524,12 +524,13 @@ func (c *CloudTrail) GetEventSelectorsRequest(input *GetEventSelectorsInput) (re // Describes the settings for the event selectors that you configured for your // trail. The information returned for your event selectors includes the following: // -// * The S3 objects that you are logging for data events. +// * If your event selector includes read-only events, write-only events, +// or all events. This applies to both management events and data events. // // * If your event selector includes management events. // -// * If your event selector includes read-only events, write-only events, -// or all. +// * If your event selector includes data events, the Amazon S3 objects or +// AWS Lambda functions that you are logging for data events. // // For more information, see Logging Data and Management Events for Trails // (http://docs.aws.amazon.com/awscloudtrail/latest/userguide/logging-management-and-data-events-with-cloudtrail.html) @@ -846,7 +847,7 @@ func (c *CloudTrail) ListTagsRequest(input *ListTagsInput) (req *request.Request // This exception is thrown when an operation is called with an invalid trail // ARN. The format of a trail ARN is: // -// arn:aws:cloudtrail:us-east-1:123456789012:trail/MyTrail +// arn:aws:cloudtrail:us-east-2:123456789012:trail/MyTrail // // * ErrCodeResourceTypeNotSupportedException "ResourceTypeNotSupportedException" // This exception is thrown when the specified resource type is not supported @@ -949,10 +950,11 @@ func (c *CloudTrail) LookupEventsRequest(input *LookupEventsInput) (req *request // LookupEvents API operation for AWS CloudTrail. // -// Looks up API activity events captured by CloudTrail that create, update, -// or delete resources in your account. Events for a region can be looked up -// for the times in which you had CloudTrail turned on in that region during -// the last seven days. Lookup supports the following attributes: +// Looks up management events (https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-concepts.html#cloudtrail-concepts-management-events) +// captured by CloudTrail. Events for a region can be looked up in that region +// during the last 90 days. Lookup supports the following attributes: +// +// * AWS access key // // * Event ID // @@ -960,13 +962,15 @@ func (c *CloudTrail) LookupEventsRequest(input *LookupEventsInput) (req *request // // * Event source // +// * Read only +// // * Resource name // // * Resource type // // * User name // -// All attributes are optional. The default number of results returned is 10, +// All attributes are optional. The default number of results returned is 50, // with a maximum of 50 possible. The response includes a token that you can // use to get the next page of results. // @@ -1114,10 +1118,13 @@ func (c *CloudTrail) PutEventSelectorsRequest(input *PutEventSelectorsInput) (re // PutEventSelectors API operation for AWS CloudTrail. // -// Configures an event selector for your trail. Use event selectors to specify -// whether you want your trail to log management and/or data events. When an -// event occurs in your account, CloudTrail evaluates the event selectors in -// all trails. For each trail, if the event matches any event selector, the +// Configures an event selector for your trail. Use event selectors to further +// specify the management and data event settings for your trail. By default, +// trails created without specific event selectors will be configured to log +// all read and write management events, and no data events. +// +// When an event occurs in your account, CloudTrail evaluates the event selectors +// in all trails. For each trail, if the event matches any event selector, the // trail processes and logs the event. If the event doesn't match any event // selector, the trail doesn't log the event. // @@ -1141,6 +1148,7 @@ func (c *CloudTrail) PutEventSelectorsRequest(input *PutEventSelectorsInput) (re // // You can configure up to five event selectors for each trail. For more information, // see Logging Data and Management Events for Trails (http://docs.aws.amazon.com/awscloudtrail/latest/userguide/logging-management-and-data-events-with-cloudtrail.html) +// and Limits in AWS CloudTrail (https://docs.aws.amazon.com/awscloudtrail/latest/userguide/WhatIsCloudTrail-Limits.html) // in the AWS CloudTrail User Guide. // // Returns awserr.Error for service API and SDK errors. Use runtime type assertions @@ -1176,12 +1184,21 @@ func (c *CloudTrail) PutEventSelectorsRequest(input *PutEventSelectorsInput) (re // // * ErrCodeInvalidEventSelectorsException "InvalidEventSelectorsException" // This exception is thrown when the PutEventSelectors operation is called with -// an invalid number of event selectors, data resources, or an invalid value -// for a parameter: +// a number of event selectors or data resources that is not valid. The combination +// of event selectors and data resources is not valid. A trail can have up to +// 5 event selectors. A trail is limited to 250 data resources. These data resources +// can be distributed across event selectors, but the overall total cannot exceed +// 250. +// +// You can: // // * Specify a valid number of event selectors (1 to 5) for a trail. // // * Specify a valid number of data resources (1 to 250) for an event selector. +// The limit of number of resources on an individual event selector is configurable +// up to 250. However, this upper limit is allowed only if the total number +// of data resources does not exceed 250 across all event selectors for a +// trail. // // * Specify a valid value for a parameter. For example, specifying the ReadWriteType // parameter with a value of read-only is invalid. @@ -1275,7 +1292,7 @@ func (c *CloudTrail) RemoveTagsRequest(input *RemoveTagsInput) (req *request.Req // This exception is thrown when an operation is called with an invalid trail // ARN. The format of a trail ARN is: // -// arn:aws:cloudtrail:us-east-1:123456789012:trail/MyTrail +// arn:aws:cloudtrail:us-east-2:123456789012:trail/MyTrail // // * ErrCodeResourceTypeNotSupportedException "ResourceTypeNotSupportedException" // This exception is thrown when the specified resource type is not supported @@ -1706,7 +1723,7 @@ type AddTagsInput struct { // Specifies the ARN of the trail to which one or more tags will be added. The // format of a trail ARN is: // - // arn:aws:cloudtrail:us-east-1:123456789012:trail/MyTrail + // arn:aws:cloudtrail:us-east-2:123456789012:trail/MyTrail // // ResourceId is a required field ResourceId *string `type:"string" required:"true"` @@ -1818,9 +1835,9 @@ type CreateTrailInput struct { // // * alias/MyAliasName // - // * arn:aws:kms:us-east-1:123456789012:alias/MyAliasName + // * arn:aws:kms:us-east-2:123456789012:alias/MyAliasName // - // * arn:aws:kms:us-east-1:123456789012:key/12345678-1234-1234-1234-123456789012 + // * arn:aws:kms:us-east-2:123456789012:key/12345678-1234-1234-1234-123456789012 // // * 12345678-1234-1234-1234-123456789012 KmsKeyId *string `type:"string"` @@ -1968,7 +1985,7 @@ type CreateTrailOutput struct { // Specifies the KMS key ID that encrypts the logs delivered by CloudTrail. // The value is a fully specified ARN to a KMS key in the format: // - // arn:aws:kms:us-east-1:123456789012:key/12345678-1234-1234-1234-123456789012 + // arn:aws:kms:us-east-2:123456789012:key/12345678-1234-1234-1234-123456789012 KmsKeyId *string `type:"string"` // Specifies whether log file integrity validation is enabled. @@ -1989,7 +2006,7 @@ type CreateTrailOutput struct { // Specifies the ARN of the Amazon SNS topic that CloudTrail uses to send notifications // when log files are delivered. The format of a topic ARN is: // - // arn:aws:sns:us-east-1:123456789012:MyTopic + // arn:aws:sns:us-east-2:123456789012:MyTopic SnsTopicARN *string `type:"string"` // This field is deprecated. Use SnsTopicARN. @@ -2000,7 +2017,7 @@ type CreateTrailOutput struct { // Specifies the ARN of the trail that was created. The format of a trail ARN // is: // - // arn:aws:cloudtrail:us-east-1:123456789012:trail/MyTrail + // arn:aws:cloudtrail:us-east-2:123456789012:trail/MyTrail TrailARN *string `type:"string"` } @@ -2086,41 +2103,93 @@ func (s *CreateTrailOutput) SetTrailARN(v string) *CreateTrailOutput { return s } -// The Amazon S3 objects that you specify in your event selectors for your trail -// to log data events. Data events are object-level API operations that access -// S3 objects, such as GetObject, DeleteObject, and PutObject. You can specify -// up to 250 S3 buckets and object prefixes for a trail. +// The Amazon S3 buckets or AWS Lambda functions that you specify in your event +// selectors for your trail to log data events. Data events provide insight +// into the resource operations performed on or within a resource itself. These +// are also known as data plane operations. You can specify up to 250 data resources +// for a trail. // -// Example +// The total number of allowed data resources is 250. This number can be distributed +// between 1 and 5 event selectors, but the total cannot exceed 250 across all +// selectors. +// +// The following example demonstrates how logging works when you configure logging +// of all data events for an S3 bucket named bucket-1. In this example, the +// CloudTrail user spcified an empty prefix, and the option to log both Read +// and Write data events. // -// You create an event selector for a trail and specify an S3 bucket and an -// empty prefix, such as arn:aws:s3:::bucket-1/. +// A user uploads an image file to bucket-1. // -// You upload an image file to bucket-1. +// The PutObject API operation is an Amazon S3 object-level API. It is recorded +// as a data event in CloudTrail. Because the CloudTrail user specified an S3 +// bucket with an empty prefix, events that occur on any object in that bucket +// are logged. The trail processes and logs the event. // -// The PutObject API operation occurs on an object in the S3 bucket that you -// specified in the event selector. The trail processes and logs the event. +// A user uploads an object to an Amazon S3 bucket named arn:aws:s3:::bucket-2. // -// You upload another image file to a different S3 bucket named arn:aws:s3:::bucket-2. +// The PutObject API operation occurred for an object in an S3 bucket that the +// CloudTrail user didn't specify for the trail. The trail doesn’t log the event. // -// The event occurs on an object in an S3 bucket that you didn't specify in -// the event selector. The trail doesn’t log the event. +// The following example demonstrates how logging works when you configure logging +// of AWS Lambda data events for a Lambda function named MyLambdaFunction, but +// not for all AWS Lambda functions. +// +// A user runs a script that includes a call to the MyLambdaFunction function +// and the MyOtherLambdaFunction function. +// +// The Invoke API operation on MyLambdaFunction is an AWS Lambda API. It is +// recorded as a data event in CloudTrail. Because the CloudTrail user specified +// logging data events for MyLambdaFunction, any invocations of that function +// are logged. The trail processes and logs the event. +// +// The Invoke API operation on MyOtherLambdaFunction is an AWS Lambda API. Because +// the CloudTrail user did not specify logging data events for all Lambda functions, +// the Invoke operation for MyOtherLambdaFunction does not match the function +// specified for the trail. The trail doesn’t log the event. type DataResource struct { _ struct{} `type:"structure"` - // The resource type in which you want to log data events. You can specify only - // the following value: AWS::S3::Object. + // The resource type in which you want to log data events. You can specify AWS::S3::Object + // or AWS::Lambda::Function resources. Type *string `type:"string"` - // A list of ARN-like strings for the specified S3 objects. + // An array of Amazon Resource Name (ARN) strings or partial ARN strings for + // the specified objects. + // + // * To log data events for all objects in all S3 buckets in your AWS account, + // specify the prefix as arn:aws:s3:::. + // + // This will also enable logging of data event activity performed by any user + // or role in your AWS account, even if that activity is performed on a bucket + // that belongs to another AWS account. + // + // * To log data events for all objects in all S3 buckets that include my-bucket + // in their names, specify the prefix as aws:s3:::my-bucket. The trail logs + // data events for all objects in all buckets whose name contains a match + // for my-bucket. + // + // * To log data events for all objects in an S3 bucket, specify the bucket + // and an empty object prefix such as arn:aws:s3:::bucket-1/. The trail logs + // data events for all objects in this S3 bucket. // - // To log data events for all objects in an S3 bucket, specify the bucket and - // an empty object prefix such as arn:aws:s3:::bucket-1/. The trail logs data - // events for all objects in this S3 bucket. + // * To log data events for specific objects, specify the S3 bucket and object + // prefix such as arn:aws:s3:::bucket-1/example-images. The trail logs data + // events for objects in this S3 bucket that match the prefix. // - // To log data events for specific objects, specify the S3 bucket and object - // prefix such as arn:aws:s3:::bucket-1/example-images. The trail logs data - // events for objects in this S3 bucket that match the prefix. + // * To log data events for all functions in your AWS account, specify the + // prefix as arn:aws:lambda. + // + // This will also enable logging of Invoke activity performed by any user or + // role in your AWS account, even if that activity is performed on a function + // that belongs to another AWS account. + // + // * To log data eents for a specific Lambda function, specify the function + // ARN. + // + // Lambda function ARNs are exact. Unlike S3, you cannot use matching. For example, + // if you specify a function ARN arn:aws:lambda:us-west-2:111111111111:function:helloworld, + // data events will only be logged for arn:aws:lambda:us-west-2:111111111111:function:helloworld. + // They will not be logged for arn:aws:lambda:us-west-2:111111111111:function:helloworld2. Values []*string `type:"list"` } @@ -2151,7 +2220,7 @@ type DeleteTrailInput struct { _ struct{} `type:"structure"` // Specifies the name or the CloudTrail ARN of the trail to be deleted. The - // format of a trail ARN is: arn:aws:cloudtrail:us-east-1:123456789012:trail/MyTrail + // format of a trail ARN is: arn:aws:cloudtrail:us-east-2:123456789012:trail/MyTrail // // Name is a required field Name *string `type:"string" required:"true"` @@ -2214,7 +2283,7 @@ type DescribeTrailsInput struct { // Specifies a list of trail names, trail ARNs, or both, of the trails to describe. // The format of a trail ARN is: // - // arn:aws:cloudtrail:us-east-1:123456789012:trail/MyTrail + // arn:aws:cloudtrail:us-east-2:123456789012:trail/MyTrail // // If an empty list is specified, information for the trail in the current region // is returned. @@ -2285,6 +2354,11 @@ func (s *DescribeTrailsOutput) SetTrailList(v []*Trail) *DescribeTrailsOutput { type Event struct { _ struct{} `type:"structure"` + // The AWS access key ID that was used to sign the request. If the request was + // made with temporary security credentials, this is the access key ID of the + // temporary credentials. + AccessKeyId *string `type:"string"` + // A JSON string that contains a representation of the event returned. CloudTrailEvent *string `type:"string"` @@ -2300,6 +2374,9 @@ type Event struct { // The date and time of the event returned. EventTime *time.Time `type:"timestamp"` + // Information about whether the event is a write event or a read event. + ReadOnly *string `type:"string"` + // A list of resources referenced by the event returned. Resources []*Resource `type:"list"` @@ -2318,6 +2395,12 @@ func (s Event) GoString() string { return s.String() } +// SetAccessKeyId sets the AccessKeyId field's value. +func (s *Event) SetAccessKeyId(v string) *Event { + s.AccessKeyId = &v + return s +} + // SetCloudTrailEvent sets the CloudTrailEvent field's value. func (s *Event) SetCloudTrailEvent(v string) *Event { s.CloudTrailEvent = &v @@ -2348,6 +2431,12 @@ func (s *Event) SetEventTime(v time.Time) *Event { return s } +// SetReadOnly sets the ReadOnly field's value. +func (s *Event) SetReadOnly(v string) *Event { + s.ReadOnly = &v + return s +} + // SetResources sets the Resources field's value. func (s *Event) SetResources(v []*Resource) *Event { s.Resources = v @@ -2360,20 +2449,26 @@ func (s *Event) SetUsername(v string) *Event { return s } -// Use event selectors to specify whether you want your trail to log management -// and/or data events. When an event occurs in your account, CloudTrail evaluates -// the event selector for all trails. For each trail, if the event matches any -// event selector, the trail processes and logs the event. If the event doesn't -// match any event selector, the trail doesn't log the event. +// Use event selectors to further specify the management and data event settings +// for your trail. By default, trails created without specific event selectors +// will be configured to log all read and write management events, and no data +// events. When an event occurs in your account, CloudTrail evaluates the event +// selector for all trails. For each trail, if the event matches any event selector, +// the trail processes and logs the event. If the event doesn't match any event +// selector, the trail doesn't log the event. // // You can configure up to five event selectors for a trail. type EventSelector struct { _ struct{} `type:"structure"` - // CloudTrail supports logging only data events for S3 objects. You can specify - // up to 250 S3 buckets and object prefixes for a trail. + // CloudTrail supports data event logging for Amazon S3 objects and AWS Lambda + // functions. You can specify up to 250 resources for an individual event selector, + // but the total number of data resources cannot exceed 250 across all event + // selectors in a trail. This limit does not apply if you configure resource + // logging for all data events. // // For more information, see Data Events (http://docs.aws.amazon.com/awscloudtrail/latest/userguide/logging-management-and-data-events-with-cloudtrail.html#logging-data-events) + // and Limits in AWS CloudTrail (https://docs.aws.amazon.com/awscloudtrail/latest/userguide/WhatIsCloudTrail-Limits.html) // in the AWS CloudTrail User Guide. DataResources []*DataResource `type:"list"` @@ -2436,13 +2531,13 @@ type GetEventSelectorsInput struct { // * Be between 3 and 128 characters // // * Have no adjacent periods, underscores or dashes. Names like my-_namespace - // and my--namespace are invalid. + // and my--namespace are not valid. // // * Not be in IP address format (for example, 192.168.5.4) // // If you specify a trail ARN, it must be in the format: // - // arn:aws:cloudtrail:us-east-1:123456789012:trail/MyTrail + // arn:aws:cloudtrail:us-east-2:123456789012:trail/MyTrail // // TrailName is a required field TrailName *string `type:"string" required:"true"` @@ -2517,7 +2612,7 @@ type GetTrailStatusInput struct { // status. To get the status of a shadow trail (a replication of the trail in // another region), you must specify its ARN. The format of a trail ARN is: // - // arn:aws:cloudtrail:us-east-1:123456789012:trail/MyTrail + // arn:aws:cloudtrail:us-east-2:123456789012:trail/MyTrail // // Name is a required field Name *string `type:"string" required:"true"` @@ -2837,7 +2932,7 @@ type ListTagsInput struct { // Specifies a list of trail ARNs whose tags will be listed. The list has a // limit of 20 ARNs. The format of a trail ARN is: // - // arn:aws:cloudtrail:us-east-1:123456789012:trail/MyTrail + // arn:aws:cloudtrail:us-east-2:123456789012:trail/MyTrail // // ResourceIdList is a required field ResourceIdList []*string `type:"list" required:"true"` @@ -2979,7 +3074,7 @@ type LookupEventsInput struct { LookupAttributes []*LookupAttribute `type:"list"` // The number of events to return. Possible values are 1 through 50. The default - // is 10. + // is 50. MaxResults *int64 `min:"1" type:"integer"` // The token to use to get the next page of results after a previous API call. @@ -3176,7 +3271,7 @@ type PutEventSelectorsInput struct { // // If you specify a trail ARN, it must be in the format: // - // arn:aws:cloudtrail:us-east-1:123456789012:trail/MyTrail + // arn:aws:cloudtrail:us-east-2:123456789012:trail/MyTrail // // TrailName is a required field TrailName *string `type:"string" required:"true"` @@ -3229,7 +3324,7 @@ type PutEventSelectorsOutput struct { // Specifies the ARN of the trail that was updated with event selectors. The // format of a trail ARN is: // - // arn:aws:cloudtrail:us-east-1:123456789012:trail/MyTrail + // arn:aws:cloudtrail:us-east-2:123456789012:trail/MyTrail TrailARN *string `type:"string"` } @@ -3262,7 +3357,7 @@ type RemoveTagsInput struct { // Specifies the ARN of the trail from which tags should be removed. The format // of a trail ARN is: // - // arn:aws:cloudtrail:us-east-1:123456789012:trail/MyTrail + // arn:aws:cloudtrail:us-east-2:123456789012:trail/MyTrail // // ResourceId is a required field ResourceId *string `type:"string" required:"true"` @@ -3412,7 +3507,7 @@ type StartLoggingInput struct { // Specifies the name or the CloudTrail ARN of the trail for which CloudTrail // logs AWS API calls. The format of a trail ARN is: // - // arn:aws:cloudtrail:us-east-1:123456789012:trail/MyTrail + // arn:aws:cloudtrail:us-east-2:123456789012:trail/MyTrail // // Name is a required field Name *string `type:"string" required:"true"` @@ -3471,7 +3566,7 @@ type StopLoggingInput struct { // Specifies the name or the CloudTrail ARN of the trail for which CloudTrail // will stop logging AWS API calls. The format of a trail ARN is: // - // arn:aws:cloudtrail:us-east-1:123456789012:trail/MyTrail + // arn:aws:cloudtrail:us-east-2:123456789012:trail/MyTrail // // Name is a required field Name *string `type:"string" required:"true"` @@ -3600,7 +3695,7 @@ type Trail struct { // Specifies the KMS key ID that encrypts the logs delivered by CloudTrail. // The value is a fully specified ARN to a KMS key in the format: // - // arn:aws:kms:us-east-1:123456789012:key/12345678-1234-1234-1234-123456789012 + // arn:aws:kms:us-east-2:123456789012:key/12345678-1234-1234-1234-123456789012 KmsKeyId *string `type:"string"` // Specifies whether log file validation is enabled. @@ -3622,7 +3717,7 @@ type Trail struct { // Specifies the ARN of the Amazon SNS topic that CloudTrail uses to send notifications // when log files are delivered. The format of a topic ARN is: // - // arn:aws:sns:us-east-1:123456789012:MyTopic + // arn:aws:sns:us-east-2:123456789012:MyTopic SnsTopicARN *string `type:"string"` // This field is deprecated. Use SnsTopicARN. @@ -3632,7 +3727,7 @@ type Trail struct { // Specifies the ARN of the trail. The format of a trail ARN is: // - // arn:aws:cloudtrail:us-east-1:123456789012:trail/MyTrail + // arn:aws:cloudtrail:us-east-2:123456789012:trail/MyTrail TrailARN *string `type:"string"` } @@ -3775,9 +3870,9 @@ type UpdateTrailInput struct { // // * alias/MyAliasName // - // * arn:aws:kms:us-east-1:123456789012:alias/MyAliasName + // * arn:aws:kms:us-east-2:123456789012:alias/MyAliasName // - // * arn:aws:kms:us-east-1:123456789012:key/12345678-1234-1234-1234-123456789012 + // * arn:aws:kms:us-east-2:123456789012:key/12345678-1234-1234-1234-123456789012 // // * 12345678-1234-1234-1234-123456789012 KmsKeyId *string `type:"string"` @@ -3799,7 +3894,7 @@ type UpdateTrailInput struct { // // If Name is a trail ARN, it must be in the format: // - // arn:aws:cloudtrail:us-east-1:123456789012:trail/MyTrail + // arn:aws:cloudtrail:us-east-2:123456789012:trail/MyTrail // // Name is a required field Name *string `type:"string" required:"true"` @@ -3925,7 +4020,7 @@ type UpdateTrailOutput struct { // Specifies the KMS key ID that encrypts the logs delivered by CloudTrail. // The value is a fully specified ARN to a KMS key in the format: // - // arn:aws:kms:us-east-1:123456789012:key/12345678-1234-1234-1234-123456789012 + // arn:aws:kms:us-east-2:123456789012:key/12345678-1234-1234-1234-123456789012 KmsKeyId *string `type:"string"` // Specifies whether log file integrity validation is enabled. @@ -3946,7 +4041,7 @@ type UpdateTrailOutput struct { // Specifies the ARN of the Amazon SNS topic that CloudTrail uses to send notifications // when log files are delivered. The format of a topic ARN is: // - // arn:aws:sns:us-east-1:123456789012:MyTopic + // arn:aws:sns:us-east-2:123456789012:MyTopic SnsTopicARN *string `type:"string"` // This field is deprecated. Use SnsTopicARN. @@ -3957,7 +4052,7 @@ type UpdateTrailOutput struct { // Specifies the ARN of the trail that was updated. The format of a trail ARN // is: // - // arn:aws:cloudtrail:us-east-1:123456789012:trail/MyTrail + // arn:aws:cloudtrail:us-east-2:123456789012:trail/MyTrail TrailARN *string `type:"string"` } @@ -4050,6 +4145,9 @@ const ( // LookupAttributeKeyEventName is a LookupAttributeKey enum value LookupAttributeKeyEventName = "EventName" + // LookupAttributeKeyReadOnly is a LookupAttributeKey enum value + LookupAttributeKeyReadOnly = "ReadOnly" + // LookupAttributeKeyUsername is a LookupAttributeKey enum value LookupAttributeKeyUsername = "Username" @@ -4061,6 +4159,9 @@ const ( // LookupAttributeKeyEventSource is a LookupAttributeKey enum value LookupAttributeKeyEventSource = "EventSource" + + // LookupAttributeKeyAccessKeyId is a LookupAttributeKey enum value + LookupAttributeKeyAccessKeyId = "AccessKeyId" ) const ( diff --git a/service/cloudtrail/errors.go b/service/cloudtrail/errors.go index 0ee616cbe2d..b1246dca2e0 100644 --- a/service/cloudtrail/errors.go +++ b/service/cloudtrail/errors.go @@ -10,7 +10,7 @@ const ( // This exception is thrown when an operation is called with an invalid trail // ARN. The format of a trail ARN is: // - // arn:aws:cloudtrail:us-east-1:123456789012:trail/MyTrail + // arn:aws:cloudtrail:us-east-2:123456789012:trail/MyTrail ErrCodeARNInvalidException = "CloudTrailARNInvalidException" // ErrCodeCloudWatchLogsDeliveryUnavailableException for service response error code @@ -54,12 +54,21 @@ const ( // "InvalidEventSelectorsException". // // This exception is thrown when the PutEventSelectors operation is called with - // an invalid number of event selectors, data resources, or an invalid value - // for a parameter: + // a number of event selectors or data resources that is not valid. The combination + // of event selectors and data resources is not valid. A trail can have up to + // 5 event selectors. A trail is limited to 250 data resources. These data resources + // can be distributed across event selectors, but the overall total cannot exceed + // 250. + // + // You can: // // * Specify a valid number of event selectors (1 to 5) for a trail. // // * Specify a valid number of data resources (1 to 250) for an event selector. + // The limit of number of resources on an individual event selector is configurable + // up to 250. However, this upper limit is allowed only if the total number + // of data resources does not exceed 250 across all event selectors for a + // trail. // // * Specify a valid value for a parameter. For example, specifying the ReadWriteType // parameter with a value of read-only is invalid. diff --git a/service/comprehend/api.go b/service/comprehend/api.go index f52ab348f24..87c9c1ac0e3 100644 --- a/service/comprehend/api.go +++ b/service/comprehend/api.go @@ -7286,6 +7286,18 @@ const ( // LanguageCodeEs is a LanguageCode enum value LanguageCodeEs = "es" + + // LanguageCodeFr is a LanguageCode enum value + LanguageCodeFr = "fr" + + // LanguageCodeDe is a LanguageCode enum value + LanguageCodeDe = "de" + + // LanguageCodeIt is a LanguageCode enum value + LanguageCodeIt = "it" + + // LanguageCodePt is a LanguageCode enum value + LanguageCodePt = "pt" ) const ( @@ -7358,4 +7370,19 @@ const ( const ( // SyntaxLanguageCodeEn is a SyntaxLanguageCode enum value SyntaxLanguageCodeEn = "en" + + // SyntaxLanguageCodeEs is a SyntaxLanguageCode enum value + SyntaxLanguageCodeEs = "es" + + // SyntaxLanguageCodeFr is a SyntaxLanguageCode enum value + SyntaxLanguageCodeFr = "fr" + + // SyntaxLanguageCodeDe is a SyntaxLanguageCode enum value + SyntaxLanguageCodeDe = "de" + + // SyntaxLanguageCodeIt is a SyntaxLanguageCode enum value + SyntaxLanguageCodeIt = "it" + + // SyntaxLanguageCodePt is a SyntaxLanguageCode enum value + SyntaxLanguageCodePt = "pt" ) diff --git a/service/directconnect/api.go b/service/directconnect/api.go index ea7764790f7..cfb3454eed3 100644 --- a/service/directconnect/api.go +++ b/service/directconnect/api.go @@ -60,14 +60,14 @@ func (c *DirectConnect) AllocateConnectionOnInterconnectRequest(input *AllocateC // AllocateConnectionOnInterconnect API operation for AWS Direct Connect. // -// Deprecated in favor of AllocateHostedConnection. +// Deprecated. Use AllocateHostedConnection instead. // // Creates a hosted connection on an interconnect. // // Allocates a VLAN number and a specified amount of bandwidth for use by a -// hosted connection on the given interconnect. +// hosted connection on the specified interconnect. // -// This is intended for use by AWS Direct Connect partners only. +// Intended for use by AWS Direct Connect partners only. // // 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 @@ -78,12 +78,10 @@ func (c *DirectConnect) AllocateConnectionOnInterconnectRequest(input *AllocateC // // Returned Error Codes: // * ErrCodeServerException "DirectConnectServerException" -// A server-side error occurred during the API call. The error message will -// contain additional details about the cause. +// A server-side error occurred. // // * ErrCodeClientException "DirectConnectClientException" -// The API was called with invalid parameters. The error message will contain -// additional details about the cause. +// One or more parameters are not valid. // // See also, https://docs.aws.amazon.com/goto/WebAPI/directconnect-2012-10-25/AllocateConnectionOnInterconnect // @@ -155,13 +153,13 @@ func (c *DirectConnect) AllocateHostedConnectionRequest(input *AllocateHostedCon // AllocateHostedConnection API operation for AWS Direct Connect. // -// Creates a hosted connection on an interconnect or a link aggregation group -// (LAG). +// Creates a hosted connection on the specified interconnect or a link aggregation +// group (LAG). // // Allocates a VLAN number and a specified amount of bandwidth for use by a -// hosted connection on the given interconnect or LAG. +// hosted connection on the specified interconnect or LAG. // -// This is intended for use by AWS Direct Connect partners only. +// Intended for use by AWS Direct Connect partners only. // // 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 @@ -172,12 +170,10 @@ func (c *DirectConnect) AllocateHostedConnectionRequest(input *AllocateHostedCon // // Returned Error Codes: // * ErrCodeServerException "DirectConnectServerException" -// A server-side error occurred during the API call. The error message will -// contain additional details about the cause. +// A server-side error occurred. // // * ErrCodeClientException "DirectConnectClientException" -// The API was called with invalid parameters. The error message will contain -// additional details about the cause. +// One or more parameters are not valid. // // See also, https://docs.aws.amazon.com/goto/WebAPI/directconnect-2012-10-25/AllocateHostedConnection func (c *DirectConnect) AllocateHostedConnection(input *AllocateHostedConnectionInput) (*Connection, error) { @@ -245,12 +241,11 @@ func (c *DirectConnect) AllocatePrivateVirtualInterfaceRequest(input *AllocatePr // AllocatePrivateVirtualInterface API operation for AWS Direct Connect. // -// Provisions a private virtual interface to be owned by another AWS customer. +// Provisions a private virtual interface to be owned by the specified AWS account. // -// Virtual interfaces created using this action must be confirmed by the virtual -// interface owner by using the ConfirmPrivateVirtualInterface action. Until -// then, the virtual interface will be in 'Confirming' state, and will not be -// available for handling traffic. +// Virtual interfaces created using this action must be confirmed by the owner +// using ConfirmPrivateVirtualInterface. Until then, the virtual interface is +// in the Confirming state and is not available to handle traffic. // // 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 @@ -261,12 +256,10 @@ func (c *DirectConnect) AllocatePrivateVirtualInterfaceRequest(input *AllocatePr // // Returned Error Codes: // * ErrCodeServerException "DirectConnectServerException" -// A server-side error occurred during the API call. The error message will -// contain additional details about the cause. +// A server-side error occurred. // // * ErrCodeClientException "DirectConnectClientException" -// The API was called with invalid parameters. The error message will contain -// additional details about the cause. +// One or more parameters are not valid. // // See also, https://docs.aws.amazon.com/goto/WebAPI/directconnect-2012-10-25/AllocatePrivateVirtualInterface func (c *DirectConnect) AllocatePrivateVirtualInterface(input *AllocatePrivateVirtualInterfaceInput) (*VirtualInterface, error) { @@ -334,19 +327,19 @@ func (c *DirectConnect) AllocatePublicVirtualInterfaceRequest(input *AllocatePub // AllocatePublicVirtualInterface API operation for AWS Direct Connect. // -// Provisions a public virtual interface to be owned by a different customer. +// Provisions a public virtual interface to be owned by the specified AWS account. // // The owner of a connection calls this function to provision a public virtual -// interface which will be owned by another AWS customer. +// interface to be owned by the specified AWS account. // -// Virtual interfaces created using this function must be confirmed by the virtual -// interface owner by calling ConfirmPublicVirtualInterface. Until this step -// has been completed, the virtual interface will be in 'Confirming' state, -// and will not be available for handling traffic. +// Virtual interfaces created using this function must be confirmed by the owner +// using ConfirmPublicVirtualInterface. Until this step has been completed, +// the virtual interface is in the confirming state and is not available to +// handle traffic. // -// When creating an IPv6 public virtual interface (addressFamily is 'ipv6'), -// the customer and amazon address fields should be left blank to use auto-assigned -// IPv6 space. Custom IPv6 Addresses are currently not supported. +// When creating an IPv6 public virtual interface, omit the Amazon address and +// customer address. IPv6 addresses are automatically assigned from the Amazon +// pool of IPv6 addresses; you cannot specify custom IPv6 addresses. // // 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 @@ -357,12 +350,10 @@ func (c *DirectConnect) AllocatePublicVirtualInterfaceRequest(input *AllocatePub // // Returned Error Codes: // * ErrCodeServerException "DirectConnectServerException" -// A server-side error occurred during the API call. The error message will -// contain additional details about the cause. +// A server-side error occurred. // // * ErrCodeClientException "DirectConnectClientException" -// The API was called with invalid parameters. The error message will contain -// additional details about the cause. +// One or more parameters are not valid. // // See also, https://docs.aws.amazon.com/goto/WebAPI/directconnect-2012-10-25/AllocatePublicVirtualInterface func (c *DirectConnect) AllocatePublicVirtualInterface(input *AllocatePublicVirtualInterfaceInput) (*VirtualInterface, error) { @@ -432,12 +423,12 @@ func (c *DirectConnect) AssociateConnectionWithLagRequest(input *AssociateConnec // // Associates an existing connection with a link aggregation group (LAG). The // connection is interrupted and re-established as a member of the LAG (connectivity -// to AWS will be interrupted). The connection must be hosted on the same AWS -// Direct Connect endpoint as the LAG, and its bandwidth must match the bandwidth -// for the LAG. You can reassociate a connection that's currently associated -// with a different LAG; however, if removing the connection will cause the -// original LAG to fall below its setting for minimum number of operational -// connections, the request fails. +// to AWS is interrupted). The connection must be hosted on the same AWS Direct +// Connect endpoint as the LAG, and its bandwidth must match the bandwidth for +// the LAG. You can re-associate a connection that's currently associated with +// a different LAG; however, if removing the connection would cause the original +// LAG to fall below its setting for minimum number of operational connections, +// the request fails. // // Any virtual interfaces that are directly associated with the connection are // automatically re-associated with the LAG. If the connection was originally @@ -457,12 +448,10 @@ func (c *DirectConnect) AssociateConnectionWithLagRequest(input *AssociateConnec // // Returned Error Codes: // * ErrCodeServerException "DirectConnectServerException" -// A server-side error occurred during the API call. The error message will -// contain additional details about the cause. +// A server-side error occurred. // // * ErrCodeClientException "DirectConnectClientException" -// The API was called with invalid parameters. The error message will contain -// additional details about the cause. +// One or more parameters are not valid. // // See also, https://docs.aws.amazon.com/goto/WebAPI/directconnect-2012-10-25/AssociateConnectionWithLag func (c *DirectConnect) AssociateConnectionWithLag(input *AssociateConnectionWithLagInput) (*Connection, error) { @@ -536,7 +525,7 @@ func (c *DirectConnect) AssociateHostedConnectionRequest(input *AssociateHostedC // fails. This action temporarily interrupts the hosted connection's connectivity // to AWS as it is being migrated. // -// This is intended for use by AWS Direct Connect partners only. +// Intended for use by AWS Direct Connect partners only. // // 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 @@ -547,12 +536,10 @@ func (c *DirectConnect) AssociateHostedConnectionRequest(input *AssociateHostedC // // Returned Error Codes: // * ErrCodeServerException "DirectConnectServerException" -// A server-side error occurred during the API call. The error message will -// contain additional details about the cause. +// A server-side error occurred. // // * ErrCodeClientException "DirectConnectClientException" -// The API was called with invalid parameters. The error message will contain -// additional details about the cause. +// One or more parameters are not valid. // // See also, https://docs.aws.amazon.com/goto/WebAPI/directconnect-2012-10-25/AssociateHostedConnection func (c *DirectConnect) AssociateHostedConnection(input *AssociateHostedConnectionInput) (*Connection, error) { @@ -630,11 +617,10 @@ func (c *DirectConnect) AssociateVirtualInterfaceRequest(input *AssociateVirtual // with a LAG; hosted connections must be migrated along with their virtual // interfaces using AssociateHostedConnection. // -// In order to reassociate a virtual interface to a new connection or LAG, the -// requester must own either the virtual interface itself or the connection -// to which the virtual interface is currently associated. Additionally, the -// requester must own the connection or LAG to which the virtual interface will -// be newly associated. +// To reassociate a virtual interface to a new connection or LAG, the requester +// must own either the virtual interface itself or the connection to which the +// virtual interface is currently associated. Additionally, the requester must +// own the connection or LAG for the association. // // 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 @@ -645,12 +631,10 @@ func (c *DirectConnect) AssociateVirtualInterfaceRequest(input *AssociateVirtual // // Returned Error Codes: // * ErrCodeServerException "DirectConnectServerException" -// A server-side error occurred during the API call. The error message will -// contain additional details about the cause. +// A server-side error occurred. // // * ErrCodeClientException "DirectConnectClientException" -// The API was called with invalid parameters. The error message will contain -// additional details about the cause. +// One or more parameters are not valid. // // See also, https://docs.aws.amazon.com/goto/WebAPI/directconnect-2012-10-25/AssociateVirtualInterface func (c *DirectConnect) AssociateVirtualInterface(input *AssociateVirtualInterfaceInput) (*VirtualInterface, error) { @@ -718,11 +702,11 @@ func (c *DirectConnect) ConfirmConnectionRequest(input *ConfirmConnectionInput) // ConfirmConnection API operation for AWS Direct Connect. // -// Confirm the creation of a hosted connection on an interconnect. +// Confirms the creation of the specified hosted connection on an interconnect. // -// Upon creation, the hosted connection is initially in the 'Ordering' state, -// and will remain in this state until the owner calls ConfirmConnection to -// confirm creation of the hosted connection. +// Upon creation, the hosted connection is initially in the Ordering state, +// and remains in this state until the owner confirms creation of the hosted +// connection. // // 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 @@ -733,12 +717,10 @@ func (c *DirectConnect) ConfirmConnectionRequest(input *ConfirmConnectionInput) // // Returned Error Codes: // * ErrCodeServerException "DirectConnectServerException" -// A server-side error occurred during the API call. The error message will -// contain additional details about the cause. +// A server-side error occurred. // // * ErrCodeClientException "DirectConnectClientException" -// The API was called with invalid parameters. The error message will contain -// additional details about the cause. +// One or more parameters are not valid. // // See also, https://docs.aws.amazon.com/goto/WebAPI/directconnect-2012-10-25/ConfirmConnection func (c *DirectConnect) ConfirmConnection(input *ConfirmConnectionInput) (*ConfirmConnectionOutput, error) { @@ -806,11 +788,11 @@ func (c *DirectConnect) ConfirmPrivateVirtualInterfaceRequest(input *ConfirmPriv // ConfirmPrivateVirtualInterface API operation for AWS Direct Connect. // -// Accept ownership of a private virtual interface created by another customer. +// Accepts ownership of a private virtual interface created by another AWS account. // -// After the virtual interface owner calls this function, the virtual interface -// will be created and attached to the given virtual private gateway or direct -// connect gateway, and will be available for handling traffic. +// After the virtual interface owner makes this call, the virtual interface +// is created and attached to the specified virtual private gateway or Direct +// Connect gateway, and is made available to handle traffic. // // 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 @@ -821,12 +803,10 @@ func (c *DirectConnect) ConfirmPrivateVirtualInterfaceRequest(input *ConfirmPriv // // Returned Error Codes: // * ErrCodeServerException "DirectConnectServerException" -// A server-side error occurred during the API call. The error message will -// contain additional details about the cause. +// A server-side error occurred. // // * ErrCodeClientException "DirectConnectClientException" -// The API was called with invalid parameters. The error message will contain -// additional details about the cause. +// One or more parameters are not valid. // // See also, https://docs.aws.amazon.com/goto/WebAPI/directconnect-2012-10-25/ConfirmPrivateVirtualInterface func (c *DirectConnect) ConfirmPrivateVirtualInterface(input *ConfirmPrivateVirtualInterfaceInput) (*ConfirmPrivateVirtualInterfaceOutput, error) { @@ -894,10 +874,10 @@ func (c *DirectConnect) ConfirmPublicVirtualInterfaceRequest(input *ConfirmPubli // ConfirmPublicVirtualInterface API operation for AWS Direct Connect. // -// Accept ownership of a public virtual interface created by another customer. +// Accepts ownership of a public virtual interface created by another AWS account. // -// After the virtual interface owner calls this function, the specified virtual -// interface will be created and made available for handling traffic. +// After the virtual interface owner makes this call, the specified virtual +// interface is created and made available to handle traffic. // // 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 @@ -908,12 +888,10 @@ func (c *DirectConnect) ConfirmPublicVirtualInterfaceRequest(input *ConfirmPubli // // Returned Error Codes: // * ErrCodeServerException "DirectConnectServerException" -// A server-side error occurred during the API call. The error message will -// contain additional details about the cause. +// A server-side error occurred. // // * ErrCodeClientException "DirectConnectClientException" -// The API was called with invalid parameters. The error message will contain -// additional details about the cause. +// One or more parameters are not valid. // // See also, https://docs.aws.amazon.com/goto/WebAPI/directconnect-2012-10-25/ConfirmPublicVirtualInterface func (c *DirectConnect) ConfirmPublicVirtualInterface(input *ConfirmPublicVirtualInterfaceInput) (*ConfirmPublicVirtualInterfaceOutput, error) { @@ -981,16 +959,17 @@ func (c *DirectConnect) CreateBGPPeerRequest(input *CreateBGPPeerInput) (req *re // CreateBGPPeer API operation for AWS Direct Connect. // -// Creates a new BGP peer on a specified virtual interface. The BGP peer cannot -// be in the same address family (IPv4/IPv6) of an existing BGP peer on the -// virtual interface. +// Creates a BGP peer on the specified virtual interface. +// +// The BGP peer cannot be in the same address family (IPv4/IPv6) of an existing +// BGP peer on the virtual interface. // // You must create a BGP peer for the corresponding address family in order // to access AWS resources that also use that address family. // -// When creating a IPv6 BGP peer, the Amazon address and customer address fields -// must be left blank. IPv6 addresses are automatically assigned from Amazon's -// pool of IPv6 addresses; you cannot specify custom IPv6 addresses. +// When creating a IPv6 BGP peer, omit the Amazon address and customer address. +// IPv6 addresses are automatically assigned from the Amazon pool of IPv6 addresses; +// you cannot specify custom IPv6 addresses. // // For a public virtual interface, the Autonomous System Number (ASN) must be // private or already whitelisted for the virtual interface. @@ -1004,12 +983,10 @@ func (c *DirectConnect) CreateBGPPeerRequest(input *CreateBGPPeerInput) (req *re // // Returned Error Codes: // * ErrCodeServerException "DirectConnectServerException" -// A server-side error occurred during the API call. The error message will -// contain additional details about the cause. +// A server-side error occurred. // // * ErrCodeClientException "DirectConnectClientException" -// The API was called with invalid parameters. The error message will contain -// additional details about the cause. +// One or more parameters are not valid. // // See also, https://docs.aws.amazon.com/goto/WebAPI/directconnect-2012-10-25/CreateBGPPeer func (c *DirectConnect) CreateBGPPeer(input *CreateBGPPeerInput) (*CreateBGPPeerOutput, error) { @@ -1077,24 +1054,20 @@ func (c *DirectConnect) CreateConnectionRequest(input *CreateConnectionInput) (r // CreateConnection API operation for AWS Direct Connect. // -// Creates a new connection between the customer network and a specific AWS -// Direct Connect location. +// Creates a connection between a customer network and a specific AWS Direct +// Connect location. // // A connection 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. An AWS Direct Connect location provides access to Amazon Web Services -// in the region it is associated with. You can establish connections with AWS -// Direct Connect locations in multiple regions, but a connection in one region -// does not provide connectivity to other regions. +// over a standard Ethernet fiber-optic cable. One end of the cable is connected +// to your router, the other to an AWS Direct Connect router. // -// To find the locations for your region, use DescribeLocations. +// To find the locations for your Region, use DescribeLocations. // // You can automatically add the new connection to a link aggregation group // (LAG) by specifying a LAG ID in the request. This ensures that the new connection // is allocated on the same AWS Direct Connect endpoint that hosts the specified // LAG. If there are no available ports on the endpoint, the request fails and -// no connection will be created. +// no connection is created. // // 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 @@ -1105,12 +1078,10 @@ func (c *DirectConnect) CreateConnectionRequest(input *CreateConnectionInput) (r // // Returned Error Codes: // * ErrCodeServerException "DirectConnectServerException" -// A server-side error occurred during the API call. The error message will -// contain additional details about the cause. +// A server-side error occurred. // // * ErrCodeClientException "DirectConnectClientException" -// The API was called with invalid parameters. The error message will contain -// additional details about the cause. +// One or more parameters are not valid. // // See also, https://docs.aws.amazon.com/goto/WebAPI/directconnect-2012-10-25/CreateConnection func (c *DirectConnect) CreateConnection(input *CreateConnectionInput) (*Connection, error) { @@ -1178,14 +1149,13 @@ func (c *DirectConnect) CreateDirectConnectGatewayRequest(input *CreateDirectCon // CreateDirectConnectGateway API operation for AWS Direct Connect. // -// Creates a new direct connect gateway. A direct connect gateway is an intermediate -// object that enables you to connect a set of virtual interfaces and virtual -// private gateways. direct connect gateways are global and visible in any AWS -// region after they are created. The virtual interfaces and virtual private -// gateways that are connected through a direct connect gateway can be in different -// regions. This enables you to connect to a VPC in any region, regardless of -// the region in which the virtual interfaces are located, and pass traffic -// between them. +// Creates a Direct Connect gateway, which is an intermediate object that enables +// you to connect a set of virtual interfaces and virtual private gateways. +// A Direct Connect gateway is global and visible in any AWS Region after it +// is created. The virtual interfaces and virtual private gateways that are +// connected through a Direct Connect gateway can be in different AWS Regions. +// This enables you to connect to a VPC in any Region, regardless of the Region +// in which the virtual interfaces are located, and pass traffic between them. // // 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 @@ -1196,12 +1166,10 @@ func (c *DirectConnect) CreateDirectConnectGatewayRequest(input *CreateDirectCon // // Returned Error Codes: // * ErrCodeServerException "DirectConnectServerException" -// A server-side error occurred during the API call. The error message will -// contain additional details about the cause. +// A server-side error occurred. // // * ErrCodeClientException "DirectConnectClientException" -// The API was called with invalid parameters. The error message will contain -// additional details about the cause. +// One or more parameters are not valid. // // See also, https://docs.aws.amazon.com/goto/WebAPI/directconnect-2012-10-25/CreateDirectConnectGateway func (c *DirectConnect) CreateDirectConnectGateway(input *CreateDirectConnectGatewayInput) (*CreateDirectConnectGatewayOutput, error) { @@ -1269,9 +1237,9 @@ func (c *DirectConnect) CreateDirectConnectGatewayAssociationRequest(input *Crea // CreateDirectConnectGatewayAssociation API operation for AWS Direct Connect. // -// Creates an association between a direct connect gateway and a virtual private -// gateway (VGW). The VGW must be attached to a VPC and must not be associated -// with another direct connect gateway. +// Creates an association between a Direct Connect gateway and a virtual private +// gateway. The virtual private gateway must be attached to a VPC and must not +// be associated with another Direct Connect gateway. // // 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 @@ -1282,12 +1250,10 @@ func (c *DirectConnect) CreateDirectConnectGatewayAssociationRequest(input *Crea // // Returned Error Codes: // * ErrCodeServerException "DirectConnectServerException" -// A server-side error occurred during the API call. The error message will -// contain additional details about the cause. +// A server-side error occurred. // // * ErrCodeClientException "DirectConnectClientException" -// The API was called with invalid parameters. The error message will contain -// additional details about the cause. +// One or more parameters are not valid. // // See also, https://docs.aws.amazon.com/goto/WebAPI/directconnect-2012-10-25/CreateDirectConnectGatewayAssociation func (c *DirectConnect) CreateDirectConnectGatewayAssociation(input *CreateDirectConnectGatewayAssociationInput) (*CreateDirectConnectGatewayAssociationOutput, error) { @@ -1355,30 +1321,29 @@ func (c *DirectConnect) CreateInterconnectRequest(input *CreateInterconnectInput // CreateInterconnect API operation for AWS Direct Connect. // -// Creates a new interconnect between a AWS Direct Connect partner's network -// and a specific AWS Direct Connect location. +// Creates an interconnect between an AWS Direct Connect partner's network and +// a specific AWS Direct Connect location. // // An interconnect is a connection which is capable of hosting other connections. -// The AWS Direct Connect partner can use an interconnect to provide sub-1Gbps -// AWS Direct Connect service to tier 2 customers who do not have their own -// connections. Like a standard connection, an interconnect links the AWS Direct -// Connect partner's network to an AWS Direct Connect location over a standard -// 1 Gbps or 10 Gbps Ethernet fiber-optic cable. One end is connected to the -// partner's router, the other to an AWS Direct Connect router. +// The partner can use an interconnect to provide sub-1Gbps AWS Direct Connect +// service to tier 2 customers who do not have their own connections. Like a +// standard connection, an interconnect links the partner's network to an AWS +// Direct Connect location over a standard Ethernet fiber-optic cable. One end +// is connected to the partner's router, the other to an AWS Direct Connect +// router. // // You can automatically add the new interconnect to a link aggregation group // (LAG) by specifying a LAG ID in the request. This ensures that the new interconnect // is allocated on the same AWS Direct Connect endpoint that hosts the specified // LAG. If there are no available ports on the endpoint, the request fails and -// no interconnect will be created. +// no interconnect is created. // // For each end customer, the AWS Direct Connect partner provisions a connection // on their interconnect by calling AllocateConnectionOnInterconnect. The end // customer can then connect to AWS resources by creating a virtual interface -// on their connection, using the VLAN assigned to them by the AWS Direct Connect -// partner. +// on their connection, using the VLAN assigned to them by the partner. // -// This is intended for use by AWS Direct Connect partners only. +// Intended for use by AWS Direct Connect partners only. // // 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 @@ -1389,12 +1354,10 @@ func (c *DirectConnect) CreateInterconnectRequest(input *CreateInterconnectInput // // Returned Error Codes: // * ErrCodeServerException "DirectConnectServerException" -// A server-side error occurred during the API call. The error message will -// contain additional details about the cause. +// A server-side error occurred. // // * ErrCodeClientException "DirectConnectClientException" -// The API was called with invalid parameters. The error message will contain -// additional details about the cause. +// One or more parameters are not valid. // // See also, https://docs.aws.amazon.com/goto/WebAPI/directconnect-2012-10-25/CreateInterconnect func (c *DirectConnect) CreateInterconnect(input *CreateInterconnectInput) (*Interconnect, error) { @@ -1462,14 +1425,14 @@ func (c *DirectConnect) CreateLagRequest(input *CreateLagInput) (req *request.Re // CreateLag API operation for AWS Direct Connect. // -// Creates a new link aggregation group (LAG) with the specified number of bundled +// Creates a link aggregation group (LAG) with the specified number of bundled // physical connections between the customer network and a specific AWS Direct // Connect location. A LAG is a logical interface that uses the Link Aggregation -// Control Protocol (LACP) to aggregate multiple 1 gigabit or 10 gigabit interfaces, -// allowing you to treat them as a single interface. +// Control Protocol (LACP) to aggregate multiple interfaces, enabling you to +// treat them as a single interface. // -// All connections in a LAG must use the same bandwidth (for example, 10 Gbps), -// and must terminate at the same AWS Direct Connect endpoint. +// All connections in a LAG must use the same bandwidth and must terminate at +// the same AWS Direct Connect endpoint. // // You can have up to 10 connections per LAG. Regardless of this limit, if you // request more connections for the LAG than AWS Direct Connect can allocate @@ -1497,12 +1460,10 @@ func (c *DirectConnect) CreateLagRequest(input *CreateLagInput) (req *request.Re // // Returned Error Codes: // * ErrCodeServerException "DirectConnectServerException" -// A server-side error occurred during the API call. The error message will -// contain additional details about the cause. +// A server-side error occurred. // // * ErrCodeClientException "DirectConnectClientException" -// The API was called with invalid parameters. The error message will contain -// additional details about the cause. +// One or more parameters are not valid. // // See also, https://docs.aws.amazon.com/goto/WebAPI/directconnect-2012-10-25/CreateLag func (c *DirectConnect) CreateLag(input *CreateLagInput) (*Lag, error) { @@ -1570,9 +1531,13 @@ func (c *DirectConnect) CreatePrivateVirtualInterfaceRequest(input *CreatePrivat // CreatePrivateVirtualInterface API operation for AWS Direct Connect. // -// Creates a new private virtual interface. A virtual interface is the VLAN -// that transports AWS Direct Connect traffic. A private virtual interface supports -// sending traffic to a single virtual private cloud (VPC). +// Creates a private virtual interface. A virtual interface is the VLAN that +// transports AWS Direct Connect traffic. A private virtual interface can be +// connected to either a Direct Connect gateway or a Virtual Private Gateway +// (VGW). Connecting the private virtual interface to a Direct Connect gateway +// enables the possibility for connecting to multiple VPCs, including VPCs in +// different AWS Regions. Connecting the private virtual interface to a VGW +// only provides access to a single VPC within the same 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 @@ -1583,12 +1548,10 @@ func (c *DirectConnect) CreatePrivateVirtualInterfaceRequest(input *CreatePrivat // // Returned Error Codes: // * ErrCodeServerException "DirectConnectServerException" -// A server-side error occurred during the API call. The error message will -// contain additional details about the cause. +// A server-side error occurred. // // * ErrCodeClientException "DirectConnectClientException" -// The API was called with invalid parameters. The error message will contain -// additional details about the cause. +// One or more parameters are not valid. // // See also, https://docs.aws.amazon.com/goto/WebAPI/directconnect-2012-10-25/CreatePrivateVirtualInterface func (c *DirectConnect) CreatePrivateVirtualInterface(input *CreatePrivateVirtualInterfaceInput) (*VirtualInterface, error) { @@ -1656,14 +1619,13 @@ func (c *DirectConnect) CreatePublicVirtualInterfaceRequest(input *CreatePublicV // CreatePublicVirtualInterface API operation for AWS Direct Connect. // -// Creates a new public virtual interface. A virtual interface is the VLAN that +// Creates a public virtual interface. A virtual interface is the VLAN that // transports AWS Direct Connect traffic. A public virtual interface supports -// sending traffic to public services of AWS such as Amazon Simple Storage Service -// (Amazon S3). +// sending traffic to public services of AWS such as Amazon S3. // -// When creating an IPv6 public virtual interface (addressFamily is 'ipv6'), -// the customer and amazon address fields should be left blank to use auto-assigned -// IPv6 space. Custom IPv6 Addresses are currently not supported. +// When creating an IPv6 public virtual interface (addressFamily is ipv6), leave +// the customer and amazon address fields blank to use auto-assigned IPv6 space. +// Custom IPv6 addresses are not supported. // // 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 @@ -1674,12 +1636,10 @@ func (c *DirectConnect) CreatePublicVirtualInterfaceRequest(input *CreatePublicV // // Returned Error Codes: // * ErrCodeServerException "DirectConnectServerException" -// A server-side error occurred during the API call. The error message will -// contain additional details about the cause. +// A server-side error occurred. // // * ErrCodeClientException "DirectConnectClientException" -// The API was called with invalid parameters. The error message will contain -// additional details about the cause. +// One or more parameters are not valid. // // See also, https://docs.aws.amazon.com/goto/WebAPI/directconnect-2012-10-25/CreatePublicVirtualInterface func (c *DirectConnect) CreatePublicVirtualInterface(input *CreatePublicVirtualInterfaceInput) (*VirtualInterface, error) { @@ -1747,9 +1707,10 @@ func (c *DirectConnect) DeleteBGPPeerRequest(input *DeleteBGPPeerInput) (req *re // DeleteBGPPeer API operation for AWS Direct Connect. // -// Deletes a BGP peer on the specified virtual interface that matches the specified -// customer address and ASN. You cannot delete the last BGP peer from a virtual -// interface. +// Deletes the BGP peer on the specified virtual interface with the specified +// customer address and ASN. +// +// You cannot delete the last BGP peer from a virtual interface. // // 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 @@ -1760,12 +1721,10 @@ func (c *DirectConnect) DeleteBGPPeerRequest(input *DeleteBGPPeerInput) (req *re // // Returned Error Codes: // * ErrCodeServerException "DirectConnectServerException" -// A server-side error occurred during the API call. The error message will -// contain additional details about the cause. +// A server-side error occurred. // // * ErrCodeClientException "DirectConnectClientException" -// The API was called with invalid parameters. The error message will contain -// additional details about the cause. +// One or more parameters are not valid. // // See also, https://docs.aws.amazon.com/goto/WebAPI/directconnect-2012-10-25/DeleteBGPPeer func (c *DirectConnect) DeleteBGPPeer(input *DeleteBGPPeerInput) (*DeleteBGPPeerOutput, error) { @@ -1833,12 +1792,12 @@ func (c *DirectConnect) DeleteConnectionRequest(input *DeleteConnectionInput) (r // DeleteConnection API operation for AWS Direct Connect. // -// Deletes the connection. +// Deletes the specified connection. // // Deleting a connection only stops the AWS Direct Connect port hour and data -// transfer charges. You need to cancel separately with the providers any services -// or charges for cross-connects or network circuits that connect you to the -// AWS Direct Connect location. +// transfer charges. If you are partnering with any third parties to connect +// with the AWS Direct Connect location, you must cancel your service with them +// separately. // // 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 @@ -1849,12 +1808,10 @@ func (c *DirectConnect) DeleteConnectionRequest(input *DeleteConnectionInput) (r // // Returned Error Codes: // * ErrCodeServerException "DirectConnectServerException" -// A server-side error occurred during the API call. The error message will -// contain additional details about the cause. +// A server-side error occurred. // // * ErrCodeClientException "DirectConnectClientException" -// The API was called with invalid parameters. The error message will contain -// additional details about the cause. +// One or more parameters are not valid. // // See also, https://docs.aws.amazon.com/goto/WebAPI/directconnect-2012-10-25/DeleteConnection func (c *DirectConnect) DeleteConnection(input *DeleteConnectionInput) (*Connection, error) { @@ -1922,9 +1879,10 @@ func (c *DirectConnect) DeleteDirectConnectGatewayRequest(input *DeleteDirectCon // DeleteDirectConnectGateway API operation for AWS Direct Connect. // -// Deletes a direct connect gateway. You must first delete all virtual interfaces -// that are attached to the direct connect gateway and disassociate all virtual -// private gateways that are associated with the direct connect gateway. +// Deletes the specified Direct Connect gateway. You must first delete all virtual +// interfaces that are attached to the Direct Connect gateway and disassociate +// all virtual private gateways that are associated with the Direct Connect +// gateway. // // 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 @@ -1935,12 +1893,10 @@ func (c *DirectConnect) DeleteDirectConnectGatewayRequest(input *DeleteDirectCon // // Returned Error Codes: // * ErrCodeServerException "DirectConnectServerException" -// A server-side error occurred during the API call. The error message will -// contain additional details about the cause. +// A server-side error occurred. // // * ErrCodeClientException "DirectConnectClientException" -// The API was called with invalid parameters. The error message will contain -// additional details about the cause. +// One or more parameters are not valid. // // See also, https://docs.aws.amazon.com/goto/WebAPI/directconnect-2012-10-25/DeleteDirectConnectGateway func (c *DirectConnect) DeleteDirectConnectGateway(input *DeleteDirectConnectGatewayInput) (*DeleteDirectConnectGatewayOutput, error) { @@ -2008,8 +1964,8 @@ func (c *DirectConnect) DeleteDirectConnectGatewayAssociationRequest(input *Dele // DeleteDirectConnectGatewayAssociation API operation for AWS Direct Connect. // -// Deletes the association between a direct connect gateway and a virtual private -// gateway. +// Deletes the association between the specified Direct Connect gateway and +// virtual private gateway. // // 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 @@ -2020,12 +1976,10 @@ func (c *DirectConnect) DeleteDirectConnectGatewayAssociationRequest(input *Dele // // Returned Error Codes: // * ErrCodeServerException "DirectConnectServerException" -// A server-side error occurred during the API call. The error message will -// contain additional details about the cause. +// A server-side error occurred. // // * ErrCodeClientException "DirectConnectClientException" -// The API was called with invalid parameters. The error message will contain -// additional details about the cause. +// One or more parameters are not valid. // // See also, https://docs.aws.amazon.com/goto/WebAPI/directconnect-2012-10-25/DeleteDirectConnectGatewayAssociation func (c *DirectConnect) DeleteDirectConnectGatewayAssociation(input *DeleteDirectConnectGatewayAssociationInput) (*DeleteDirectConnectGatewayAssociationOutput, error) { @@ -2095,7 +2049,7 @@ func (c *DirectConnect) DeleteInterconnectRequest(input *DeleteInterconnectInput // // Deletes the specified interconnect. // -// This is intended for use by AWS Direct Connect partners only. +// Intended for use by AWS Direct Connect partners only. // // 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 @@ -2106,12 +2060,10 @@ func (c *DirectConnect) DeleteInterconnectRequest(input *DeleteInterconnectInput // // Returned Error Codes: // * ErrCodeServerException "DirectConnectServerException" -// A server-side error occurred during the API call. The error message will -// contain additional details about the cause. +// A server-side error occurred. // // * ErrCodeClientException "DirectConnectClientException" -// The API was called with invalid parameters. The error message will contain -// additional details about the cause. +// One or more parameters are not valid. // // See also, https://docs.aws.amazon.com/goto/WebAPI/directconnect-2012-10-25/DeleteInterconnect func (c *DirectConnect) DeleteInterconnect(input *DeleteInterconnectInput) (*DeleteInterconnectOutput, error) { @@ -2179,8 +2131,8 @@ func (c *DirectConnect) DeleteLagRequest(input *DeleteLagInput) (req *request.Re // DeleteLag API operation for AWS Direct Connect. // -// Deletes a link aggregation group (LAG). You cannot delete a LAG if it has -// active virtual interfaces or hosted connections. +// Deletes the specified link aggregation group (LAG). You cannot delete a LAG +// if it has active virtual interfaces or hosted connections. // // 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 @@ -2191,12 +2143,10 @@ func (c *DirectConnect) DeleteLagRequest(input *DeleteLagInput) (req *request.Re // // Returned Error Codes: // * ErrCodeServerException "DirectConnectServerException" -// A server-side error occurred during the API call. The error message will -// contain additional details about the cause. +// A server-side error occurred. // // * ErrCodeClientException "DirectConnectClientException" -// The API was called with invalid parameters. The error message will contain -// additional details about the cause. +// One or more parameters are not valid. // // See also, https://docs.aws.amazon.com/goto/WebAPI/directconnect-2012-10-25/DeleteLag func (c *DirectConnect) DeleteLag(input *DeleteLagInput) (*Lag, error) { @@ -2275,12 +2225,10 @@ func (c *DirectConnect) DeleteVirtualInterfaceRequest(input *DeleteVirtualInterf // // Returned Error Codes: // * ErrCodeServerException "DirectConnectServerException" -// A server-side error occurred during the API call. The error message will -// contain additional details about the cause. +// A server-side error occurred. // // * ErrCodeClientException "DirectConnectClientException" -// The API was called with invalid parameters. The error message will contain -// additional details about the cause. +// One or more parameters are not valid. // // See also, https://docs.aws.amazon.com/goto/WebAPI/directconnect-2012-10-25/DeleteVirtualInterface func (c *DirectConnect) DeleteVirtualInterface(input *DeleteVirtualInterfaceInput) (*DeleteVirtualInterfaceOutput, error) { @@ -2353,15 +2301,15 @@ func (c *DirectConnect) DescribeConnectionLoaRequest(input *DescribeConnectionLo // DescribeConnectionLoa API operation for AWS Direct Connect. // -// Deprecated in favor of DescribeLoa. +// Deprecated. Use DescribeLoa instead. // -// Returns the LOA-CFA for a Connection. +// Gets the LOA-CFA for a connection. // // The Letter of Authorization - Connecting Facility Assignment (LOA-CFA) is // a document that your APN partner or service provider uses when establishing // your cross connect to AWS at the colocation facility. For more information, // see Requesting Cross Connects at AWS Direct Connect Locations (http://docs.aws.amazon.com/directconnect/latest/UserGuide/Colocation.html) -// in the AWS Direct Connect user guide. +// in the AWS Direct Connect 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 @@ -2372,12 +2320,10 @@ func (c *DirectConnect) DescribeConnectionLoaRequest(input *DescribeConnectionLo // // Returned Error Codes: // * ErrCodeServerException "DirectConnectServerException" -// A server-side error occurred during the API call. The error message will -// contain additional details about the cause. +// A server-side error occurred. // // * ErrCodeClientException "DirectConnectClientException" -// The API was called with invalid parameters. The error message will contain -// additional details about the cause. +// One or more parameters are not valid. // // See also, https://docs.aws.amazon.com/goto/WebAPI/directconnect-2012-10-25/DescribeConnectionLoa // @@ -2449,9 +2395,7 @@ func (c *DirectConnect) DescribeConnectionsRequest(input *DescribeConnectionsInp // DescribeConnections API operation for AWS Direct Connect. // -// Displays all connections in this region. -// -// If a connection ID is provided, the call returns only that particular connection. +// Displays the specified connection or all connections in this 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 @@ -2462,12 +2406,10 @@ func (c *DirectConnect) DescribeConnectionsRequest(input *DescribeConnectionsInp // // Returned Error Codes: // * ErrCodeServerException "DirectConnectServerException" -// A server-side error occurred during the API call. The error message will -// contain additional details about the cause. +// A server-side error occurred. // // * ErrCodeClientException "DirectConnectClientException" -// The API was called with invalid parameters. The error message will contain -// additional details about the cause. +// One or more parameters are not valid. // // See also, https://docs.aws.amazon.com/goto/WebAPI/directconnect-2012-10-25/DescribeConnections func (c *DirectConnect) DescribeConnections(input *DescribeConnectionsInput) (*Connections, error) { @@ -2540,11 +2482,11 @@ func (c *DirectConnect) DescribeConnectionsOnInterconnectRequest(input *Describe // DescribeConnectionsOnInterconnect API operation for AWS Direct Connect. // -// Deprecated in favor of DescribeHostedConnections. +// Deprecated. Use DescribeHostedConnections instead. // -// Returns a list of connections that have been provisioned on the given interconnect. +// Lists the connections that have been provisioned on the specified interconnect. // -// This is intended for use by AWS Direct Connect partners only. +// Intended for use by AWS Direct Connect partners only. // // 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 @@ -2555,12 +2497,10 @@ func (c *DirectConnect) DescribeConnectionsOnInterconnectRequest(input *Describe // // Returned Error Codes: // * ErrCodeServerException "DirectConnectServerException" -// A server-side error occurred during the API call. The error message will -// contain additional details about the cause. +// A server-side error occurred. // // * ErrCodeClientException "DirectConnectClientException" -// The API was called with invalid parameters. The error message will contain -// additional details about the cause. +// One or more parameters are not valid. // // See also, https://docs.aws.amazon.com/goto/WebAPI/directconnect-2012-10-25/DescribeConnectionsOnInterconnect // @@ -2632,13 +2572,14 @@ func (c *DirectConnect) DescribeDirectConnectGatewayAssociationsRequest(input *D // DescribeDirectConnectGatewayAssociations API operation for AWS Direct Connect. // -// Returns a list of all direct connect gateway and virtual private gateway -// (VGW) associations. Either a direct connect gateway ID or a VGW ID must be -// provided in the request. If a direct connect gateway ID is provided, the -// response returns all VGWs associated with the direct connect gateway. If -// a VGW ID is provided, the response returns all direct connect gateways associated -// with the VGW. If both are provided, the response only returns the association -// that matches both the direct connect gateway and the VGW. +// Lists the associations between your Direct Connect gateways and virtual private +// gateways. You must specify a Direct Connect gateway, a virtual private gateway, +// or both. If you specify a Direct Connect gateway, the response contains all +// virtual private gateways associated with the Direct Connect gateway. If you +// specify a virtual private gateway, the response contains all Direct Connect +// gateways associated with the virtual private gateway. If you specify both, +// the response contains the association between the Direct Connect gateway +// and the virtual private gateway. // // 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 @@ -2649,12 +2590,10 @@ func (c *DirectConnect) DescribeDirectConnectGatewayAssociationsRequest(input *D // // Returned Error Codes: // * ErrCodeServerException "DirectConnectServerException" -// A server-side error occurred during the API call. The error message will -// contain additional details about the cause. +// A server-side error occurred. // // * ErrCodeClientException "DirectConnectClientException" -// The API was called with invalid parameters. The error message will contain -// additional details about the cause. +// One or more parameters are not valid. // // See also, https://docs.aws.amazon.com/goto/WebAPI/directconnect-2012-10-25/DescribeDirectConnectGatewayAssociations func (c *DirectConnect) DescribeDirectConnectGatewayAssociations(input *DescribeDirectConnectGatewayAssociationsInput) (*DescribeDirectConnectGatewayAssociationsOutput, error) { @@ -2722,13 +2661,13 @@ func (c *DirectConnect) DescribeDirectConnectGatewayAttachmentsRequest(input *De // DescribeDirectConnectGatewayAttachments API operation for AWS Direct Connect. // -// Returns a list of all direct connect gateway and virtual interface (VIF) -// attachments. Either a direct connect gateway ID or a VIF ID must be provided -// in the request. If a direct connect gateway ID is provided, the response -// returns all VIFs attached to the direct connect gateway. If a VIF ID is provided, -// the response returns all direct connect gateways attached to the VIF. If -// both are provided, the response only returns the attachment that matches -// both the direct connect gateway and the VIF. +// Lists the attachments between your Direct Connect gateways and virtual interfaces. +// You must specify a Direct Connect gateway, a virtual interface, or both. +// If you specify a Direct Connect gateway, the response contains all virtual +// interfaces attached to the Direct Connect gateway. If you specify a virtual +// interface, the response contains all Direct Connect gateways attached to +// the virtual interface. If you specify both, the response contains the attachment +// between the Direct Connect gateway and the virtual interface. // // 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 @@ -2739,12 +2678,10 @@ func (c *DirectConnect) DescribeDirectConnectGatewayAttachmentsRequest(input *De // // Returned Error Codes: // * ErrCodeServerException "DirectConnectServerException" -// A server-side error occurred during the API call. The error message will -// contain additional details about the cause. +// A server-side error occurred. // // * ErrCodeClientException "DirectConnectClientException" -// The API was called with invalid parameters. The error message will contain -// additional details about the cause. +// One or more parameters are not valid. // // See also, https://docs.aws.amazon.com/goto/WebAPI/directconnect-2012-10-25/DescribeDirectConnectGatewayAttachments func (c *DirectConnect) DescribeDirectConnectGatewayAttachments(input *DescribeDirectConnectGatewayAttachmentsInput) (*DescribeDirectConnectGatewayAttachmentsOutput, error) { @@ -2812,11 +2749,8 @@ func (c *DirectConnect) DescribeDirectConnectGatewaysRequest(input *DescribeDire // DescribeDirectConnectGateways API operation for AWS Direct Connect. // -// Returns a list of direct connect gateways in your account. Deleted direct -// connect gateways are not returned. You can provide a direct connect gateway -// ID in the request to return information about the specific direct connect -// gateway only. Otherwise, if a direct connect gateway ID is not provided, -// information about all of your direct connect gateways is returned. +// Lists all your Direct Connect gateways or only the specified Direct Connect +// gateway. Deleted Direct Connect gateways are not returned. // // 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 @@ -2827,12 +2761,10 @@ func (c *DirectConnect) DescribeDirectConnectGatewaysRequest(input *DescribeDire // // Returned Error Codes: // * ErrCodeServerException "DirectConnectServerException" -// A server-side error occurred during the API call. The error message will -// contain additional details about the cause. +// A server-side error occurred. // // * ErrCodeClientException "DirectConnectClientException" -// The API was called with invalid parameters. The error message will contain -// additional details about the cause. +// One or more parameters are not valid. // // See also, https://docs.aws.amazon.com/goto/WebAPI/directconnect-2012-10-25/DescribeDirectConnectGateways func (c *DirectConnect) DescribeDirectConnectGateways(input *DescribeDirectConnectGatewaysInput) (*DescribeDirectConnectGatewaysOutput, error) { @@ -2900,10 +2832,10 @@ func (c *DirectConnect) DescribeHostedConnectionsRequest(input *DescribeHostedCo // DescribeHostedConnections API operation for AWS Direct Connect. // -// Returns a list of hosted connections that have been provisioned on the given +// Lists the hosted connections that have been provisioned on the specified // interconnect or link aggregation group (LAG). // -// This is intended for use by AWS Direct Connect partners only. +// Intended for use by AWS Direct Connect partners only. // // 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 @@ -2914,12 +2846,10 @@ func (c *DirectConnect) DescribeHostedConnectionsRequest(input *DescribeHostedCo // // Returned Error Codes: // * ErrCodeServerException "DirectConnectServerException" -// A server-side error occurred during the API call. The error message will -// contain additional details about the cause. +// A server-side error occurred. // // * ErrCodeClientException "DirectConnectClientException" -// The API was called with invalid parameters. The error message will contain -// additional details about the cause. +// One or more parameters are not valid. // // See also, https://docs.aws.amazon.com/goto/WebAPI/directconnect-2012-10-25/DescribeHostedConnections func (c *DirectConnect) DescribeHostedConnections(input *DescribeHostedConnectionsInput) (*Connections, error) { @@ -2992,15 +2922,15 @@ func (c *DirectConnect) DescribeInterconnectLoaRequest(input *DescribeInterconne // DescribeInterconnectLoa API operation for AWS Direct Connect. // -// Deprecated in favor of DescribeLoa. +// Deprecated. Use DescribeLoa instead. // -// Returns the LOA-CFA for an Interconnect. +// Gets the LOA-CFA for the specified interconnect. // // The Letter of Authorization - Connecting Facility Assignment (LOA-CFA) is // a document that is used when establishing your cross connect to AWS at the // colocation facility. For more information, see Requesting Cross Connects // at AWS Direct Connect Locations (http://docs.aws.amazon.com/directconnect/latest/UserGuide/Colocation.html) -// in the AWS Direct Connect user guide. +// in the AWS Direct Connect 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 @@ -3011,12 +2941,10 @@ func (c *DirectConnect) DescribeInterconnectLoaRequest(input *DescribeInterconne // // Returned Error Codes: // * ErrCodeServerException "DirectConnectServerException" -// A server-side error occurred during the API call. The error message will -// contain additional details about the cause. +// A server-side error occurred. // // * ErrCodeClientException "DirectConnectClientException" -// The API was called with invalid parameters. The error message will contain -// additional details about the cause. +// One or more parameters are not valid. // // See also, https://docs.aws.amazon.com/goto/WebAPI/directconnect-2012-10-25/DescribeInterconnectLoa // @@ -3088,9 +3016,7 @@ func (c *DirectConnect) DescribeInterconnectsRequest(input *DescribeInterconnect // DescribeInterconnects API operation for AWS Direct Connect. // -// Returns a list of interconnects owned by the AWS account. -// -// If an interconnect ID is provided, it will only return this particular interconnect. +// Lists the interconnects owned by the AWS account or only the specified interconnect. // // 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 @@ -3101,12 +3027,10 @@ func (c *DirectConnect) DescribeInterconnectsRequest(input *DescribeInterconnect // // Returned Error Codes: // * ErrCodeServerException "DirectConnectServerException" -// A server-side error occurred during the API call. The error message will -// contain additional details about the cause. +// A server-side error occurred. // // * ErrCodeClientException "DirectConnectClientException" -// The API was called with invalid parameters. The error message will contain -// additional details about the cause. +// One or more parameters are not valid. // // See also, https://docs.aws.amazon.com/goto/WebAPI/directconnect-2012-10-25/DescribeInterconnects func (c *DirectConnect) DescribeInterconnects(input *DescribeInterconnectsInput) (*DescribeInterconnectsOutput, error) { @@ -3174,9 +3098,7 @@ func (c *DirectConnect) DescribeLagsRequest(input *DescribeLagsInput) (req *requ // DescribeLags API operation for AWS Direct Connect. // -// Describes the link aggregation groups (LAGs) in your account. -// -// If a LAG ID is provided, only information about the specified LAG is returned. +// Describes all your link aggregation groups (LAG) or the specified LAG. // // 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 @@ -3187,12 +3109,10 @@ func (c *DirectConnect) DescribeLagsRequest(input *DescribeLagsInput) (req *requ // // Returned Error Codes: // * ErrCodeServerException "DirectConnectServerException" -// A server-side error occurred during the API call. The error message will -// contain additional details about the cause. +// A server-side error occurred. // // * ErrCodeClientException "DirectConnectClientException" -// The API was called with invalid parameters. The error message will contain -// additional details about the cause. +// One or more parameters are not valid. // // See also, https://docs.aws.amazon.com/goto/WebAPI/directconnect-2012-10-25/DescribeLags func (c *DirectConnect) DescribeLags(input *DescribeLagsInput) (*DescribeLagsOutput, error) { @@ -3260,14 +3180,14 @@ func (c *DirectConnect) DescribeLoaRequest(input *DescribeLoaInput) (req *reques // DescribeLoa API operation for AWS Direct Connect. // -// Returns the LOA-CFA for a connection, interconnect, or link aggregation group +// Gets the LOA-CFA for a connection, interconnect, or link aggregation group // (LAG). // // The Letter of Authorization - Connecting Facility Assignment (LOA-CFA) is // a document that is used when establishing your cross connect to AWS at the // colocation facility. For more information, see Requesting Cross Connects // at AWS Direct Connect Locations (http://docs.aws.amazon.com/directconnect/latest/UserGuide/Colocation.html) -// in the AWS Direct Connect user guide. +// in the AWS Direct Connect 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 @@ -3278,12 +3198,10 @@ func (c *DirectConnect) DescribeLoaRequest(input *DescribeLoaInput) (req *reques // // Returned Error Codes: // * ErrCodeServerException "DirectConnectServerException" -// A server-side error occurred during the API call. The error message will -// contain additional details about the cause. +// A server-side error occurred. // // * ErrCodeClientException "DirectConnectClientException" -// The API was called with invalid parameters. The error message will contain -// additional details about the cause. +// One or more parameters are not valid. // // See also, https://docs.aws.amazon.com/goto/WebAPI/directconnect-2012-10-25/DescribeLoa func (c *DirectConnect) DescribeLoa(input *DescribeLoaInput) (*Loa, error) { @@ -3351,9 +3269,8 @@ func (c *DirectConnect) DescribeLocationsRequest(input *DescribeLocationsInput) // DescribeLocations API operation for AWS Direct Connect. // -// Returns the list of AWS Direct Connect locations in the current AWS region. -// These are the locations that may be selected when calling CreateConnection -// or CreateInterconnect. +// Lists the AWS Direct Connect locations in the current AWS Region. These are +// the locations that can be selected when calling CreateConnection or CreateInterconnect. // // 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 @@ -3364,12 +3281,10 @@ func (c *DirectConnect) DescribeLocationsRequest(input *DescribeLocationsInput) // // Returned Error Codes: // * ErrCodeServerException "DirectConnectServerException" -// A server-side error occurred during the API call. The error message will -// contain additional details about the cause. +// A server-side error occurred. // // * ErrCodeClientException "DirectConnectClientException" -// The API was called with invalid parameters. The error message will contain -// additional details about the cause. +// One or more parameters are not valid. // // See also, https://docs.aws.amazon.com/goto/WebAPI/directconnect-2012-10-25/DescribeLocations func (c *DirectConnect) DescribeLocations(input *DescribeLocationsInput) (*DescribeLocationsOutput, error) { @@ -3437,7 +3352,7 @@ func (c *DirectConnect) DescribeTagsRequest(input *DescribeTagsInput) (req *requ // DescribeTags API operation for AWS Direct Connect. // -// Describes the tags associated with the specified Direct Connect resources. +// Describes the tags associated with the specified AWS Direct Connect resources. // // 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 @@ -3448,12 +3363,10 @@ func (c *DirectConnect) DescribeTagsRequest(input *DescribeTagsInput) (req *requ // // Returned Error Codes: // * ErrCodeServerException "DirectConnectServerException" -// A server-side error occurred during the API call. The error message will -// contain additional details about the cause. +// A server-side error occurred. // // * ErrCodeClientException "DirectConnectClientException" -// The API was called with invalid parameters. The error message will contain -// additional details about the cause. +// One or more parameters are not valid. // // See also, https://docs.aws.amazon.com/goto/WebAPI/directconnect-2012-10-25/DescribeTags func (c *DirectConnect) DescribeTags(input *DescribeTagsInput) (*DescribeTagsOutput, error) { @@ -3521,13 +3434,10 @@ func (c *DirectConnect) DescribeVirtualGatewaysRequest(input *DescribeVirtualGat // DescribeVirtualGateways API operation for AWS Direct Connect. // -// Returns a list of virtual private gateways owned by the AWS account. +// Lists the virtual private gateways owned by the AWS account. // // You can create one or more AWS Direct Connect private virtual interfaces -// linking to a virtual private gateway. A virtual private gateway can be managed -// via Amazon Virtual Private Cloud (VPC) console or the EC2 CreateVpnGateway -// (http://docs.aws.amazon.com/AWSEC2/latest/APIReference/ApiReference-query-CreateVpnGateway.html) -// action. +// linked to a virtual private gateway. // // 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 @@ -3538,12 +3448,10 @@ func (c *DirectConnect) DescribeVirtualGatewaysRequest(input *DescribeVirtualGat // // Returned Error Codes: // * ErrCodeServerException "DirectConnectServerException" -// A server-side error occurred during the API call. The error message will -// contain additional details about the cause. +// A server-side error occurred. // // * ErrCodeClientException "DirectConnectClientException" -// The API was called with invalid parameters. The error message will contain -// additional details about the cause. +// One or more parameters are not valid. // // See also, https://docs.aws.amazon.com/goto/WebAPI/directconnect-2012-10-25/DescribeVirtualGateways func (c *DirectConnect) DescribeVirtualGateways(input *DescribeVirtualGatewaysInput) (*DescribeVirtualGatewaysOutput, error) { @@ -3618,7 +3526,7 @@ func (c *DirectConnect) DescribeVirtualInterfacesRequest(input *DescribeVirtualI // a single virtual interface is returned. // // A virtual interface (VLAN) transmits the traffic between the AWS Direct Connect -// location and the customer. +// location and the customer network. // // 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 @@ -3629,12 +3537,10 @@ func (c *DirectConnect) DescribeVirtualInterfacesRequest(input *DescribeVirtualI // // Returned Error Codes: // * ErrCodeServerException "DirectConnectServerException" -// A server-side error occurred during the API call. The error message will -// contain additional details about the cause. +// A server-side error occurred. // // * ErrCodeClientException "DirectConnectClientException" -// The API was called with invalid parameters. The error message will contain -// additional details about the cause. +// One or more parameters are not valid. // // See also, https://docs.aws.amazon.com/goto/WebAPI/directconnect-2012-10-25/DescribeVirtualInterfaces func (c *DirectConnect) DescribeVirtualInterfaces(input *DescribeVirtualInterfacesInput) (*DescribeVirtualInterfacesOutput, error) { @@ -3709,7 +3615,7 @@ func (c *DirectConnect) DisassociateConnectionFromLagRequest(input *Disassociate // remain associated with the LAG. A disassociated connection owned by an AWS // Direct Connect partner is automatically converted to an interconnect. // -// If disassociating the connection will cause the LAG to fall below its setting +// If disassociating the connection would cause the LAG to fall below its setting // for minimum number of operational connections, the request fails, except // when it's the last member of the LAG. If all connections are disassociated, // the LAG continues to exist as an empty LAG with no physical connections. @@ -3723,12 +3629,10 @@ func (c *DirectConnect) DisassociateConnectionFromLagRequest(input *Disassociate // // Returned Error Codes: // * ErrCodeServerException "DirectConnectServerException" -// A server-side error occurred during the API call. The error message will -// contain additional details about the cause. +// A server-side error occurred. // // * ErrCodeClientException "DirectConnectClientException" -// The API was called with invalid parameters. The error message will contain -// additional details about the cause. +// One or more parameters are not valid. // // See also, https://docs.aws.amazon.com/goto/WebAPI/directconnect-2012-10-25/DisassociateConnectionFromLag func (c *DirectConnect) DisassociateConnectionFromLag(input *DisassociateConnectionFromLagInput) (*Connection, error) { @@ -3796,12 +3700,11 @@ func (c *DirectConnect) TagResourceRequest(input *TagResourceInput) (req *reques // TagResource API operation for AWS Direct Connect. // -// Adds the specified tags to the specified Direct Connect resource. Each Direct -// Connect resource can have a maximum of 50 tags. +// Adds the specified tags to the specified AWS Direct Connect resource. Each +// resource can have a maximum of 50 tags. // // Each tag consists of a key and an optional value. If a tag with the same -// key is already associated with the Direct Connect resource, this action updates -// its value. +// key is already associated with the resource, this action updates its value. // // 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 @@ -3815,16 +3718,13 @@ func (c *DirectConnect) TagResourceRequest(input *TagResourceInput) (req *reques // A tag key was specified more than once. // // * ErrCodeTooManyTagsException "TooManyTagsException" -// You have reached the limit on the number of tags that can be assigned to -// a Direct Connect resource. +// You have reached the limit on the number of tags that can be assigned. // // * ErrCodeServerException "DirectConnectServerException" -// A server-side error occurred during the API call. The error message will -// contain additional details about the cause. +// A server-side error occurred. // // * ErrCodeClientException "DirectConnectClientException" -// The API was called with invalid parameters. The error message will contain -// additional details about the cause. +// One or more parameters are not valid. // // See also, https://docs.aws.amazon.com/goto/WebAPI/directconnect-2012-10-25/TagResource func (c *DirectConnect) TagResource(input *TagResourceInput) (*TagResourceOutput, error) { @@ -3892,7 +3792,7 @@ func (c *DirectConnect) UntagResourceRequest(input *UntagResourceInput) (req *re // UntagResource API operation for AWS Direct Connect. // -// Removes one or more tags from the specified Direct Connect resource. +// Removes one or more tags from the specified AWS Direct Connect resource. // // 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 @@ -3903,12 +3803,10 @@ func (c *DirectConnect) UntagResourceRequest(input *UntagResourceInput) (req *re // // Returned Error Codes: // * ErrCodeServerException "DirectConnectServerException" -// A server-side error occurred during the API call. The error message will -// contain additional details about the cause. +// A server-side error occurred. // // * ErrCodeClientException "DirectConnectClientException" -// The API was called with invalid parameters. The error message will contain -// additional details about the cause. +// One or more parameters are not valid. // // See also, https://docs.aws.amazon.com/goto/WebAPI/directconnect-2012-10-25/UntagResource func (c *DirectConnect) UntagResource(input *UntagResourceInput) (*UntagResourceOutput, error) { @@ -3976,7 +3874,7 @@ func (c *DirectConnect) UpdateLagRequest(input *UpdateLagInput) (req *request.Re // UpdateLag API operation for AWS Direct Connect. // -// Updates the attributes of a link aggregation group (LAG). +// Updates the attributes of the specified link aggregation group (LAG). // // You can update the following attributes: // @@ -3986,11 +3884,11 @@ func (c *DirectConnect) UpdateLagRequest(input *UpdateLagInput) (req *request.Re // for the LAG itself to be operational. // // When you create a LAG, the default value for the minimum number of operational -// connections is zero (0). If you update this value, and the number of operational -// connections falls below the specified value, the LAG will automatically go -// down to avoid overutilization of the remaining connections. Adjusting this -// value should be done with care as it could force the LAG down if the value -// is set higher than the current number of operational connections. +// connections is zero (0). If you update this value and the number of operational +// connections falls below the specified value, the LAG automatically goes down +// to avoid over-utilization of the remaining connections. Adjust this value +// with care, as it could force the LAG down if it is set higher than the current +// number of operational connections. // // 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 @@ -4001,12 +3899,10 @@ func (c *DirectConnect) UpdateLagRequest(input *UpdateLagInput) (req *request.Re // // Returned Error Codes: // * ErrCodeServerException "DirectConnectServerException" -// A server-side error occurred during the API call. The error message will -// contain additional details about the cause. +// A server-side error occurred. // // * ErrCodeClientException "DirectConnectClientException" -// The API was called with invalid parameters. The error message will contain -// additional details about the cause. +// One or more parameters are not valid. // // See also, https://docs.aws.amazon.com/goto/WebAPI/directconnect-2012-10-25/UpdateLag func (c *DirectConnect) UpdateLag(input *UpdateLagInput) (*Lag, error) { @@ -4030,54 +3926,123 @@ func (c *DirectConnect) UpdateLagWithContext(ctx aws.Context, input *UpdateLagIn return out, req.Send() } -// Container for the parameters to the AllocateConnectionOnInterconnect operation. +const opUpdateVirtualInterfaceAttributes = "UpdateVirtualInterfaceAttributes" + +// UpdateVirtualInterfaceAttributesRequest generates a "aws/request.Request" representing the +// client's request for the UpdateVirtualInterfaceAttributes operation. The "output" return +// value will be populated with the request's response once the request completes +// successfully. +// +// Use "Send" method on the returned Request to send the API call to the service. +// the "output" return value is not valid until after Send returns without error. +// +// See UpdateVirtualInterfaceAttributes for more information on using the UpdateVirtualInterfaceAttributes +// API call, and error handling. +// +// This method is useful when you want to inject custom logic or configuration +// into the SDK's request lifecycle. Such as custom headers, or retry logic. +// +// +// // Example sending a request using the UpdateVirtualInterfaceAttributesRequest method. +// req, resp := client.UpdateVirtualInterfaceAttributesRequest(params) +// +// err := req.Send() +// if err == nil { // resp is now filled +// fmt.Println(resp) +// } +// +// See also, https://docs.aws.amazon.com/goto/WebAPI/directconnect-2012-10-25/UpdateVirtualInterfaceAttributes +func (c *DirectConnect) UpdateVirtualInterfaceAttributesRequest(input *UpdateVirtualInterfaceAttributesInput) (req *request.Request, output *UpdateVirtualInterfaceAttributesOutput) { + op := &request.Operation{ + Name: opUpdateVirtualInterfaceAttributes, + HTTPMethod: "POST", + HTTPPath: "/", + } + + if input == nil { + input = &UpdateVirtualInterfaceAttributesInput{} + } + + output = &UpdateVirtualInterfaceAttributesOutput{} + req = c.newRequest(op, input, output) + return +} + +// UpdateVirtualInterfaceAttributes API operation for AWS Direct Connect. +// +// Updates the specified attributes of the specified virtual private interface. +// +// Setting the MTU of a virtual interface to 9001 (jumbo frames) can cause an +// update to the underlying physical connection if it wasn't updated to support +// jumbo frames. Updating the connection disrupts network connectivity for all +// virtual interfaces associated with the connection for up to 30 seconds. To +// check whether your connection supports jumbo frames, call DescribeConnections. +// To check whether your virtual interface supports jumbo frames, call DescribeVirtualInterfaces. +// +// 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 Direct Connect's +// API operation UpdateVirtualInterfaceAttributes for usage and error information. +// +// Returned Error Codes: +// * ErrCodeServerException "DirectConnectServerException" +// A server-side error occurred. +// +// * ErrCodeClientException "DirectConnectClientException" +// One or more parameters are not valid. +// +// See also, https://docs.aws.amazon.com/goto/WebAPI/directconnect-2012-10-25/UpdateVirtualInterfaceAttributes +func (c *DirectConnect) UpdateVirtualInterfaceAttributes(input *UpdateVirtualInterfaceAttributesInput) (*UpdateVirtualInterfaceAttributesOutput, error) { + req, out := c.UpdateVirtualInterfaceAttributesRequest(input) + return out, req.Send() +} + +// UpdateVirtualInterfaceAttributesWithContext is the same as UpdateVirtualInterfaceAttributes with the addition of +// the ability to pass a context and additional request options. +// +// See UpdateVirtualInterfaceAttributes 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 *DirectConnect) UpdateVirtualInterfaceAttributesWithContext(ctx aws.Context, input *UpdateVirtualInterfaceAttributesInput, opts ...request.Option) (*UpdateVirtualInterfaceAttributesOutput, error) { + req, out := c.UpdateVirtualInterfaceAttributesRequest(input) + req.SetContext(ctx) + req.ApplyOptions(opts...) + return out, req.Send() +} + type AllocateConnectionOnInterconnectInput struct { _ struct{} `type:"structure"` - // Bandwidth of the connection. - // - // Example: "500Mbps" - // - // Default: None - // - // Values: 50Mbps, 100Mbps, 200Mbps, 300Mbps, 400Mbps, or 500Mbps + // The bandwidth of the connection, in Mbps. The possible values are 50Mbps, + // 100Mbps, 200Mbps, 300Mbps, 400Mbps, and 500Mbps. // // Bandwidth is a required field Bandwidth *string `locationName:"bandwidth" type:"string" required:"true"` - // Name of the provisioned connection. - // - // Example: "500M Connection to AWS" - // - // Default: None + // The name of the provisioned connection. // // ConnectionName is a required field ConnectionName *string `locationName:"connectionName" type:"string" required:"true"` - // ID of the interconnect on which the connection will be provisioned. - // - // Example: dxcon-456abc78 - // - // Default: None + // The ID of the interconnect on which the connection will be provisioned. For + // example, dxcon-456abc78. // // InterconnectId is a required field InterconnectId *string `locationName:"interconnectId" type:"string" required:"true"` - // Numeric account Id of the customer for whom the connection will be provisioned. - // - // Example: 123443215678 - // - // Default: None + // The ID of the AWS account of the customer for whom the connection will be + // provisioned. // // OwnerAccount is a required field OwnerAccount *string `locationName:"ownerAccount" type:"string" required:"true"` // The dedicated VLAN provisioned to the connection. // - // Example: 101 - // - // Default: None - // // Vlan is a required field Vlan *int64 `locationName:"vlan" type:"integer" required:"true"` } @@ -4147,54 +4112,32 @@ func (s *AllocateConnectionOnInterconnectInput) SetVlan(v int64) *AllocateConnec return s } -// Container for the parameters to theHostedConnection operation. type AllocateHostedConnectionInput struct { _ struct{} `type:"structure"` - // The bandwidth of the connection. - // - // Example: 500Mbps - // - // Default: None - // - // Values: 50Mbps, 100Mbps, 200Mbps, 300Mbps, 400Mbps, or 500Mbps + // The bandwidth of the hosted connection, in Mbps. The possible values are + // 50Mbps, 100Mbps, 200Mbps, 300Mbps, 400Mbps, and 500Mbps. // // Bandwidth is a required field Bandwidth *string `locationName:"bandwidth" type:"string" required:"true"` - // The ID of the interconnect or LAG on which the connection will be provisioned. - // - // Example: dxcon-456abc78 or dxlag-abc123 - // - // Default: None + // The ID of the interconnect or LAG. // // ConnectionId is a required field ConnectionId *string `locationName:"connectionId" type:"string" required:"true"` - // The name of the provisioned connection. - // - // Example: "500M Connection to AWS" - // - // Default: None + // The name of the hosted connection. // // ConnectionName is a required field ConnectionName *string `locationName:"connectionName" type:"string" required:"true"` - // The numeric account ID of the customer for whom the connection will be provisioned. - // - // Example: 123443215678 - // - // Default: None + // The ID of the AWS account ID of the customer for the connection. // // OwnerAccount is a required field OwnerAccount *string `locationName:"ownerAccount" type:"string" required:"true"` // The dedicated VLAN provisioned to the hosted connection. // - // Example: 101 - // - // Default: None - // // Vlan is a required field Vlan *int64 `locationName:"vlan" type:"integer" required:"true"` } @@ -4264,27 +4207,20 @@ func (s *AllocateHostedConnectionInput) SetVlan(v int64) *AllocateHostedConnecti return s } -// Container for the parameters to the AllocatePrivateVirtualInterface operation. type AllocatePrivateVirtualInterfaceInput struct { _ struct{} `type:"structure"` - // The connection ID on which the private virtual interface is provisioned. - // - // Default: None + // The ID of the connection on which the private virtual interface is provisioned. // // ConnectionId is a required field ConnectionId *string `locationName:"connectionId" type:"string" required:"true"` - // Detailed information for the private virtual interface to be provisioned. - // - // Default: None + // Information about the private virtual interface. // // NewPrivateVirtualInterfaceAllocation is a required field NewPrivateVirtualInterfaceAllocation *NewPrivateVirtualInterfaceAllocation `locationName:"newPrivateVirtualInterfaceAllocation" type:"structure" required:"true"` - // The AWS account that will own the new private virtual interface. - // - // Default: None + // The ID of the AWS account that owns the virtual private interface. // // OwnerAccount is a required field OwnerAccount *string `locationName:"ownerAccount" type:"string" required:"true"` @@ -4342,27 +4278,20 @@ func (s *AllocatePrivateVirtualInterfaceInput) SetOwnerAccount(v string) *Alloca return s } -// Container for the parameters to the AllocatePublicVirtualInterface operation. type AllocatePublicVirtualInterfaceInput struct { _ struct{} `type:"structure"` - // The connection ID on which the public virtual interface is provisioned. - // - // Default: None + // The ID of the connection on which the public virtual interface is provisioned. // // ConnectionId is a required field ConnectionId *string `locationName:"connectionId" type:"string" required:"true"` - // Detailed information for the public virtual interface to be provisioned. - // - // Default: None + // Information about the public virtual interface. // // NewPublicVirtualInterfaceAllocation is a required field NewPublicVirtualInterfaceAllocation *NewPublicVirtualInterfaceAllocation `locationName:"newPublicVirtualInterfaceAllocation" type:"structure" required:"true"` - // The AWS account that will own the new public virtual interface. - // - // Default: None + // The ID of the AWS account that owns the public virtual interface. // // OwnerAccount is a required field OwnerAccount *string `locationName:"ownerAccount" type:"string" required:"true"` @@ -4420,24 +4349,15 @@ func (s *AllocatePublicVirtualInterfaceInput) SetOwnerAccount(v string) *Allocat return s } -// Container for the parameters to the AssociateConnectionWithLag operation. type AssociateConnectionWithLagInput struct { _ struct{} `type:"structure"` - // The ID of the connection. - // - // Example: dxcon-abc123 - // - // Default: None + // The ID of the connection. For example, dxcon-abc123. // // ConnectionId is a required field ConnectionId *string `locationName:"connectionId" type:"string" required:"true"` - // The ID of the LAG with which to associate the connection. - // - // Example: dxlag-abc123 - // - // Default: None + // The ID of the LAG with which to associate the connection. For example, dxlag-abc123. // // LagId is a required field LagId *string `locationName:"lagId" type:"string" required:"true"` @@ -4481,25 +4401,16 @@ func (s *AssociateConnectionWithLagInput) SetLagId(v string) *AssociateConnectio return s } -// Container for the parameters to the AssociateHostedConnection operation. type AssociateHostedConnectionInput struct { _ struct{} `type:"structure"` // The ID of the hosted connection. // - // Example: dxcon-abc123 - // - // Default: None - // // ConnectionId is a required field ConnectionId *string `locationName:"connectionId" type:"string" required:"true"` // The ID of the interconnect or the LAG. // - // Example: dxcon-abc123 or dxlag-abc123 - // - // Default: None - // // ParentConnectionId is a required field ParentConnectionId *string `locationName:"parentConnectionId" type:"string" required:"true"` } @@ -4542,25 +4453,16 @@ func (s *AssociateHostedConnectionInput) SetParentConnectionId(v string) *Associ return s } -// Container for the parameters to the AssociateVirtualInterface operation. type AssociateVirtualInterfaceInput struct { _ struct{} `type:"structure"` - // The ID of the LAG or connection with which to associate the virtual interface. - // - // Example: dxlag-abc123 or dxcon-abc123 - // - // Default: None + // The ID of the LAG or connection. // // ConnectionId is a required field ConnectionId *string `locationName:"connectionId" type:"string" required:"true"` // The ID of the virtual interface. // - // Example: dxvif-123dfg56 - // - // Default: None - // // VirtualInterfaceId is a required field VirtualInterfaceId *string `locationName:"virtualInterfaceId" type:"string" required:"true"` } @@ -4603,64 +4505,53 @@ func (s *AssociateVirtualInterfaceInput) SetVirtualInterfaceId(v string) *Associ return s } -// A structure containing information about a BGP peer. +// Information about a BGP peer. type BGPPeer struct { _ struct{} `type:"structure"` - // Indicates the address family for the BGP peer. - // - // * ipv4: IPv4 address family - // - // * ipv6: IPv6 address family + // The address family for the BGP peer. AddressFamily *string `locationName:"addressFamily" type:"string" enum:"AddressFamily"` - // IP address assigned to the Amazon interface. - // - // Example: 192.168.1.1/30 or 2001:db8::1/125 + // The IP address assigned to the Amazon interface. AmazonAddress *string `locationName:"amazonAddress" type:"string"` // The autonomous system (AS) number for Border Gateway Protocol (BGP) configuration. - // - // Example: 65000 Asn *int64 `locationName:"asn" type:"integer"` // The authentication key for BGP configuration. - // - // Example: asdf34example AuthKey *string `locationName:"authKey" type:"string"` - // The Direct Connection endpoint which the BGP peer terminates on. + // The Direct Connect endpoint on which the BGP peer terminates. AwsDeviceV2 *string `locationName:"awsDeviceV2" type:"string"` - // The state of the BGP peer. + // The state of the BGP peer. The following are the possible values: // - // * Verifying: The BGP peering addresses or ASN require validation before - // the BGP peer can be created. This state only applies to BGP peers on a - // public virtual interface. + // * verifying: The BGP peering addresses or ASN require validation before + // the BGP peer can be created. This state applies only to public virtual + // interfaces. // - // * Pending: The BGP peer has been created, and is in this state until it + // * pending: The BGP peer is created, and remains in this state until it // is ready to be established. // - // * Available: The BGP peer can be established. + // * available: The BGP peer is ready to be established. // - // * Deleting: The BGP peer is in the process of being deleted. + // * deleting: The BGP peer is being deleted. // - // * Deleted: The BGP peer has been deleted and cannot be established. + // * deleted: The BGP peer is deleted and cannot be established. BgpPeerState *string `locationName:"bgpPeerState" type:"string" enum:"BGPPeerState"` - // The Up/Down state of the BGP peer. + // The status of the BGP peer. The following are the possible values: // - // * Up: The BGP peer is established. + // * up: The BGP peer is established. This state does not indicate the state + // of the routing function. Ensure that you are receiving routes over the + // BGP session. // - // A state of up does not indicate the state of the routing function. Ensure - // that you are receiving routes over the BGP session. + // * down: The BGP peer is down. // - // * Down: The BGP peer is down. + // * unknown: The BGP peer status is unknown. BgpStatus *string `locationName:"bgpStatus" type:"string" enum:"BGPStatus"` - // IP address assigned to the customer interface. - // - // Example: 192.168.1.2/30 or 2001:db8::2/125 + // The IP address assigned to the customer interface. CustomerAddress *string `locationName:"customerAddress" type:"string"` } @@ -4722,16 +4613,10 @@ func (s *BGPPeer) SetCustomerAddress(v string) *BGPPeer { return s } -// Container for the parameters to the ConfirmConnection operation. type ConfirmConnectionInput struct { _ struct{} `type:"structure"` - // The ID of the connection. This field is also used as the ID type for operations - // that use multiple connection types (LAG, interconnect, and/or connection). - // - // Example: dxcon-fg5678gh - // - // Default: None + // The ID of the hosted connection. // // ConnectionId is a required field ConnectionId *string `locationName:"connectionId" type:"string" required:"true"` @@ -4766,32 +4651,31 @@ func (s *ConfirmConnectionInput) SetConnectionId(v string) *ConfirmConnectionInp return s } -// The response received when ConfirmConnection is called. type ConfirmConnectionOutput struct { _ struct{} `type:"structure"` - // State of the connection. + // The state of the connection. The following are the possible values: // - // * Ordering: The initial state of a hosted connection provisioned on an + // * ordering: The initial state of a hosted connection provisioned on an // interconnect. The connection stays in the ordering state until the owner // of the hosted connection confirms or declines the connection order. // - // * Requested: The initial state of a standard connection. The connection + // * requested: The initial state of a standard connection. The connection // stays in the requested state until the Letter of Authorization (LOA) is // sent to the customer. // - // * Pending: The connection has been approved, and is being initialized. + // * pending: The connection has been approved and is being initialized. // - // * Available: The network link is up, and the connection is ready for use. + // * available: The network link is up and the connection is ready for use. // - // * Down: The network link is down. + // * down: The network link is down. // - // * Deleting: The connection is in the process of being deleted. + // * deleting: The connection is being deleted. // - // * Deleted: The connection has been deleted. + // * deleted: The connection has been deleted. // - // * Rejected: A hosted connection in the 'Ordering' state will enter the - // 'Rejected' state if it is deleted by the end customer. + // * rejected: A hosted connection in the ordering state enters the rejected + // state if it is deleted by the customer. ConnectionState *string `locationName:"connectionState" type:"string" enum:"ConnectionState"` } @@ -4811,33 +4695,17 @@ func (s *ConfirmConnectionOutput) SetConnectionState(v string) *ConfirmConnectio return s } -// Container for the parameters to the ConfirmPrivateVirtualInterface operation. type ConfirmPrivateVirtualInterfaceInput struct { _ struct{} `type:"structure"` - // ID of the direct connect gateway that will be attached to the virtual interface. - // - // A direct connect gateway can be managed via the AWS Direct Connect console - // or the CreateDirectConnectGateway action. - // - // Default: None + // The ID of the Direct Connect gateway. DirectConnectGatewayId *string `locationName:"directConnectGatewayId" type:"string"` - // ID of the virtual private gateway that will be attached to the virtual interface. - // - // A virtual private gateway can be managed via the Amazon Virtual Private Cloud - // (VPC) console or the EC2 CreateVpnGateway (http://docs.aws.amazon.com/AWSEC2/latest/APIReference/ApiReference-query-CreateVpnGateway.html) - // action. - // - // Default: None + // The ID of the virtual private gateway. VirtualGatewayId *string `locationName:"virtualGatewayId" type:"string"` // The ID of the virtual interface. // - // Example: dxvif-123dfg56 - // - // Default: None - // // VirtualInterfaceId is a required field VirtualInterfaceId *string `locationName:"virtualInterfaceId" type:"string" required:"true"` } @@ -4883,37 +4751,36 @@ func (s *ConfirmPrivateVirtualInterfaceInput) SetVirtualInterfaceId(v string) *C return s } -// The response received when ConfirmPrivateVirtualInterface is called. type ConfirmPrivateVirtualInterfaceOutput struct { _ struct{} `type:"structure"` - // State of the virtual interface. + // The state of the virtual interface. The following are the possible values: // - // * Confirming: The creation of the virtual interface is pending confirmation + // * confirming: The creation of the virtual interface is pending confirmation // from the virtual interface owner. If the owner of the virtual interface // is different from the owner of the connection on which it is provisioned, // then the virtual interface will remain in this state until it is confirmed // by the virtual interface owner. // - // * Verifying: This state only applies to public virtual interfaces. Each + // * verifying: This state only applies to public virtual interfaces. Each // public virtual interface needs validation before the virtual interface // can be created. // - // * Pending: A virtual interface is in this state from the time that it + // * pending: A virtual interface is in this state from the time that it // is created until the virtual interface is ready to forward traffic. // - // * Available: A virtual interface that is able to forward traffic. + // * available: A virtual interface that is able to forward traffic. // - // * Down: A virtual interface that is BGP down. + // * down: A virtual interface that is BGP down. // - // * Deleting: A virtual interface is in this state immediately after calling + // * deleting: A virtual interface is in this state immediately after calling // DeleteVirtualInterface until it can no longer forward traffic. // - // * Deleted: A virtual interface that cannot forward traffic. + // * deleted: A virtual interface that cannot forward traffic. // - // * Rejected: The virtual interface owner has declined creation of the virtual - // interface. If a virtual interface in the 'Confirming' state is deleted - // by the virtual interface owner, the virtual interface will enter the 'Rejected' + // * rejected: The virtual interface owner has declined creation of the virtual + // interface. If a virtual interface in the Confirming state is deleted by + // the virtual interface owner, the virtual interface enters the Rejected // state. VirtualInterfaceState *string `locationName:"virtualInterfaceState" type:"string" enum:"VirtualInterfaceState"` } @@ -4934,16 +4801,11 @@ func (s *ConfirmPrivateVirtualInterfaceOutput) SetVirtualInterfaceState(v string return s } -// Container for the parameters to the ConfirmPublicVirtualInterface operation. type ConfirmPublicVirtualInterfaceInput struct { _ struct{} `type:"structure"` // The ID of the virtual interface. // - // Example: dxvif-123dfg56 - // - // Default: None - // // VirtualInterfaceId is a required field VirtualInterfaceId *string `locationName:"virtualInterfaceId" type:"string" required:"true"` } @@ -4977,37 +4839,36 @@ func (s *ConfirmPublicVirtualInterfaceInput) SetVirtualInterfaceId(v string) *Co return s } -// The response received when ConfirmPublicVirtualInterface is called. type ConfirmPublicVirtualInterfaceOutput struct { _ struct{} `type:"structure"` - // State of the virtual interface. + // The state of the virtual interface. The following are the possible values: // - // * Confirming: The creation of the virtual interface is pending confirmation + // * confirming: The creation of the virtual interface is pending confirmation // from the virtual interface owner. If the owner of the virtual interface // is different from the owner of the connection on which it is provisioned, // then the virtual interface will remain in this state until it is confirmed // by the virtual interface owner. // - // * Verifying: This state only applies to public virtual interfaces. Each + // * verifying: This state only applies to public virtual interfaces. Each // public virtual interface needs validation before the virtual interface // can be created. // - // * Pending: A virtual interface is in this state from the time that it + // * pending: A virtual interface is in this state from the time that it // is created until the virtual interface is ready to forward traffic. // - // * Available: A virtual interface that is able to forward traffic. + // * available: A virtual interface that is able to forward traffic. // - // * Down: A virtual interface that is BGP down. + // * down: A virtual interface that is BGP down. // - // * Deleting: A virtual interface is in this state immediately after calling + // * deleting: A virtual interface is in this state immediately after calling // DeleteVirtualInterface until it can no longer forward traffic. // - // * Deleted: A virtual interface that cannot forward traffic. + // * deleted: A virtual interface that cannot forward traffic. // - // * Rejected: The virtual interface owner has declined creation of the virtual - // interface. If a virtual interface in the 'Confirming' state is deleted - // by the virtual interface owner, the virtual interface will enter the 'Rejected' + // * rejected: The virtual interface owner has declined creation of the virtual + // interface. If a virtual interface in the Confirming state is deleted by + // the virtual interface owner, the virtual interface enters the Rejected // state. VirtualInterfaceState *string `locationName:"virtualInterfaceState" type:"string" enum:"VirtualInterfaceState"` } @@ -5028,96 +4889,71 @@ func (s *ConfirmPublicVirtualInterfaceOutput) SetVirtualInterfaceState(v string) return s } -// A connection represents the physical network connection between the AWS Direct -// Connect location and the customer. +// Information about an AWS Direct Connect connection. type Connection struct { _ struct{} `type:"structure"` - // Deprecated in favor of awsDeviceV2. - // - // The Direct Connection endpoint which the physical connection terminates on. + // The Direct Connect endpoint on which the physical connection terminates. AwsDevice *string `locationName:"awsDevice" deprecated:"true" type:"string"` - // The Direct Connection endpoint which the physical connection terminates on. + // The Direct Connect endpoint on which the physical connection terminates. AwsDeviceV2 *string `locationName:"awsDeviceV2" type:"string"` - // Bandwidth of the connection. - // - // Example: 1Gbps (for regular connections), or 500Mbps (for hosted connections) - // - // Default: None + // The bandwidth of the connection. Bandwidth *string `locationName:"bandwidth" type:"string"` - // The ID of the connection. This field is also used as the ID type for operations - // that use multiple connection types (LAG, interconnect, and/or connection). - // - // Example: dxcon-fg5678gh - // - // Default: None + // The ID of the connection. ConnectionId *string `locationName:"connectionId" type:"string"` // The name of the connection. - // - // Example: "My Connection to AWS" - // - // Default: None ConnectionName *string `locationName:"connectionName" type:"string"` - // State of the connection. + // The state of the connection. The following are the possible values: // - // * Ordering: The initial state of a hosted connection provisioned on an + // * ordering: The initial state of a hosted connection provisioned on an // interconnect. The connection stays in the ordering state until the owner // of the hosted connection confirms or declines the connection order. // - // * Requested: The initial state of a standard connection. The connection + // * requested: The initial state of a standard connection. The connection // stays in the requested state until the Letter of Authorization (LOA) is // sent to the customer. // - // * Pending: The connection has been approved, and is being initialized. + // * pending: The connection has been approved and is being initialized. // - // * Available: The network link is up, and the connection is ready for use. + // * available: The network link is up and the connection is ready for use. // - // * Down: The network link is down. + // * down: The network link is down. // - // * Deleting: The connection is in the process of being deleted. + // * deleting: The connection is being deleted. // - // * Deleted: The connection has been deleted. + // * deleted: The connection has been deleted. // - // * Rejected: A hosted connection in the 'Ordering' state will enter the - // 'Rejected' state if it is deleted by the end customer. + // * rejected: A hosted connection in the ordering state enters the rejected + // state if it is deleted by the customer. ConnectionState *string `locationName:"connectionState" type:"string" enum:"ConnectionState"` + // Indicates whether jumbo frames (9001 MTU) are supported. + JumboFrameCapable *bool `locationName:"jumboFrameCapable" type:"boolean"` + // The ID of the LAG. - // - // Example: dxlag-fg5678gh LagId *string `locationName:"lagId" type:"string"` // The time of the most recent call to DescribeLoa for this connection. LoaIssueTime *time.Time `locationName:"loaIssueTime" type:"timestamp"` - // Where the connection is located. - // - // Example: EqSV5 - // - // Default: None + // The location of the connection. Location *string `locationName:"location" type:"string"` - // The AWS account that will own the new connection. + // The ID of the AWS account that owns the connection. OwnerAccount *string `locationName:"ownerAccount" type:"string"` // The name of the AWS Direct Connect service provider associated with the connection. PartnerName *string `locationName:"partnerName" type:"string"` - // The AWS region where the connection is located. - // - // Example: us-east-1 - // - // Default: None + // The AWS Region where the connection is located. Region *string `locationName:"region" type:"string"` - // The VLAN ID. - // - // Example: 101 + // The ID of the VLAN. Vlan *int64 `locationName:"vlan" type:"integer"` } @@ -5167,6 +5003,12 @@ func (s *Connection) SetConnectionState(v string) *Connection { return s } +// SetJumboFrameCapable sets the JumboFrameCapable field's value. +func (s *Connection) SetJumboFrameCapable(v bool) *Connection { + s.JumboFrameCapable = &v + return s +} + // SetLagId sets the LagId field's value. func (s *Connection) SetLagId(v string) *Connection { s.LagId = &v @@ -5209,11 +5051,10 @@ func (s *Connection) SetVlan(v int64) *Connection { return s } -// A structure containing a list of connections. type Connections struct { _ struct{} `type:"structure"` - // A list of connections. + // The connections. Connections []*Connection `locationName:"connections" type:"list"` } @@ -5233,20 +5074,13 @@ func (s *Connections) SetConnections(v []*Connection) *Connections { return s } -// Container for the parameters to the CreateBGPPeer operation. type CreateBGPPeerInput struct { _ struct{} `type:"structure"` - // Detailed information for the BGP peer to be created. - // - // Default: None + // Information about the BGP peer. NewBGPPeer *NewBGPPeer `locationName:"newBGPPeer" type:"structure"` - // The ID of the virtual interface on which the BGP peer will be provisioned. - // - // Example: dxvif-456abc78 - // - // Default: None + // The ID of the virtual interface. VirtualInterfaceId *string `locationName:"virtualInterfaceId" type:"string"` } @@ -5272,12 +5106,10 @@ func (s *CreateBGPPeerInput) SetVirtualInterfaceId(v string) *CreateBGPPeerInput return s } -// The response received when CreateBGPPeer is called. type CreateBGPPeerOutput struct { _ struct{} `type:"structure"` - // A virtual interface (VLAN) transmits the traffic between the AWS Direct Connect - // location and the customer. + // The virtual interface. VirtualInterface *VirtualInterface `locationName:"virtualInterface" type:"structure"` } @@ -5297,38 +5129,23 @@ func (s *CreateBGPPeerOutput) SetVirtualInterface(v *VirtualInterface) *CreateBG return s } -// Container for the parameters to the CreateConnection operation. type CreateConnectionInput struct { _ struct{} `type:"structure"` - // Bandwidth of the connection. - // - // Example: 1Gbps - // - // Default: None + // The bandwidth of the connection. // // Bandwidth is a required field Bandwidth *string `locationName:"bandwidth" type:"string" required:"true"` // The name of the connection. // - // Example: "My Connection to AWS" - // - // Default: None - // // ConnectionName is a required field ConnectionName *string `locationName:"connectionName" type:"string" required:"true"` // The ID of the LAG. - // - // Example: dxlag-fg5678gh LagId *string `locationName:"lagId" type:"string"` - // Where the connection is located. - // - // Example: EqSV5 - // - // Default: None + // The location of the connection. // // Location is a required field Location *string `locationName:"location" type:"string" required:"true"` @@ -5387,26 +5204,16 @@ func (s *CreateConnectionInput) SetLocation(v string) *CreateConnectionInput { return s } -// Container for the parameters to the CreateDirectConnectGatewayAssociation -// operation. type CreateDirectConnectGatewayAssociationInput struct { _ struct{} `type:"structure"` - // The ID of the direct connect gateway. - // - // Example: "abcd1234-dcba-5678-be23-cdef9876ab45" - // - // Default: None + // The ID of the Direct Connect gateway. // // DirectConnectGatewayId is a required field DirectConnectGatewayId *string `locationName:"directConnectGatewayId" type:"string" required:"true"` // The ID of the virtual private gateway. // - // Example: "vgw-abc123ef" - // - // Default: None - // // VirtualGatewayId is a required field VirtualGatewayId *string `locationName:"virtualGatewayId" type:"string" required:"true"` } @@ -5449,12 +5256,10 @@ func (s *CreateDirectConnectGatewayAssociationInput) SetVirtualGatewayId(v strin return s } -// Container for the response from the CreateDirectConnectGatewayAssociation -// API call type CreateDirectConnectGatewayAssociationOutput struct { _ struct{} `type:"structure"` - // The direct connect gateway association to be created. + // The association to be created. DirectConnectGatewayAssociation *GatewayAssociation `locationName:"directConnectGatewayAssociation" type:"structure"` } @@ -5474,24 +5279,16 @@ func (s *CreateDirectConnectGatewayAssociationOutput) SetDirectConnectGatewayAss return s } -// Container for the parameters to the CreateDirectConnectGateway operation. type CreateDirectConnectGatewayInput struct { _ struct{} `type:"structure"` // The autonomous system number (ASN) for Border Gateway Protocol (BGP) to be // configured on the Amazon side of the connection. The ASN must be in the private - // range of 64,512 to 65,534 or 4,200,000,000 to 4,294,967,294 - // - // Example: 65200 - // - // Default: 64512 + // range of 64,512 to 65,534 or 4,200,000,000 to 4,294,967,294. The default + // is 64512. AmazonSideAsn *int64 `locationName:"amazonSideAsn" type:"long"` - // The name of the direct connect gateway. - // - // Example: "My direct connect gateway" - // - // Default: None + // The name of the Direct Connect gateway. // // DirectConnectGatewayName is a required field DirectConnectGatewayName *string `locationName:"directConnectGatewayName" type:"string" required:"true"` @@ -5532,11 +5329,10 @@ func (s *CreateDirectConnectGatewayInput) SetDirectConnectGatewayName(v string) return s } -// Container for the response from the CreateDirectConnectGateway API call type CreateDirectConnectGatewayOutput struct { _ struct{} `type:"structure"` - // The direct connect gateway to be created. + // The Direct Connect gateway. DirectConnectGateway *Gateway `locationName:"directConnectGateway" type:"structure"` } @@ -5556,40 +5352,23 @@ func (s *CreateDirectConnectGatewayOutput) SetDirectConnectGateway(v *Gateway) * return s } -// Container for the parameters to the CreateInterconnect operation. type CreateInterconnectInput struct { _ struct{} `type:"structure"` - // The port bandwidth - // - // Example: 1Gbps - // - // Default: None - // - // Available values: 1Gbps,10Gbps + // The port bandwidth, in Gbps. The possible values are 1 and 10. // // Bandwidth is a required field Bandwidth *string `locationName:"bandwidth" type:"string" required:"true"` // The name of the interconnect. // - // Example: "1G Interconnect to AWS" - // - // Default: None - // // InterconnectName is a required field InterconnectName *string `locationName:"interconnectName" type:"string" required:"true"` // The ID of the LAG. - // - // Example: dxlag-fg5678gh LagId *string `locationName:"lagId" type:"string"` - // Where the interconnect is located - // - // Example: EqSV5 - // - // Default: None + // The location of the interconnect. // // Location is a required field Location *string `locationName:"location" type:"string" required:"true"` @@ -5648,38 +5427,24 @@ func (s *CreateInterconnectInput) SetLocation(v string) *CreateInterconnectInput return s } -// Container for the parameters to the CreateLag operation. type CreateLagInput struct { _ struct{} `type:"structure"` // The ID of an existing connection to migrate to the LAG. - // - // Default: None ConnectionId *string `locationName:"connectionId" type:"string"` // The bandwidth of the individual physical connections bundled by the LAG. - // - // Default: None - // - // Available values: 1Gbps, 10Gbps + // The possible values are 1Gbps and 10Gbps. // // ConnectionsBandwidth is a required field ConnectionsBandwidth *string `locationName:"connectionsBandwidth" type:"string" required:"true"` // The name of the LAG. // - // Example: "3x10G LAG to AWS" - // - // Default: None - // // LagName is a required field LagName *string `locationName:"lagName" type:"string" required:"true"` - // The AWS Direct Connect location in which the LAG should be allocated. - // - // Example: EqSV5 - // - // Default: None + // The location for the LAG. // // Location is a required field Location *string `locationName:"location" type:"string" required:"true"` @@ -5687,8 +5452,6 @@ type CreateLagInput struct { // The number of physical connections initially provisioned and bundled by the // LAG. // - // Default: None - // // NumberOfConnections is a required field NumberOfConnections *int64 `locationName:"numberOfConnections" type:"integer" required:"true"` } @@ -5755,23 +5518,15 @@ func (s *CreateLagInput) SetNumberOfConnections(v int64) *CreateLagInput { return s } -// Container for the parameters to the CreatePrivateVirtualInterface operation. type CreatePrivateVirtualInterfaceInput struct { _ struct{} `type:"structure"` - // The ID of the connection. This field is also used as the ID type for operations - // that use multiple connection types (LAG, interconnect, and/or connection). - // - // Example: dxcon-fg5678gh - // - // Default: None + // The ID of the connection. // // ConnectionId is a required field ConnectionId *string `locationName:"connectionId" type:"string" required:"true"` - // Detailed information for the private virtual interface to be created. - // - // Default: None + // Information about the private virtual interface. // // NewPrivateVirtualInterface is a required field NewPrivateVirtualInterface *NewPrivateVirtualInterface `locationName:"newPrivateVirtualInterface" type:"structure" required:"true"` @@ -5820,23 +5575,15 @@ func (s *CreatePrivateVirtualInterfaceInput) SetNewPrivateVirtualInterface(v *Ne return s } -// Container for the parameters to the CreatePublicVirtualInterface operation. type CreatePublicVirtualInterfaceInput struct { _ struct{} `type:"structure"` - // The ID of the connection. This field is also used as the ID type for operations - // that use multiple connection types (LAG, interconnect, and/or connection). - // - // Example: dxcon-fg5678gh - // - // Default: None + // The ID of the connection. // // ConnectionId is a required field ConnectionId *string `locationName:"connectionId" type:"string" required:"true"` - // Detailed information for the public virtual interface to be created. - // - // Default: None + // Information about the public virtual interface. // // NewPublicVirtualInterface is a required field NewPublicVirtualInterface *NewPublicVirtualInterface `locationName:"newPublicVirtualInterface" type:"structure" required:"true"` @@ -5885,25 +5632,16 @@ func (s *CreatePublicVirtualInterfaceInput) SetNewPublicVirtualInterface(v *NewP return s } -// Container for the parameters to the DeleteBGPPeer operation. type DeleteBGPPeerInput struct { _ struct{} `type:"structure"` // The autonomous system (AS) number for Border Gateway Protocol (BGP) configuration. - // - // Example: 65000 Asn *int64 `locationName:"asn" type:"integer"` - // IP address assigned to the customer interface. - // - // Example: 192.168.1.2/30 or 2001:db8::2/125 + // The IP address assigned to the customer interface. CustomerAddress *string `locationName:"customerAddress" type:"string"` - // The ID of the virtual interface from which the BGP peer will be deleted. - // - // Example: dxvif-456abc78 - // - // Default: None + // The ID of the virtual interface. VirtualInterfaceId *string `locationName:"virtualInterfaceId" type:"string"` } @@ -5935,12 +5673,10 @@ func (s *DeleteBGPPeerInput) SetVirtualInterfaceId(v string) *DeleteBGPPeerInput return s } -// The response received when DeleteBGPPeer is called. type DeleteBGPPeerOutput struct { _ struct{} `type:"structure"` - // A virtual interface (VLAN) transmits the traffic between the AWS Direct Connect - // location and the customer. + // The virtual interface. VirtualInterface *VirtualInterface `locationName:"virtualInterface" type:"structure"` } @@ -5960,16 +5696,10 @@ func (s *DeleteBGPPeerOutput) SetVirtualInterface(v *VirtualInterface) *DeleteBG return s } -// Container for the parameters to the DeleteConnection operation. type DeleteConnectionInput struct { _ struct{} `type:"structure"` - // The ID of the connection. This field is also used as the ID type for operations - // that use multiple connection types (LAG, interconnect, and/or connection). - // - // Example: dxcon-fg5678gh - // - // Default: None + // The ID of the connection. // // ConnectionId is a required field ConnectionId *string `locationName:"connectionId" type:"string" required:"true"` @@ -6004,26 +5734,16 @@ func (s *DeleteConnectionInput) SetConnectionId(v string) *DeleteConnectionInput return s } -// Container for the parameters to the DeleteDirectConnectGatewayAssociation -// operation. type DeleteDirectConnectGatewayAssociationInput struct { _ struct{} `type:"structure"` - // The ID of the direct connect gateway. - // - // Example: "abcd1234-dcba-5678-be23-cdef9876ab45" - // - // Default: None + // The ID of the Direct Connect gateway. // // DirectConnectGatewayId is a required field DirectConnectGatewayId *string `locationName:"directConnectGatewayId" type:"string" required:"true"` // The ID of the virtual private gateway. // - // Example: "vgw-abc123ef" - // - // Default: None - // // VirtualGatewayId is a required field VirtualGatewayId *string `locationName:"virtualGatewayId" type:"string" required:"true"` } @@ -6066,12 +5786,10 @@ func (s *DeleteDirectConnectGatewayAssociationInput) SetVirtualGatewayId(v strin return s } -// Container for the response from the DeleteDirectConnectGatewayAssociation -// API call type DeleteDirectConnectGatewayAssociationOutput struct { _ struct{} `type:"structure"` - // The direct connect gateway association to be deleted. + // The association to be deleted. DirectConnectGatewayAssociation *GatewayAssociation `locationName:"directConnectGatewayAssociation" type:"structure"` } @@ -6091,15 +5809,10 @@ func (s *DeleteDirectConnectGatewayAssociationOutput) SetDirectConnectGatewayAss return s } -// Container for the parameters to the DeleteDirectConnectGateway operation. type DeleteDirectConnectGatewayInput struct { _ struct{} `type:"structure"` - // The ID of the direct connect gateway. - // - // Example: "abcd1234-dcba-5678-be23-cdef9876ab45" - // - // Default: None + // The ID of the Direct Connect gateway. // // DirectConnectGatewayId is a required field DirectConnectGatewayId *string `locationName:"directConnectGatewayId" type:"string" required:"true"` @@ -6134,11 +5847,10 @@ func (s *DeleteDirectConnectGatewayInput) SetDirectConnectGatewayId(v string) *D return s } -// Container for the response from the DeleteDirectConnectGateway API call type DeleteDirectConnectGatewayOutput struct { _ struct{} `type:"structure"` - // The direct connect gateway to be deleted. + // The Direct Connect gateway. DirectConnectGateway *Gateway `locationName:"directConnectGateway" type:"structure"` } @@ -6158,14 +5870,11 @@ func (s *DeleteDirectConnectGatewayOutput) SetDirectConnectGateway(v *Gateway) * return s } -// Container for the parameters to the DeleteInterconnect operation. type DeleteInterconnectInput struct { _ struct{} `type:"structure"` // The ID of the interconnect. // - // Example: dxcon-abc123 - // // InterconnectId is a required field InterconnectId *string `locationName:"interconnectId" type:"string" required:"true"` } @@ -6199,26 +5908,25 @@ func (s *DeleteInterconnectInput) SetInterconnectId(v string) *DeleteInterconnec return s } -// The response received when DeleteInterconnect is called. type DeleteInterconnectOutput struct { _ struct{} `type:"structure"` - // State of the interconnect. + // The state of the interconnect. The following are the possible values: // - // * Requested: The initial state of an interconnect. The interconnect stays + // * requested: The initial state of an interconnect. The interconnect stays // in the requested state until the Letter of Authorization (LOA) is sent // to the customer. // - // * Pending: The interconnect has been approved, and is being initialized. + // * pending: The interconnect is approved, and is being initialized. // - // * Available: The network link is up, and the interconnect is ready for + // * available: The network link is up, and the interconnect is ready for // use. // - // * Down: The network link is down. + // * down: The network link is down. // - // * Deleting: The interconnect is in the process of being deleted. + // * deleting: The interconnect is being deleted. // - // * Deleted: The interconnect has been deleted. + // * deleted: The interconnect is deleted. InterconnectState *string `locationName:"interconnectState" type:"string" enum:"InterconnectState"` } @@ -6238,15 +5946,10 @@ func (s *DeleteInterconnectOutput) SetInterconnectState(v string) *DeleteInterco return s } -// Container for the parameters to the DeleteLag operation. type DeleteLagInput struct { _ struct{} `type:"structure"` - // The ID of the LAG to delete. - // - // Example: dxlag-abc123 - // - // Default: None + // The ID of the LAG. // // LagId is a required field LagId *string `locationName:"lagId" type:"string" required:"true"` @@ -6281,16 +5984,11 @@ func (s *DeleteLagInput) SetLagId(v string) *DeleteLagInput { return s } -// Container for the parameters to the DeleteVirtualInterface operation. type DeleteVirtualInterfaceInput struct { _ struct{} `type:"structure"` // The ID of the virtual interface. // - // Example: dxvif-123dfg56 - // - // Default: None - // // VirtualInterfaceId is a required field VirtualInterfaceId *string `locationName:"virtualInterfaceId" type:"string" required:"true"` } @@ -6324,37 +6022,36 @@ func (s *DeleteVirtualInterfaceInput) SetVirtualInterfaceId(v string) *DeleteVir return s } -// The response received when DeleteVirtualInterface is called. type DeleteVirtualInterfaceOutput struct { _ struct{} `type:"structure"` - // State of the virtual interface. + // The state of the virtual interface. The following are the possible values: // - // * Confirming: The creation of the virtual interface is pending confirmation + // * confirming: The creation of the virtual interface is pending confirmation // from the virtual interface owner. If the owner of the virtual interface // is different from the owner of the connection on which it is provisioned, // then the virtual interface will remain in this state until it is confirmed // by the virtual interface owner. // - // * Verifying: This state only applies to public virtual interfaces. Each + // * verifying: This state only applies to public virtual interfaces. Each // public virtual interface needs validation before the virtual interface // can be created. // - // * Pending: A virtual interface is in this state from the time that it + // * pending: A virtual interface is in this state from the time that it // is created until the virtual interface is ready to forward traffic. // - // * Available: A virtual interface that is able to forward traffic. + // * available: A virtual interface that is able to forward traffic. // - // * Down: A virtual interface that is BGP down. + // * down: A virtual interface that is BGP down. // - // * Deleting: A virtual interface is in this state immediately after calling + // * deleting: A virtual interface is in this state immediately after calling // DeleteVirtualInterface until it can no longer forward traffic. // - // * Deleted: A virtual interface that cannot forward traffic. + // * deleted: A virtual interface that cannot forward traffic. // - // * Rejected: The virtual interface owner has declined creation of the virtual - // interface. If a virtual interface in the 'Confirming' state is deleted - // by the virtual interface owner, the virtual interface will enter the 'Rejected' + // * rejected: The virtual interface owner has declined creation of the virtual + // interface. If a virtual interface in the Confirming state is deleted by + // the virtual interface owner, the virtual interface enters the Rejected // state. VirtualInterfaceState *string `locationName:"virtualInterfaceState" type:"string" enum:"VirtualInterfaceState"` } @@ -6375,31 +6072,21 @@ func (s *DeleteVirtualInterfaceOutput) SetVirtualInterfaceState(v string) *Delet return s } -// Container for the parameters to the DescribeConnectionLoa operation. type DescribeConnectionLoaInput struct { _ struct{} `type:"structure"` - // The ID of the connection. This field is also used as the ID type for operations - // that use multiple connection types (LAG, interconnect, and/or connection). - // - // Example: dxcon-fg5678gh - // - // Default: None + // The ID of the connection. // // ConnectionId is a required field ConnectionId *string `locationName:"connectionId" type:"string" required:"true"` - // A standard media type indicating the content type of the LOA-CFA document. - // Currently, the only supported value is "application/pdf". - // - // Default: application/pdf + // The standard media type for the LOA-CFA document. The only supported value + // is application/pdf. LoaContentType *string `locationName:"loaContentType" type:"string" enum:"LoaContentType"` // The name of the APN partner or service provider who establishes connectivity - // on your behalf. If you supply this parameter, the LOA-CFA lists the provider + // on your behalf. If you specify this parameter, the LOA-CFA lists the provider // name alongside your company name as the requester of the cross connect. - // - // Default: None ProviderName *string `locationName:"providerName" type:"string"` } @@ -6444,12 +6131,10 @@ func (s *DescribeConnectionLoaInput) SetProviderName(v string) *DescribeConnecti return s } -// The response received when DescribeConnectionLoa is called. type DescribeConnectionLoaOutput struct { _ struct{} `type:"structure"` - // A structure containing the Letter of Authorization - Connecting Facility - // Assignment (LOA-CFA) for a connection. + // The Letter of Authorization - Connecting Facility Assignment (LOA-CFA). Loa *Loa `locationName:"loa" type:"structure"` } @@ -6469,16 +6154,10 @@ func (s *DescribeConnectionLoaOutput) SetLoa(v *Loa) *DescribeConnectionLoaOutpu return s } -// Container for the parameters to the DescribeConnections operation. type DescribeConnectionsInput struct { _ struct{} `type:"structure"` - // The ID of the connection. This field is also used as the ID type for operations - // that use multiple connection types (LAG, interconnect, and/or connection). - // - // Example: dxcon-fg5678gh - // - // Default: None + // The ID of the connection. ConnectionId *string `locationName:"connectionId" type:"string"` } @@ -6498,15 +6177,10 @@ func (s *DescribeConnectionsInput) SetConnectionId(v string) *DescribeConnection return s } -// Container for the parameters to the DescribeConnectionsOnInterconnect operation. type DescribeConnectionsOnInterconnectInput struct { _ struct{} `type:"structure"` - // ID of the interconnect on which a list of connection is provisioned. - // - // Example: dxcon-abc123 - // - // Default: None + // The ID of the interconnect. // // InterconnectId is a required field InterconnectId *string `locationName:"interconnectId" type:"string" required:"true"` @@ -6541,36 +6215,19 @@ func (s *DescribeConnectionsOnInterconnectInput) SetInterconnectId(v string) *De return s } -// Container for the parameters to the DescribeDirectConnectGatewayAssociations -// operation. type DescribeDirectConnectGatewayAssociationsInput struct { _ struct{} `type:"structure"` - // The ID of the direct connect gateway. - // - // Example: "abcd1234-dcba-5678-be23-cdef9876ab45" - // - // Default: None + // The ID of the Direct Connect gateway. DirectConnectGatewayId *string `locationName:"directConnectGatewayId" type:"string"` - // The maximum number of direct connect gateway associations to return per page. - // - // Example: 15 - // - // Default: None + // The maximum number of associations to return per page. MaxResults *int64 `locationName:"maxResults" type:"integer"` - // The token provided in the previous describe result to retrieve the next page - // of the result. - // - // Default: None + // The token provided in the previous call to retrieve the next page. NextToken *string `locationName:"nextToken" type:"string"` // The ID of the virtual private gateway. - // - // Example: "vgw-abc123ef" - // - // Default: None VirtualGatewayId *string `locationName:"virtualGatewayId" type:"string"` } @@ -6608,15 +6265,13 @@ func (s *DescribeDirectConnectGatewayAssociationsInput) SetVirtualGatewayId(v st return s } -// Container for the response from the DescribeDirectConnectGatewayAssociations -// API call type DescribeDirectConnectGatewayAssociationsOutput struct { _ struct{} `type:"structure"` - // Information about the direct connect gateway associations. + // The associations. DirectConnectGatewayAssociations []*GatewayAssociation `locationName:"directConnectGatewayAssociations" type:"list"` - // Token to retrieve the next page of the result. + // The token to retrieve the next page. NextToken *string `locationName:"nextToken" type:"string"` } @@ -6642,36 +6297,19 @@ func (s *DescribeDirectConnectGatewayAssociationsOutput) SetNextToken(v string) return s } -// Container for the parameters to the DescribeDirectConnectGatewayAttachments -// operation. type DescribeDirectConnectGatewayAttachmentsInput struct { _ struct{} `type:"structure"` - // The ID of the direct connect gateway. - // - // Example: "abcd1234-dcba-5678-be23-cdef9876ab45" - // - // Default: None + // The ID of the Direct Connect gateway. DirectConnectGatewayId *string `locationName:"directConnectGatewayId" type:"string"` - // The maximum number of direct connect gateway attachments to return per page. - // - // Example: 15 - // - // Default: None + // The maximum number of attachments to return per page. MaxResults *int64 `locationName:"maxResults" type:"integer"` - // The token provided in the previous describe result to retrieve the next page - // of the result. - // - // Default: None + // The token provided in the previous call to retrieve the next page. NextToken *string `locationName:"nextToken" type:"string"` // The ID of the virtual interface. - // - // Example: "dxvif-abc123ef" - // - // Default: None VirtualInterfaceId *string `locationName:"virtualInterfaceId" type:"string"` } @@ -6709,15 +6347,13 @@ func (s *DescribeDirectConnectGatewayAttachmentsInput) SetVirtualInterfaceId(v s return s } -// Container for the response from the DescribeDirectConnectGatewayAttachments -// API call type DescribeDirectConnectGatewayAttachmentsOutput struct { _ struct{} `type:"structure"` - // Information about the direct connect gateway attachments. + // The attachments. DirectConnectGatewayAttachments []*GatewayAttachment `locationName:"directConnectGatewayAttachments" type:"list"` - // Token to retrieve the next page of the result. + // The token to retrieve the next page. NextToken *string `locationName:"nextToken" type:"string"` } @@ -6743,28 +6379,16 @@ func (s *DescribeDirectConnectGatewayAttachmentsOutput) SetNextToken(v string) * return s } -// Container for the parameters to the DescribeDirectConnectGateways operation. type DescribeDirectConnectGatewaysInput struct { _ struct{} `type:"structure"` - // The ID of the direct connect gateway. - // - // Example: "abcd1234-dcba-5678-be23-cdef9876ab45" - // - // Default: None + // The ID of the Direct Connect gateway. DirectConnectGatewayId *string `locationName:"directConnectGatewayId" type:"string"` - // The maximum number of direct connect gateways to return per page. - // - // Example: 15 - // - // Default: None + // The maximum number of Direct Connect gateways to return per page. MaxResults *int64 `locationName:"maxResults" type:"integer"` - // The token provided in the previous describe result to retrieve the next page - // of the result. - // - // Default: None + // The token provided in the previous call to retrieve the next page. NextToken *string `locationName:"nextToken" type:"string"` } @@ -6796,14 +6420,13 @@ func (s *DescribeDirectConnectGatewaysInput) SetNextToken(v string) *DescribeDir return s } -// Container for the response from the DescribeDirectConnectGateways API call type DescribeDirectConnectGatewaysOutput struct { _ struct{} `type:"structure"` - // Information about the direct connect gateways. + // The Direct Connect gateways. DirectConnectGateways []*Gateway `locationName:"directConnectGateways" type:"list"` - // Token to retrieve the next page of the result. + // The token to retrieve the next page. NextToken *string `locationName:"nextToken" type:"string"` } @@ -6829,15 +6452,10 @@ func (s *DescribeDirectConnectGatewaysOutput) SetNextToken(v string) *DescribeDi return s } -// Container for the parameters to the DescribeHostedConnections operation. type DescribeHostedConnectionsInput struct { _ struct{} `type:"structure"` - // The ID of the interconnect or LAG on which the hosted connections are provisioned. - // - // Example: dxcon-abc123 or dxlag-abc123 - // - // Default: None + // The ID of the interconnect or LAG. // // ConnectionId is a required field ConnectionId *string `locationName:"connectionId" type:"string" required:"true"` @@ -6872,28 +6490,21 @@ func (s *DescribeHostedConnectionsInput) SetConnectionId(v string) *DescribeHost return s } -// Container for the parameters to the DescribeInterconnectLoa operation. type DescribeInterconnectLoaInput struct { _ struct{} `type:"structure"` // The ID of the interconnect. // - // Example: dxcon-abc123 - // // InterconnectId is a required field InterconnectId *string `locationName:"interconnectId" type:"string" required:"true"` - // A standard media type indicating the content type of the LOA-CFA document. - // Currently, the only supported value is "application/pdf". - // - // Default: application/pdf + // The standard media type for the LOA-CFA document. The only supported value + // is application/pdf. LoaContentType *string `locationName:"loaContentType" type:"string" enum:"LoaContentType"` // The name of the service provider who establishes connectivity on your behalf. // If you supply this parameter, the LOA-CFA lists the provider name alongside // your company name as the requester of the cross connect. - // - // Default: None ProviderName *string `locationName:"providerName" type:"string"` } @@ -6938,12 +6549,10 @@ func (s *DescribeInterconnectLoaInput) SetProviderName(v string) *DescribeInterc return s } -// The response received when DescribeInterconnectLoa is called. type DescribeInterconnectLoaOutput struct { _ struct{} `type:"structure"` - // A structure containing the Letter of Authorization - Connecting Facility - // Assignment (LOA-CFA) for a connection. + // The Letter of Authorization - Connecting Facility Assignment (LOA-CFA). Loa *Loa `locationName:"loa" type:"structure"` } @@ -6963,13 +6572,10 @@ func (s *DescribeInterconnectLoaOutput) SetLoa(v *Loa) *DescribeInterconnectLoaO return s } -// Container for the parameters to the DescribeInterconnects operation. type DescribeInterconnectsInput struct { _ struct{} `type:"structure"` // The ID of the interconnect. - // - // Example: dxcon-abc123 InterconnectId *string `locationName:"interconnectId" type:"string"` } @@ -6989,11 +6595,10 @@ func (s *DescribeInterconnectsInput) SetInterconnectId(v string) *DescribeInterc return s } -// A structure containing a list of interconnects. type DescribeInterconnectsOutput struct { _ struct{} `type:"structure"` - // A list of interconnects. + // The interconnects. Interconnects []*Interconnect `locationName:"interconnects" type:"list"` } @@ -7013,15 +6618,10 @@ func (s *DescribeInterconnectsOutput) SetInterconnects(v []*Interconnect) *Descr return s } -// Container for the parameters to the DescribeLags operation. type DescribeLagsInput struct { _ struct{} `type:"structure"` // The ID of the LAG. - // - // Example: dxlag-abc123 - // - // Default: None LagId *string `locationName:"lagId" type:"string"` } @@ -7041,11 +6641,10 @@ func (s *DescribeLagsInput) SetLagId(v string) *DescribeLagsInput { return s } -// A structure containing a list of LAGs. type DescribeLagsOutput struct { _ struct{} `type:"structure"` - // A list of LAGs. + // The LAGs. Lags []*Lag `locationName:"lags" type:"list"` } @@ -7065,31 +6664,21 @@ func (s *DescribeLagsOutput) SetLags(v []*Lag) *DescribeLagsOutput { return s } -// Container for the parameters to the DescribeLoa operation. type DescribeLoaInput struct { _ struct{} `type:"structure"` - // The ID of a connection, LAG, or interconnect for which to get the LOA-CFA - // information. - // - // Example: dxcon-abc123 or dxlag-abc123 - // - // Default: None + // The ID of a connection, LAG, or interconnect. // // ConnectionId is a required field ConnectionId *string `locationName:"connectionId" type:"string" required:"true"` - // A standard media type indicating the content type of the LOA-CFA document. - // Currently, the only supported value is "application/pdf". - // - // Default: application/pdf + // The standard media type for the LOA-CFA document. The only supported value + // is application/pdf. LoaContentType *string `locationName:"loaContentType" type:"string" enum:"LoaContentType"` // The name of the service provider who establishes connectivity on your behalf. - // If you supply this parameter, the LOA-CFA lists the provider name alongside + // If you specify this parameter, the LOA-CFA lists the provider name alongside // your company name as the requester of the cross connect. - // - // Default: None ProviderName *string `locationName:"providerName" type:"string"` } @@ -7148,15 +6737,10 @@ func (s DescribeLocationsInput) GoString() string { return s.String() } -// A location is a network facility where AWS Direct Connect routers are available -// to be connected. Generally, these are colocation hubs where many network -// providers have equipment, and where cross connects can be delivered. Locations -// include a name and facility code, and must be provided when creating a connection. type DescribeLocationsOutput struct { _ struct{} `type:"structure"` - // A list of colocation hubs where network providers have equipment. Most regions - // have multiple locations available. + // The locations. Locations []*Location `locationName:"locations" type:"list"` } @@ -7176,11 +6760,10 @@ func (s *DescribeLocationsOutput) SetLocations(v []*Location) *DescribeLocations return s } -// Container for the parameters to the DescribeTags operation. type DescribeTagsInput struct { _ struct{} `type:"structure"` - // The Amazon Resource Names (ARNs) of the Direct Connect resources. + // The Amazon Resource Names (ARNs) of the resources. // // ResourceArns is a required field ResourceArns []*string `locationName:"resourceArns" type:"list" required:"true"` @@ -7215,7 +6798,6 @@ func (s *DescribeTagsInput) SetResourceArns(v []*string) *DescribeTagsInput { return s } -// The response received when DescribeTags is called. type DescribeTagsOutput struct { _ struct{} `type:"structure"` @@ -7253,11 +6835,10 @@ func (s DescribeVirtualGatewaysInput) GoString() string { return s.String() } -// A structure containing a list of virtual private gateways. type DescribeVirtualGatewaysOutput struct { _ struct{} `type:"structure"` - // A list of virtual private gateways. + // The virtual private gateways. VirtualGateways []*VirtualGateway `locationName:"virtualGateways" type:"list"` } @@ -7277,23 +6858,13 @@ func (s *DescribeVirtualGatewaysOutput) SetVirtualGateways(v []*VirtualGateway) return s } -// Container for the parameters to the DescribeVirtualInterfaces operation. type DescribeVirtualInterfacesInput struct { _ struct{} `type:"structure"` - // The ID of the connection. This field is also used as the ID type for operations - // that use multiple connection types (LAG, interconnect, and/or connection). - // - // Example: dxcon-fg5678gh - // - // Default: None + // The ID of the connection. ConnectionId *string `locationName:"connectionId" type:"string"` // The ID of the virtual interface. - // - // Example: dxvif-123dfg56 - // - // Default: None VirtualInterfaceId *string `locationName:"virtualInterfaceId" type:"string"` } @@ -7319,11 +6890,10 @@ func (s *DescribeVirtualInterfacesInput) SetVirtualInterfaceId(v string) *Descri return s } -// A structure containing a list of virtual interfaces. type DescribeVirtualInterfacesOutput struct { _ struct{} `type:"structure"` - // A list of virtual interfaces. + // The virtual interfaces VirtualInterfaces []*VirtualInterface `locationName:"virtualInterfaces" type:"list"` } @@ -7343,24 +6913,15 @@ func (s *DescribeVirtualInterfacesOutput) SetVirtualInterfaces(v []*VirtualInter return s } -// Container for the parameters to the DisassociateConnectionFromLag operation. type DisassociateConnectionFromLagInput struct { _ struct{} `type:"structure"` - // The ID of the connection to disassociate from the LAG. - // - // Example: dxcon-abc123 - // - // Default: None + // The ID of the connection. For example, dxcon-abc123. // // ConnectionId is a required field ConnectionId *string `locationName:"connectionId" type:"string" required:"true"` - // The ID of the LAG. - // - // Example: dxlag-abc123 - // - // Default: None + // The ID of the LAG. For example, dxlag-abc123. // // LagId is a required field LagId *string `locationName:"lagId" type:"string" required:"true"` @@ -7404,7 +6965,7 @@ func (s *DisassociateConnectionFromLagInput) SetLagId(v string) *DisassociateCon return s } -// A direct connect gateway is an intermediate object that enables you to connect +// Information about a Direct Connect gateway, which enables you to connect // virtual interfaces and virtual private gateways. type Gateway struct { _ struct{} `type:"structure"` @@ -7412,33 +6973,27 @@ type Gateway struct { // The autonomous system number (ASN) for the Amazon side of the connection. AmazonSideAsn *int64 `locationName:"amazonSideAsn" type:"long"` - // The ID of the direct connect gateway. - // - // Example: "abcd1234-dcba-5678-be23-cdef9876ab45" + // The ID of the Direct Connect gateway. DirectConnectGatewayId *string `locationName:"directConnectGatewayId" type:"string"` - // The name of the direct connect gateway. - // - // Example: "My direct connect gateway" - // - // Default: None + // The name of the Direct Connect gateway. DirectConnectGatewayName *string `locationName:"directConnectGatewayName" type:"string"` - // State of the direct connect gateway. + // The state of the Direct Connect gateway. The following are the possible values: // - // * Pending: The initial state after calling CreateDirectConnectGateway. + // * pending: The initial state after calling CreateDirectConnectGateway. // - // * Available: The direct connect gateway is ready for use. + // * available: The Direct Connect gateway is ready for use. // - // * Deleting: The initial state after calling DeleteDirectConnectGateway. + // * deleting: The initial state after calling DeleteDirectConnectGateway. // - // * Deleted: The direct connect gateway is deleted and cannot pass traffic. + // * deleted: The Direct Connect gateway is deleted and cannot pass traffic. DirectConnectGatewayState *string `locationName:"directConnectGatewayState" type:"string" enum:"GatewayState"` - // The AWS account ID of the owner of the direct connect gateway. + // The ID of the AWS account that owns the Direct Connect gateway. OwnerAccount *string `locationName:"ownerAccount" type:"string"` - // Error message when the state of an object fails to advance. + // The error message if the state of an object failed to advance. StateChangeError *string `locationName:"stateChangeError" type:"string"` } @@ -7488,44 +7043,38 @@ func (s *Gateway) SetStateChangeError(v string) *Gateway { return s } -// The association between a direct connect gateway and virtual private gateway. +// Information about an association between a Direct Connect gateway and a virtual +// private gateway. type GatewayAssociation struct { _ struct{} `type:"structure"` - // State of the direct connect gateway association. + // The state of the association. The following are the possible values: // - // * Associating: The initial state after calling CreateDirectConnectGatewayAssociation. + // * associating: The initial state after calling CreateDirectConnectGatewayAssociation. // - // * Associated: The direct connect gateway and virtual private gateway are + // * associated: The Direct Connect gateway and virtual private gateway are // successfully associated and ready to pass traffic. // - // * Disassociating: The initial state after calling DeleteDirectConnectGatewayAssociation. + // * disassociating: The initial state after calling DeleteDirectConnectGatewayAssociation. // - // * Disassociated: The virtual private gateway is successfully disassociated - // from the direct connect gateway. Traffic flow between the direct connect - // gateway and virtual private gateway stops. + // * disassociated: The virtual private gateway is disassociated from the + // Direct Connect gateway. Traffic flow between the Direct Connect gateway + // and virtual private gateway is stopped. AssociationState *string `locationName:"associationState" type:"string" enum:"GatewayAssociationState"` - // The ID of the direct connect gateway. - // - // Example: "abcd1234-dcba-5678-be23-cdef9876ab45" + // The ID of the Direct Connect gateway. DirectConnectGatewayId *string `locationName:"directConnectGatewayId" type:"string"` - // Error message when the state of an object fails to advance. + // The error message if the state of an object failed to advance. StateChangeError *string `locationName:"stateChangeError" type:"string"` - // The ID of the virtual private gateway to a VPC. This only applies to private - // virtual interfaces. - // - // Example: vgw-123er56 + // The ID of the virtual private gateway. Applies only to private virtual interfaces. VirtualGatewayId *string `locationName:"virtualGatewayId" type:"string"` - // The AWS account ID of the owner of the virtual private gateway. + // The ID of the AWS account that owns the virtual private gateway. VirtualGatewayOwnerAccount *string `locationName:"virtualGatewayOwnerAccount" type:"string"` - // The region in which the virtual private gateway is located. - // - // Example: us-east-1 + // The AWS Region where the virtual private gateway is located. VirtualGatewayRegion *string `locationName:"virtualGatewayRegion" type:"string"` } @@ -7575,47 +7124,39 @@ func (s *GatewayAssociation) SetVirtualGatewayRegion(v string) *GatewayAssociati return s } -// The association between a direct connect gateway and virtual interface. +// Information about an attachment between a Direct Connect gateway and a virtual +// interface. type GatewayAttachment struct { _ struct{} `type:"structure"` - // State of the direct connect gateway attachment. + // The state of the attachment. The following are the possible values: // - // * Attaching: The initial state after a virtual interface is created using - // the direct connect gateway. + // * attaching: The initial state after a virtual interface is created using + // the Direct Connect gateway. // - // * Attached: The direct connect gateway and virtual interface are successfully - // attached and ready to pass traffic. + // * attached: The Direct Connect gateway and virtual interface are attached + // and ready to pass traffic. // - // * Detaching: The initial state after calling DeleteVirtualInterface on - // a virtual interface that is attached to a direct connect gateway. + // * detaching: The initial state after calling DeleteVirtualInterface. // - // * Detached: The virtual interface is successfully detached from the direct - // connect gateway. Traffic flow between the direct connect gateway and virtual - // interface stops. + // * detached: The virtual interface is detached from the Direct Connect + // gateway. Traffic flow between the Direct Connect gateway and virtual interface + // is stopped. AttachmentState *string `locationName:"attachmentState" type:"string" enum:"GatewayAttachmentState"` - // The ID of the direct connect gateway. - // - // Example: "abcd1234-dcba-5678-be23-cdef9876ab45" + // The ID of the Direct Connect gateway. DirectConnectGatewayId *string `locationName:"directConnectGatewayId" type:"string"` - // Error message when the state of an object fails to advance. + // The error message if the state of an object failed to advance. StateChangeError *string `locationName:"stateChangeError" type:"string"` // The ID of the virtual interface. - // - // Example: dxvif-123dfg56 - // - // Default: None VirtualInterfaceId *string `locationName:"virtualInterfaceId" type:"string"` - // The AWS account ID of the owner of the virtual interface. + // The ID of the AWS account that owns the virtual interface. VirtualInterfaceOwnerAccount *string `locationName:"virtualInterfaceOwnerAccount" type:"string"` - // The region in which the virtual interface is located. - // - // Example: us-east-1 + // The AWS Region where the virtual interface is located. VirtualInterfaceRegion *string `locationName:"virtualInterfaceRegion" type:"string"` } @@ -7665,84 +7206,56 @@ func (s *GatewayAttachment) SetVirtualInterfaceRegion(v string) *GatewayAttachme return s } -// An interconnect is a connection that can host other connections. -// -// Like a standard AWS Direct Connect connection, an interconnect represents -// the physical connection between an AWS Direct Connect partner's network and -// a specific Direct Connect location. An AWS Direct Connect partner who owns -// an interconnect can provision hosted connections on the interconnect for -// their end customers, thereby providing the end customers with connectivity -// to AWS services. -// -// The resources of the interconnect, including bandwidth and VLAN numbers, -// are shared by all of the hosted connections on the interconnect, and the -// owner of the interconnect determines how these resources are assigned. +// Information about an interconnect. type Interconnect struct { _ struct{} `type:"structure"` - // Deprecated in favor of awsDeviceV2. - // - // The Direct Connection endpoint which the physical connection terminates on. + // The Direct Connect endpoint on which the physical connection terminates. AwsDevice *string `locationName:"awsDevice" deprecated:"true" type:"string"` - // The Direct Connection endpoint which the physical connection terminates on. + // The Direct Connect endpoint on which the physical connection terminates. AwsDeviceV2 *string `locationName:"awsDeviceV2" type:"string"` - // Bandwidth of the connection. - // - // Example: 1Gbps - // - // Default: None + // The bandwidth of the connection. Bandwidth *string `locationName:"bandwidth" type:"string"` // The ID of the interconnect. - // - // Example: dxcon-abc123 InterconnectId *string `locationName:"interconnectId" type:"string"` // The name of the interconnect. - // - // Example: "1G Interconnect to AWS" InterconnectName *string `locationName:"interconnectName" type:"string"` - // State of the interconnect. + // The state of the interconnect. The following are the possible values: // - // * Requested: The initial state of an interconnect. The interconnect stays + // * requested: The initial state of an interconnect. The interconnect stays // in the requested state until the Letter of Authorization (LOA) is sent // to the customer. // - // * Pending: The interconnect has been approved, and is being initialized. + // * pending: The interconnect is approved, and is being initialized. // - // * Available: The network link is up, and the interconnect is ready for + // * available: The network link is up, and the interconnect is ready for // use. // - // * Down: The network link is down. + // * down: The network link is down. // - // * Deleting: The interconnect is in the process of being deleted. + // * deleting: The interconnect is being deleted. // - // * Deleted: The interconnect has been deleted. + // * deleted: The interconnect is deleted. InterconnectState *string `locationName:"interconnectState" type:"string" enum:"InterconnectState"` + // Indicates whether jumbo frames (9001 MTU) are supported. + JumboFrameCapable *bool `locationName:"jumboFrameCapable" type:"boolean"` + // The ID of the LAG. - // - // Example: dxlag-fg5678gh LagId *string `locationName:"lagId" type:"string"` - // The time of the most recent call to DescribeInterconnectLoa for this Interconnect. + // The time of the most recent call to DescribeLoa for this connection. LoaIssueTime *time.Time `locationName:"loaIssueTime" type:"timestamp"` - // Where the connection is located. - // - // Example: EqSV5 - // - // Default: None + // The location of the connection. Location *string `locationName:"location" type:"string"` - // The AWS region where the connection is located. - // - // Example: us-east-1 - // - // Default: None + // The AWS Region where the connection is located. Region *string `locationName:"region" type:"string"` } @@ -7792,6 +7305,12 @@ func (s *Interconnect) SetInterconnectState(v string) *Interconnect { return s } +// SetJumboFrameCapable sets the JumboFrameCapable field's value. +func (s *Interconnect) SetJumboFrameCapable(v bool) *Interconnect { + s.JumboFrameCapable = &v + return s +} + // SetLagId sets the LagId field's value. func (s *Interconnect) SetLagId(v string) *Interconnect { s.LagId = &v @@ -7816,86 +7335,67 @@ func (s *Interconnect) SetRegion(v string) *Interconnect { return s } -// Describes a link aggregation group (LAG). A LAG is a connection that uses -// the Link Aggregation Control Protocol (LACP) to logically aggregate a bundle -// of physical connections. Like an interconnect, it can host other connections. -// All connections in a LAG must terminate on the same physical AWS Direct Connect -// endpoint, and must be the same bandwidth. +// Information about a link aggregation group (LAG). type Lag struct { _ struct{} `type:"structure"` // Indicates whether the LAG can host other connections. - // - // This is intended for use by AWS Direct Connect partners only. AllowsHostedConnections *bool `locationName:"allowsHostedConnections" type:"boolean"` - // Deprecated in favor of awsDeviceV2. - // - // The AWS Direct Connection endpoint that hosts the LAG. + // The Direct Connect endpoint that hosts the LAG. AwsDevice *string `locationName:"awsDevice" deprecated:"true" type:"string"` - // The AWS Direct Connection endpoint that hosts the LAG. + // The Direct Connect endpoint that hosts the LAG. AwsDeviceV2 *string `locationName:"awsDeviceV2" type:"string"` - // A list of connections bundled by this LAG. + // The connections bundled by the LAG. Connections []*Connection `locationName:"connections" type:"list"` // The individual bandwidth of the physical connections bundled by the LAG. - // - // Available values: 1Gbps, 10Gbps + // The possible values are 1Gbps and 10Gbps. ConnectionsBandwidth *string `locationName:"connectionsBandwidth" type:"string"` + // Indicates whether jumbo frames (9001 MTU) are supported. + JumboFrameCapable *bool `locationName:"jumboFrameCapable" type:"boolean"` + // The ID of the LAG. - // - // Example: dxlag-fg5678gh LagId *string `locationName:"lagId" type:"string"` // The name of the LAG. LagName *string `locationName:"lagName" type:"string"` - // The state of the LAG. + // The state of the LAG. The following are the possible values: // - // * Requested: The initial state of a LAG. The LAG stays in the requested + // * requested: The initial state of a LAG. The LAG stays in the requested // state until the Letter of Authorization (LOA) is available. // - // * Pending: The LAG has been approved, and is being initialized. + // * pending: The LAG has been approved and is being initialized. // - // * Available: The network link is established, and the LAG is ready for + // * available: The network link is established and the LAG is ready for // use. // - // * Down: The network link is down. + // * down: The network link is down. // - // * Deleting: The LAG is in the process of being deleted. + // * deleting: The LAG is being deleted. // - // * Deleted: The LAG has been deleted. + // * deleted: The LAG is deleted. LagState *string `locationName:"lagState" type:"string" enum:"LagState"` - // Where the connection is located. - // - // Example: EqSV5 - // - // Default: None + // The location of the LAG. Location *string `locationName:"location" type:"string"` // The minimum number of physical connections that must be operational for the - // LAG itself to be operational. If the number of operational connections drops - // below this setting, the LAG state changes to down. This value can help to - // ensure that a LAG is not overutilized if a significant number of its bundled - // connections go down. + // LAG itself to be operational. MinimumLinks *int64 `locationName:"minimumLinks" type:"integer"` // The number of physical connections bundled by the LAG, up to a maximum of // 10. NumberOfConnections *int64 `locationName:"numberOfConnections" type:"integer"` - // The owner of the LAG. + // The ID of the AWS account that owns the LAG. OwnerAccount *string `locationName:"ownerAccount" type:"string"` - // The AWS region where the connection is located. - // - // Example: us-east-1 - // - // Default: None + // The AWS Region where the connection is located. Region *string `locationName:"region" type:"string"` } @@ -7939,6 +7439,12 @@ func (s *Lag) SetConnectionsBandwidth(v string) *Lag { return s } +// SetJumboFrameCapable sets the JumboFrameCapable field's value. +func (s *Lag) SetJumboFrameCapable(v bool) *Lag { + s.JumboFrameCapable = &v + return s +} + // SetLagId sets the LagId field's value. func (s *Lag) SetLagId(v string) *Lag { s.LagId = &v @@ -7987,8 +7493,8 @@ func (s *Lag) SetRegion(v string) *Lag { return s } -// A structure containing the Letter of Authorization - Connecting Facility -// Assignment (LOA-CFA) for a connection. +// Information about a Letter of Authorization - Connecting Facility Assignment +// (LOA-CFA) for a connection. type Loa struct { _ struct{} `type:"structure"` @@ -7997,10 +7503,8 @@ type Loa struct { // LoaContent is automatically base64 encoded/decoded by the SDK. LoaContent []byte `locationName:"loaContent" type:"blob"` - // A standard media type indicating the content type of the LOA-CFA document. - // Currently, the only supported value is "application/pdf". - // - // Default: application/pdf + // The standard media type for the LOA-CFA document. The only supported value + // is application/pdf. LoaContentType *string `locationName:"loaContentType" type:"string" enum:"LoaContentType"` } @@ -8026,23 +7530,18 @@ func (s *Loa) SetLoaContentType(v string) *Loa { return s } -// An AWS Direct Connect location where connections and interconnects can be -// requested. +// Information about an AWS Direct Connect location. type Location struct { _ struct{} `type:"structure"` - // The code used to indicate the AWS Direct Connect location. + // The code for the location. LocationCode *string `locationName:"locationCode" type:"string"` - // The name of the AWS Direct Connect location. The name includes the colocation - // partner name and the physical site of the lit building. + // The name of the location. This includes the name of the colocation partner + // and the physical site of the building. LocationName *string `locationName:"locationName" type:"string"` - // The AWS region where the AWS Direct connect location is located. - // - // Example: us-east-1 - // - // Default: None + // The AWS Region for the location. Region *string `locationName:"region" type:"string"` } @@ -8074,35 +7573,23 @@ func (s *Location) SetRegion(v string) *Location { return s } -// A structure containing information about a new BGP peer. +// Information about a new BGP peer. type NewBGPPeer struct { _ struct{} `type:"structure"` - // Indicates the address family for the BGP peer. - // - // * ipv4: IPv4 address family - // - // * ipv6: IPv6 address family + // The address family for the BGP peer. AddressFamily *string `locationName:"addressFamily" type:"string" enum:"AddressFamily"` - // IP address assigned to the Amazon interface. - // - // Example: 192.168.1.1/30 or 2001:db8::1/125 + // The IP address assigned to the Amazon interface. AmazonAddress *string `locationName:"amazonAddress" type:"string"` // The autonomous system (AS) number for Border Gateway Protocol (BGP) configuration. - // - // Example: 65000 Asn *int64 `locationName:"asn" type:"integer"` // The authentication key for BGP configuration. - // - // Example: asdf34example AuthKey *string `locationName:"authKey" type:"string"` - // IP address assigned to the customer interface. - // - // Example: 192.168.1.2/30 or 2001:db8::2/125 + // The IP address assigned to the customer interface. CustomerAddress *string `locationName:"customerAddress" type:"string"` } @@ -8146,60 +7633,43 @@ func (s *NewBGPPeer) SetCustomerAddress(v string) *NewBGPPeer { return s } -// A structure containing information about a new private virtual interface. +// Information about a private virtual interface. type NewPrivateVirtualInterface struct { _ struct{} `type:"structure"` - // Indicates the address family for the BGP peer. - // - // * ipv4: IPv4 address family - // - // * ipv6: IPv6 address family + // The address family for the BGP peer. AddressFamily *string `locationName:"addressFamily" type:"string" enum:"AddressFamily"` - // IP address assigned to the Amazon interface. - // - // Example: 192.168.1.1/30 or 2001:db8::1/125 + // The IP address assigned to the Amazon interface. AmazonAddress *string `locationName:"amazonAddress" type:"string"` // The autonomous system (AS) number for Border Gateway Protocol (BGP) configuration. // - // Example: 65000 - // // Asn is a required field Asn *int64 `locationName:"asn" type:"integer" required:"true"` // The authentication key for BGP configuration. - // - // Example: asdf34example AuthKey *string `locationName:"authKey" type:"string"` - // IP address assigned to the customer interface. - // - // Example: 192.168.1.2/30 or 2001:db8::2/125 + // The IP address assigned to the customer interface. CustomerAddress *string `locationName:"customerAddress" type:"string"` - // The ID of the direct connect gateway. - // - // Example: "abcd1234-dcba-5678-be23-cdef9876ab45" + // The ID of the Direct Connect gateway. DirectConnectGatewayId *string `locationName:"directConnectGatewayId" type:"string"` - // The ID of the virtual private gateway to a VPC. This only applies to private - // virtual interfaces. - // - // Example: vgw-123er56 + // The maximum transmission unit (MTU), in bytes. The supported values are 1500 + // and 9001. The default value is 1500. + Mtu *int64 `locationName:"mtu" type:"integer"` + + // The ID of the virtual private gateway. VirtualGatewayId *string `locationName:"virtualGatewayId" type:"string"` - // The name of the virtual interface assigned by the customer. - // - // Example: "My VPC" + // The name of the virtual interface assigned by the customer network. // // VirtualInterfaceName is a required field VirtualInterfaceName *string `locationName:"virtualInterfaceName" type:"string" required:"true"` - // The VLAN ID. - // - // Example: 101 + // The ID of the VLAN. // // Vlan is a required field Vlan *int64 `locationName:"vlan" type:"integer" required:"true"` @@ -8270,6 +7740,12 @@ func (s *NewPrivateVirtualInterface) SetDirectConnectGatewayId(v string) *NewPri return s } +// SetMtu sets the Mtu field's value. +func (s *NewPrivateVirtualInterface) SetMtu(v int64) *NewPrivateVirtualInterface { + s.Mtu = &v + return s +} + // SetVirtualGatewayId sets the VirtualGatewayId field's value. func (s *NewPrivateVirtualInterface) SetVirtualGatewayId(v string) *NewPrivateVirtualInterface { s.VirtualGatewayId = &v @@ -8288,50 +7764,37 @@ func (s *NewPrivateVirtualInterface) SetVlan(v int64) *NewPrivateVirtualInterfac return s } -// A structure containing information about a private virtual interface that -// will be provisioned on a connection. +// Information about a private virtual interface to be provisioned on a connection. type NewPrivateVirtualInterfaceAllocation struct { _ struct{} `type:"structure"` - // Indicates the address family for the BGP peer. - // - // * ipv4: IPv4 address family - // - // * ipv6: IPv6 address family + // The address family for the BGP peer. AddressFamily *string `locationName:"addressFamily" type:"string" enum:"AddressFamily"` - // IP address assigned to the Amazon interface. - // - // Example: 192.168.1.1/30 or 2001:db8::1/125 + // The IP address assigned to the Amazon interface. AmazonAddress *string `locationName:"amazonAddress" type:"string"` // The autonomous system (AS) number for Border Gateway Protocol (BGP) configuration. // - // Example: 65000 - // // Asn is a required field Asn *int64 `locationName:"asn" type:"integer" required:"true"` // The authentication key for BGP configuration. - // - // Example: asdf34example AuthKey *string `locationName:"authKey" type:"string"` - // IP address assigned to the customer interface. - // - // Example: 192.168.1.2/30 or 2001:db8::2/125 + // The IP address assigned to the customer interface. CustomerAddress *string `locationName:"customerAddress" type:"string"` - // The name of the virtual interface assigned by the customer. - // - // Example: "My VPC" + // The maximum transmission unit (MTU), in bytes. The supported values are 1500 + // and 9001. The default value is 1500. + Mtu *int64 `locationName:"mtu" type:"integer"` + + // The name of the virtual interface assigned by the customer network. // // VirtualInterfaceName is a required field VirtualInterfaceName *string `locationName:"virtualInterfaceName" type:"string" required:"true"` - // The VLAN ID. - // - // Example: 101 + // The ID of the VLAN. // // Vlan is a required field Vlan *int64 `locationName:"vlan" type:"integer" required:"true"` @@ -8396,6 +7859,12 @@ func (s *NewPrivateVirtualInterfaceAllocation) SetCustomerAddress(v string) *New return s } +// SetMtu sets the Mtu field's value. +func (s *NewPrivateVirtualInterfaceAllocation) SetMtu(v int64) *NewPrivateVirtualInterfaceAllocation { + s.Mtu = &v + return s +} + // SetVirtualInterfaceName sets the VirtualInterfaceName field's value. func (s *NewPrivateVirtualInterfaceAllocation) SetVirtualInterfaceName(v string) *NewPrivateVirtualInterfaceAllocation { s.VirtualInterfaceName = &v @@ -8408,53 +7877,37 @@ func (s *NewPrivateVirtualInterfaceAllocation) SetVlan(v int64) *NewPrivateVirtu return s } -// A structure containing information about a new public virtual interface. +// Information about a public virtual interface. type NewPublicVirtualInterface struct { _ struct{} `type:"structure"` - // Indicates the address family for the BGP peer. - // - // * ipv4: IPv4 address family - // - // * ipv6: IPv6 address family + // The address family for the BGP peer. AddressFamily *string `locationName:"addressFamily" type:"string" enum:"AddressFamily"` - // IP address assigned to the Amazon interface. - // - // Example: 192.168.1.1/30 or 2001:db8::1/125 + // The IP address assigned to the Amazon interface. AmazonAddress *string `locationName:"amazonAddress" type:"string"` // The autonomous system (AS) number for Border Gateway Protocol (BGP) configuration. // - // Example: 65000 - // // Asn is a required field Asn *int64 `locationName:"asn" type:"integer" required:"true"` // The authentication key for BGP configuration. - // - // Example: asdf34example AuthKey *string `locationName:"authKey" type:"string"` - // IP address assigned to the customer interface. - // - // Example: 192.168.1.2/30 or 2001:db8::2/125 + // The IP address assigned to the customer interface. CustomerAddress *string `locationName:"customerAddress" type:"string"` - // A list of routes to be advertised to the AWS network in this region (public - // virtual interface). + // The routes to be advertised to the AWS network in this Region. Applies to + // public virtual interfaces. RouteFilterPrefixes []*RouteFilterPrefix `locationName:"routeFilterPrefixes" type:"list"` - // The name of the virtual interface assigned by the customer. - // - // Example: "My VPC" + // The name of the virtual interface assigned by the customer network. // // VirtualInterfaceName is a required field VirtualInterfaceName *string `locationName:"virtualInterfaceName" type:"string" required:"true"` - // The VLAN ID. - // - // Example: 101 + // The ID of the VLAN. // // Vlan is a required field Vlan *int64 `locationName:"vlan" type:"integer" required:"true"` @@ -8537,54 +7990,37 @@ func (s *NewPublicVirtualInterface) SetVlan(v int64) *NewPublicVirtualInterface return s } -// A structure containing information about a public virtual interface that -// will be provisioned on a connection. +// Information about a public virtual interface to be provisioned on a connection. type NewPublicVirtualInterfaceAllocation struct { _ struct{} `type:"structure"` - // Indicates the address family for the BGP peer. - // - // * ipv4: IPv4 address family - // - // * ipv6: IPv6 address family + // The address family for the BGP peer. AddressFamily *string `locationName:"addressFamily" type:"string" enum:"AddressFamily"` - // IP address assigned to the Amazon interface. - // - // Example: 192.168.1.1/30 or 2001:db8::1/125 + // The IP address assigned to the Amazon interface. AmazonAddress *string `locationName:"amazonAddress" type:"string"` // The autonomous system (AS) number for Border Gateway Protocol (BGP) configuration. // - // Example: 65000 - // // Asn is a required field Asn *int64 `locationName:"asn" type:"integer" required:"true"` // The authentication key for BGP configuration. - // - // Example: asdf34example AuthKey *string `locationName:"authKey" type:"string"` - // IP address assigned to the customer interface. - // - // Example: 192.168.1.2/30 or 2001:db8::2/125 + // The IP address assigned to the customer interface. CustomerAddress *string `locationName:"customerAddress" type:"string"` - // A list of routes to be advertised to the AWS network in this region (public - // virtual interface). + // The routes to be advertised to the AWS network in this Region. Applies to + // public virtual interfaces. RouteFilterPrefixes []*RouteFilterPrefix `locationName:"routeFilterPrefixes" type:"list"` - // The name of the virtual interface assigned by the customer. - // - // Example: "My VPC" + // The name of the virtual interface assigned by the customer network. // // VirtualInterfaceName is a required field VirtualInterfaceName *string `locationName:"virtualInterfaceName" type:"string" required:"true"` - // The VLAN ID. - // - // Example: 101 + // The ID of the VLAN. // // Vlan is a required field Vlan *int64 `locationName:"vlan" type:"integer" required:"true"` @@ -8667,11 +8103,11 @@ func (s *NewPublicVirtualInterfaceAllocation) SetVlan(v int64) *NewPublicVirtual return s } -// The tags associated with a Direct Connect resource. +// Information about a tag associated with an AWS Direct Connect resource. type ResourceTag struct { _ struct{} `type:"structure"` - // The Amazon Resource Name (ARN) of the Direct Connect resource. + // The Amazon Resource Name (ARN) of the resource. ResourceArn *string `locationName:"resourceArn" type:"string"` // The tags. @@ -8700,17 +8136,13 @@ func (s *ResourceTag) SetTags(v []*Tag) *ResourceTag { return s } -// A route filter prefix that the customer can advertise through Border Gateway -// Protocol (BGP) over a public virtual interface. +// Information about a route filter prefix that a customer can advertise through +// Border Gateway Protocol (BGP) over a public virtual interface. type RouteFilterPrefix struct { _ struct{} `type:"structure"` - // CIDR notation for the advertised route. Multiple routes are separated by - // commas. - // - // IPv6 CIDRs must be at least a /64 or shorter - // - // Example: 10.10.10.0/24,10.10.11.0/24,2001:db8::/64 + // The CIDR block for the advertised route. Separate multiple routes using commas. + // An IPv6 CIDR must use /64 or shorter. Cidr *string `locationName:"cidr" type:"string"` } @@ -8734,12 +8166,12 @@ func (s *RouteFilterPrefix) SetCidr(v string) *RouteFilterPrefix { type Tag struct { _ struct{} `type:"structure"` - // The key of the tag. + // The key. // // Key is a required field Key *string `locationName:"key" min:"1" type:"string" required:"true"` - // The value of the tag. + // The value. Value *string `locationName:"value" type:"string"` } @@ -8781,18 +8213,15 @@ func (s *Tag) SetValue(v string) *Tag { return s } -// Container for the parameters to the TagResource operation. type TagResourceInput struct { _ struct{} `type:"structure"` - // The Amazon Resource Name (ARN) of the Direct Connect resource. - // - // Example: arn:aws:directconnect:us-east-1:123456789012:dxcon/dxcon-fg5678gh + // The Amazon Resource Name (ARN) of the resource. // // ResourceArn is a required field ResourceArn *string `locationName:"resourceArn" type:"string" required:"true"` - // The list of tags to add. + // The tags to add. // // Tags is a required field Tags []*Tag `locationName:"tags" min:"1" type:"list" required:"true"` @@ -8849,7 +8278,6 @@ func (s *TagResourceInput) SetTags(v []*Tag) *TagResourceInput { return s } -// The response received when TagResource is called. type TagResourceOutput struct { _ struct{} `type:"structure"` } @@ -8864,16 +8292,15 @@ func (s TagResourceOutput) GoString() string { return s.String() } -// Container for the parameters to the UntagResource operation. type UntagResourceInput struct { _ struct{} `type:"structure"` - // The Amazon Resource Name (ARN) of the Direct Connect resource. + // The Amazon Resource Name (ARN) of the resource. // // ResourceArn is a required field ResourceArn *string `locationName:"resourceArn" type:"string" required:"true"` - // The list of tag keys to remove. + // The tag keys of the tags to remove. // // TagKeys is a required field TagKeys []*string `locationName:"tagKeys" type:"list" required:"true"` @@ -8917,7 +8344,6 @@ func (s *UntagResourceInput) SetTagKeys(v []*string) *UntagResourceInput { return s } -// The response received when UntagResource is called. type UntagResourceOutput struct { _ struct{} `type:"structure"` } @@ -8932,30 +8358,19 @@ func (s UntagResourceOutput) GoString() string { return s.String() } -// Container for the parameters to the UpdateLag operation. type UpdateLagInput struct { _ struct{} `type:"structure"` - // The ID of the LAG to update. - // - // Example: dxlag-abc123 - // - // Default: None + // The ID of the LAG. // // LagId is a required field LagId *string `locationName:"lagId" type:"string" required:"true"` - // The name for the LAG. - // - // Example: "3x10G LAG to AWS" - // - // Default: None + // The name of the LAG. LagName *string `locationName:"lagName" type:"string"` // The minimum number of physical connections that must be operational for the // LAG itself to be operational. - // - // Default: None MinimumLinks *int64 `locationName:"minimumLinks" type:"integer"` } @@ -9000,30 +8415,323 @@ func (s *UpdateLagInput) SetMinimumLinks(v int64) *UpdateLagInput { return s } -// You can create one or more AWS Direct Connect private virtual interfaces -// linking to your virtual private gateway. -// -// Virtual private gateways can be managed using the Amazon Virtual Private -// Cloud (Amazon VPC) console or the Amazon EC2 CreateVpnGateway action (http://docs.aws.amazon.com/AWSEC2/latest/APIReference/ApiReference-query-CreateVpnGateway.html). -type VirtualGateway struct { +type UpdateVirtualInterfaceAttributesInput struct { _ struct{} `type:"structure"` - // The ID of the virtual private gateway to a VPC. This only applies to private - // virtual interfaces. + // The maximum transmission unit (MTU), in bytes. The supported values are 1500 + // and 9001. The default value is 1500. + Mtu *int64 `locationName:"mtu" type:"integer"` + + // The ID of the virtual private interface. + // + // VirtualInterfaceId is a required field + VirtualInterfaceId *string `locationName:"virtualInterfaceId" type:"string" required:"true"` +} + +// String returns the string representation +func (s UpdateVirtualInterfaceAttributesInput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s UpdateVirtualInterfaceAttributesInput) GoString() string { + return s.String() +} + +// Validate inspects the fields of the type to determine if they are valid. +func (s *UpdateVirtualInterfaceAttributesInput) Validate() error { + invalidParams := request.ErrInvalidParams{Context: "UpdateVirtualInterfaceAttributesInput"} + if s.VirtualInterfaceId == nil { + invalidParams.Add(request.NewErrParamRequired("VirtualInterfaceId")) + } + + if invalidParams.Len() > 0 { + return invalidParams + } + return nil +} + +// SetMtu sets the Mtu field's value. +func (s *UpdateVirtualInterfaceAttributesInput) SetMtu(v int64) *UpdateVirtualInterfaceAttributesInput { + s.Mtu = &v + return s +} + +// SetVirtualInterfaceId sets the VirtualInterfaceId field's value. +func (s *UpdateVirtualInterfaceAttributesInput) SetVirtualInterfaceId(v string) *UpdateVirtualInterfaceAttributesInput { + s.VirtualInterfaceId = &v + return s +} + +// Information about a virtual interface. +type UpdateVirtualInterfaceAttributesOutput struct { + _ struct{} `type:"structure"` + + // The address family for the BGP peer. + AddressFamily *string `locationName:"addressFamily" type:"string" enum:"AddressFamily"` + + // The IP address assigned to the Amazon interface. + AmazonAddress *string `locationName:"amazonAddress" type:"string"` + + // The autonomous system number (ASN) for the Amazon side of the connection. + AmazonSideAsn *int64 `locationName:"amazonSideAsn" type:"long"` + + // The autonomous system (AS) number for Border Gateway Protocol (BGP) configuration. + Asn *int64 `locationName:"asn" type:"integer"` + + // The authentication key for BGP configuration. + AuthKey *string `locationName:"authKey" type:"string"` + + // The Direct Connect endpoint on which the virtual interface terminates. + AwsDeviceV2 *string `locationName:"awsDeviceV2" type:"string"` + + // The BGP peers configured on this virtual interface. + BgpPeers []*BGPPeer `locationName:"bgpPeers" type:"list"` + + // The ID of the connection. + ConnectionId *string `locationName:"connectionId" type:"string"` + + // The IP address assigned to the customer interface. + CustomerAddress *string `locationName:"customerAddress" type:"string"` + + // The customer router configuration. + CustomerRouterConfig *string `locationName:"customerRouterConfig" type:"string"` + + // The ID of the Direct Connect gateway. + DirectConnectGatewayId *string `locationName:"directConnectGatewayId" type:"string"` + + // Indicates whether jumbo frames (9001 MTU) are supported. + JumboFrameCapable *bool `locationName:"jumboFrameCapable" type:"boolean"` + + // The location of the connection. + Location *string `locationName:"location" type:"string"` + + // The maximum transmission unit (MTU), in bytes. The supported values are 1500 + // and 9001. The default value is 1500. + Mtu *int64 `locationName:"mtu" type:"integer"` + + // The ID of the AWS account that owns the virtual interface. + OwnerAccount *string `locationName:"ownerAccount" type:"string"` + + // The AWS Region where the virtual interface is located. + Region *string `locationName:"region" type:"string"` + + // The routes to be advertised to the AWS network in this Region. Applies to + // public virtual interfaces. + RouteFilterPrefixes []*RouteFilterPrefix `locationName:"routeFilterPrefixes" type:"list"` + + // The ID of the virtual private gateway. Applies only to private virtual interfaces. + VirtualGatewayId *string `locationName:"virtualGatewayId" type:"string"` + + // The ID of the virtual interface. + VirtualInterfaceId *string `locationName:"virtualInterfaceId" type:"string"` + + // The name of the virtual interface assigned by the customer network. + VirtualInterfaceName *string `locationName:"virtualInterfaceName" type:"string"` + + // The state of the virtual interface. The following are the possible values: + // + // * confirming: The creation of the virtual interface is pending confirmation + // from the virtual interface owner. If the owner of the virtual interface + // is different from the owner of the connection on which it is provisioned, + // then the virtual interface will remain in this state until it is confirmed + // by the virtual interface owner. + // + // * verifying: This state only applies to public virtual interfaces. Each + // public virtual interface needs validation before the virtual interface + // can be created. + // + // * pending: A virtual interface is in this state from the time that it + // is created until the virtual interface is ready to forward traffic. + // + // * available: A virtual interface that is able to forward traffic. + // + // * down: A virtual interface that is BGP down. + // + // * deleting: A virtual interface is in this state immediately after calling + // DeleteVirtualInterface until it can no longer forward traffic. // - // Example: vgw-123er56 + // * deleted: A virtual interface that cannot forward traffic. + // + // * rejected: The virtual interface owner has declined creation of the virtual + // interface. If a virtual interface in the Confirming state is deleted by + // the virtual interface owner, the virtual interface enters the Rejected + // state. + VirtualInterfaceState *string `locationName:"virtualInterfaceState" type:"string" enum:"VirtualInterfaceState"` + + // The type of virtual interface. The possible values are private and public. + VirtualInterfaceType *string `locationName:"virtualInterfaceType" type:"string"` + + // The ID of the VLAN. + Vlan *int64 `locationName:"vlan" type:"integer"` +} + +// String returns the string representation +func (s UpdateVirtualInterfaceAttributesOutput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s UpdateVirtualInterfaceAttributesOutput) GoString() string { + return s.String() +} + +// SetAddressFamily sets the AddressFamily field's value. +func (s *UpdateVirtualInterfaceAttributesOutput) SetAddressFamily(v string) *UpdateVirtualInterfaceAttributesOutput { + s.AddressFamily = &v + return s +} + +// SetAmazonAddress sets the AmazonAddress field's value. +func (s *UpdateVirtualInterfaceAttributesOutput) SetAmazonAddress(v string) *UpdateVirtualInterfaceAttributesOutput { + s.AmazonAddress = &v + return s +} + +// SetAmazonSideAsn sets the AmazonSideAsn field's value. +func (s *UpdateVirtualInterfaceAttributesOutput) SetAmazonSideAsn(v int64) *UpdateVirtualInterfaceAttributesOutput { + s.AmazonSideAsn = &v + return s +} + +// SetAsn sets the Asn field's value. +func (s *UpdateVirtualInterfaceAttributesOutput) SetAsn(v int64) *UpdateVirtualInterfaceAttributesOutput { + s.Asn = &v + return s +} + +// SetAuthKey sets the AuthKey field's value. +func (s *UpdateVirtualInterfaceAttributesOutput) SetAuthKey(v string) *UpdateVirtualInterfaceAttributesOutput { + s.AuthKey = &v + return s +} + +// SetAwsDeviceV2 sets the AwsDeviceV2 field's value. +func (s *UpdateVirtualInterfaceAttributesOutput) SetAwsDeviceV2(v string) *UpdateVirtualInterfaceAttributesOutput { + s.AwsDeviceV2 = &v + return s +} + +// SetBgpPeers sets the BgpPeers field's value. +func (s *UpdateVirtualInterfaceAttributesOutput) SetBgpPeers(v []*BGPPeer) *UpdateVirtualInterfaceAttributesOutput { + s.BgpPeers = v + return s +} + +// SetConnectionId sets the ConnectionId field's value. +func (s *UpdateVirtualInterfaceAttributesOutput) SetConnectionId(v string) *UpdateVirtualInterfaceAttributesOutput { + s.ConnectionId = &v + return s +} + +// SetCustomerAddress sets the CustomerAddress field's value. +func (s *UpdateVirtualInterfaceAttributesOutput) SetCustomerAddress(v string) *UpdateVirtualInterfaceAttributesOutput { + s.CustomerAddress = &v + return s +} + +// SetCustomerRouterConfig sets the CustomerRouterConfig field's value. +func (s *UpdateVirtualInterfaceAttributesOutput) SetCustomerRouterConfig(v string) *UpdateVirtualInterfaceAttributesOutput { + s.CustomerRouterConfig = &v + return s +} + +// SetDirectConnectGatewayId sets the DirectConnectGatewayId field's value. +func (s *UpdateVirtualInterfaceAttributesOutput) SetDirectConnectGatewayId(v string) *UpdateVirtualInterfaceAttributesOutput { + s.DirectConnectGatewayId = &v + return s +} + +// SetJumboFrameCapable sets the JumboFrameCapable field's value. +func (s *UpdateVirtualInterfaceAttributesOutput) SetJumboFrameCapable(v bool) *UpdateVirtualInterfaceAttributesOutput { + s.JumboFrameCapable = &v + return s +} + +// SetLocation sets the Location field's value. +func (s *UpdateVirtualInterfaceAttributesOutput) SetLocation(v string) *UpdateVirtualInterfaceAttributesOutput { + s.Location = &v + return s +} + +// SetMtu sets the Mtu field's value. +func (s *UpdateVirtualInterfaceAttributesOutput) SetMtu(v int64) *UpdateVirtualInterfaceAttributesOutput { + s.Mtu = &v + return s +} + +// SetOwnerAccount sets the OwnerAccount field's value. +func (s *UpdateVirtualInterfaceAttributesOutput) SetOwnerAccount(v string) *UpdateVirtualInterfaceAttributesOutput { + s.OwnerAccount = &v + return s +} + +// SetRegion sets the Region field's value. +func (s *UpdateVirtualInterfaceAttributesOutput) SetRegion(v string) *UpdateVirtualInterfaceAttributesOutput { + s.Region = &v + return s +} + +// SetRouteFilterPrefixes sets the RouteFilterPrefixes field's value. +func (s *UpdateVirtualInterfaceAttributesOutput) SetRouteFilterPrefixes(v []*RouteFilterPrefix) *UpdateVirtualInterfaceAttributesOutput { + s.RouteFilterPrefixes = v + return s +} + +// SetVirtualGatewayId sets the VirtualGatewayId field's value. +func (s *UpdateVirtualInterfaceAttributesOutput) SetVirtualGatewayId(v string) *UpdateVirtualInterfaceAttributesOutput { + s.VirtualGatewayId = &v + return s +} + +// SetVirtualInterfaceId sets the VirtualInterfaceId field's value. +func (s *UpdateVirtualInterfaceAttributesOutput) SetVirtualInterfaceId(v string) *UpdateVirtualInterfaceAttributesOutput { + s.VirtualInterfaceId = &v + return s +} + +// SetVirtualInterfaceName sets the VirtualInterfaceName field's value. +func (s *UpdateVirtualInterfaceAttributesOutput) SetVirtualInterfaceName(v string) *UpdateVirtualInterfaceAttributesOutput { + s.VirtualInterfaceName = &v + return s +} + +// SetVirtualInterfaceState sets the VirtualInterfaceState field's value. +func (s *UpdateVirtualInterfaceAttributesOutput) SetVirtualInterfaceState(v string) *UpdateVirtualInterfaceAttributesOutput { + s.VirtualInterfaceState = &v + return s +} + +// SetVirtualInterfaceType sets the VirtualInterfaceType field's value. +func (s *UpdateVirtualInterfaceAttributesOutput) SetVirtualInterfaceType(v string) *UpdateVirtualInterfaceAttributesOutput { + s.VirtualInterfaceType = &v + return s +} + +// SetVlan sets the Vlan field's value. +func (s *UpdateVirtualInterfaceAttributesOutput) SetVlan(v int64) *UpdateVirtualInterfaceAttributesOutput { + s.Vlan = &v + return s +} + +// Information about a virtual private gateway for a private virtual interface. +type VirtualGateway struct { + _ struct{} `type:"structure"` + + // The ID of the virtual private gateway. VirtualGatewayId *string `locationName:"virtualGatewayId" type:"string"` - // State of the virtual private gateway. + // The state of the virtual private gateway. The following are the possible + // values: // - // * Pending: This is the initial state after calling CreateVpnGateway. + // * pending: Initial state after creating the virtual private gateway. // - // * Available: Ready for use by a private virtual interface. + // * available: Ready for use by a private virtual interface. // - // * Deleting: This is the initial state after calling DeleteVpnGateway. + // * deleting: Initial state after deleting the virtual private gateway. // - // * Deleted: In this state, a private virtual interface is unable to send - // traffic over this gateway. + // * deleted: The virtual private gateway is deleted. The private virtual + // interface is unable to send traffic over this gateway. VirtualGatewayState *string `locationName:"virtualGatewayState" type:"string"` } @@ -9049,141 +8757,106 @@ func (s *VirtualGateway) SetVirtualGatewayState(v string) *VirtualGateway { return s } -// A virtual interface (VLAN) transmits the traffic between the AWS Direct Connect -// location and the customer. +// Information about a virtual interface. type VirtualInterface struct { _ struct{} `type:"structure"` - // Indicates the address family for the BGP peer. - // - // * ipv4: IPv4 address family - // - // * ipv6: IPv6 address family + // The address family for the BGP peer. AddressFamily *string `locationName:"addressFamily" type:"string" enum:"AddressFamily"` - // IP address assigned to the Amazon interface. - // - // Example: 192.168.1.1/30 or 2001:db8::1/125 + // The IP address assigned to the Amazon interface. AmazonAddress *string `locationName:"amazonAddress" type:"string"` // The autonomous system number (ASN) for the Amazon side of the connection. AmazonSideAsn *int64 `locationName:"amazonSideAsn" type:"long"` // The autonomous system (AS) number for Border Gateway Protocol (BGP) configuration. - // - // Example: 65000 Asn *int64 `locationName:"asn" type:"integer"` // The authentication key for BGP configuration. - // - // Example: asdf34example AuthKey *string `locationName:"authKey" type:"string"` - // The Direct Connection endpoint which the virtual interface terminates on. + // The Direct Connect endpoint on which the virtual interface terminates. AwsDeviceV2 *string `locationName:"awsDeviceV2" type:"string"` - // A list of the BGP peers configured on this virtual interface. + // The BGP peers configured on this virtual interface. BgpPeers []*BGPPeer `locationName:"bgpPeers" type:"list"` - // The ID of the connection. This field is also used as the ID type for operations - // that use multiple connection types (LAG, interconnect, and/or connection). - // - // Example: dxcon-fg5678gh - // - // Default: None + // The ID of the connection. ConnectionId *string `locationName:"connectionId" type:"string"` - // IP address assigned to the customer interface. - // - // Example: 192.168.1.2/30 or 2001:db8::2/125 + // The IP address assigned to the customer interface. CustomerAddress *string `locationName:"customerAddress" type:"string"` - // Information for generating the customer router configuration. + // The customer router configuration. CustomerRouterConfig *string `locationName:"customerRouterConfig" type:"string"` - // The ID of the direct connect gateway. - // - // Example: "abcd1234-dcba-5678-be23-cdef9876ab45" + // The ID of the Direct Connect gateway. DirectConnectGatewayId *string `locationName:"directConnectGatewayId" type:"string"` - // Where the connection is located. - // - // Example: EqSV5 - // - // Default: None + // Indicates whether jumbo frames (9001 MTU) are supported. + JumboFrameCapable *bool `locationName:"jumboFrameCapable" type:"boolean"` + + // The location of the connection. Location *string `locationName:"location" type:"string"` - // The AWS account that will own the new virtual interface. + // The maximum transmission unit (MTU), in bytes. The supported values are 1500 + // and 9001. The default value is 1500. + Mtu *int64 `locationName:"mtu" type:"integer"` + + // The ID of the AWS account that owns the virtual interface. OwnerAccount *string `locationName:"ownerAccount" type:"string"` - // The AWS region where the virtual interface is located. - // - // Example: us-east-1 - // - // Default: None + // The AWS Region where the virtual interface is located. Region *string `locationName:"region" type:"string"` - // A list of routes to be advertised to the AWS network in this region (public - // virtual interface). + // The routes to be advertised to the AWS network in this Region. Applies to + // public virtual interfaces. RouteFilterPrefixes []*RouteFilterPrefix `locationName:"routeFilterPrefixes" type:"list"` - // The ID of the virtual private gateway to a VPC. This only applies to private - // virtual interfaces. - // - // Example: vgw-123er56 + // The ID of the virtual private gateway. Applies only to private virtual interfaces. VirtualGatewayId *string `locationName:"virtualGatewayId" type:"string"` // The ID of the virtual interface. - // - // Example: dxvif-123dfg56 - // - // Default: None VirtualInterfaceId *string `locationName:"virtualInterfaceId" type:"string"` - // The name of the virtual interface assigned by the customer. - // - // Example: "My VPC" + // The name of the virtual interface assigned by the customer network. VirtualInterfaceName *string `locationName:"virtualInterfaceName" type:"string"` - // State of the virtual interface. + // The state of the virtual interface. The following are the possible values: // - // * Confirming: The creation of the virtual interface is pending confirmation + // * confirming: The creation of the virtual interface is pending confirmation // from the virtual interface owner. If the owner of the virtual interface // is different from the owner of the connection on which it is provisioned, // then the virtual interface will remain in this state until it is confirmed // by the virtual interface owner. // - // * Verifying: This state only applies to public virtual interfaces. Each + // * verifying: This state only applies to public virtual interfaces. Each // public virtual interface needs validation before the virtual interface // can be created. // - // * Pending: A virtual interface is in this state from the time that it + // * pending: A virtual interface is in this state from the time that it // is created until the virtual interface is ready to forward traffic. // - // * Available: A virtual interface that is able to forward traffic. + // * available: A virtual interface that is able to forward traffic. // - // * Down: A virtual interface that is BGP down. + // * down: A virtual interface that is BGP down. // - // * Deleting: A virtual interface is in this state immediately after calling + // * deleting: A virtual interface is in this state immediately after calling // DeleteVirtualInterface until it can no longer forward traffic. // - // * Deleted: A virtual interface that cannot forward traffic. + // * deleted: A virtual interface that cannot forward traffic. // - // * Rejected: The virtual interface owner has declined creation of the virtual - // interface. If a virtual interface in the 'Confirming' state is deleted - // by the virtual interface owner, the virtual interface will enter the 'Rejected' + // * rejected: The virtual interface owner has declined creation of the virtual + // interface. If a virtual interface in the Confirming state is deleted by + // the virtual interface owner, the virtual interface enters the Rejected // state. VirtualInterfaceState *string `locationName:"virtualInterfaceState" type:"string" enum:"VirtualInterfaceState"` - // The type of virtual interface. - // - // Example: private (Amazon VPC) or public (Amazon S3, Amazon DynamoDB, and - // so on.) + // The type of virtual interface. The possible values are private and public. VirtualInterfaceType *string `locationName:"virtualInterfaceType" type:"string"` - // The VLAN ID. - // - // Example: 101 + // The ID of the VLAN. Vlan *int64 `locationName:"vlan" type:"integer"` } @@ -9263,12 +8936,24 @@ func (s *VirtualInterface) SetDirectConnectGatewayId(v string) *VirtualInterface return s } +// SetJumboFrameCapable sets the JumboFrameCapable field's value. +func (s *VirtualInterface) SetJumboFrameCapable(v bool) *VirtualInterface { + s.JumboFrameCapable = &v + return s +} + // SetLocation sets the Location field's value. func (s *VirtualInterface) SetLocation(v string) *VirtualInterface { s.Location = &v return s } +// SetMtu sets the Mtu field's value. +func (s *VirtualInterface) SetMtu(v int64) *VirtualInterface { + s.Mtu = &v + return s +} + // SetOwnerAccount sets the OwnerAccount field's value. func (s *VirtualInterface) SetOwnerAccount(v string) *VirtualInterface { s.OwnerAccount = &v @@ -9323,11 +9008,6 @@ func (s *VirtualInterface) SetVlan(v int64) *VirtualInterface { return s } -// Indicates the address family for the BGP peer. -// -// * ipv4: IPv4 address family -// -// * ipv6: IPv6 address family const ( // AddressFamilyIpv4 is a AddressFamily enum value AddressFamilyIpv4 = "ipv4" @@ -9336,20 +9016,6 @@ const ( AddressFamilyIpv6 = "ipv6" ) -// The state of the BGP peer. -// -// * Verifying: The BGP peering addresses or ASN require validation before -// the BGP peer can be created. This state only applies to BGP peers on a -// public virtual interface. -// -// * Pending: The BGP peer has been created, and is in this state until it -// is ready to be established. -// -// * Available: The BGP peer can be established. -// -// * Deleting: The BGP peer is in the process of being deleted. -// -// * Deleted: The BGP peer has been deleted and cannot be established. const ( // BGPPeerStateVerifying is a BGPPeerState enum value BGPPeerStateVerifying = "verifying" @@ -9367,14 +9033,6 @@ const ( BGPPeerStateDeleted = "deleted" ) -// The Up/Down state of the BGP peer. -// -// * Up: The BGP peer is established. -// -// A state of up does not indicate the state of the routing function. Ensure -// that you are receiving routes over the BGP session. -// -// * Down: The BGP peer is down. const ( // BGPStatusUp is a BGPStatus enum value BGPStatusUp = "up" @@ -9383,28 +9041,6 @@ const ( BGPStatusDown = "down" ) -// State of the connection. -// -// * Ordering: The initial state of a hosted connection provisioned on an -// interconnect. The connection stays in the ordering state until the owner -// of the hosted connection confirms or declines the connection order. -// -// * Requested: The initial state of a standard connection. The connection -// stays in the requested state until the Letter of Authorization (LOA) is -// sent to the customer. -// -// * Pending: The connection has been approved, and is being initialized. -// -// * Available: The network link is up, and the connection is ready for use. -// -// * Down: The network link is down. -// -// * Deleting: The connection is in the process of being deleted. -// -// * Deleted: The connection has been deleted. -// -// * Rejected: A hosted connection in the 'Ordering' state will enter the -// 'Rejected' state if it is deleted by the end customer. const ( // ConnectionStateOrdering is a ConnectionState enum value ConnectionStateOrdering = "ordering" @@ -9431,18 +9067,6 @@ const ( ConnectionStateRejected = "rejected" ) -// State of the direct connect gateway association. -// -// * Associating: The initial state after calling CreateDirectConnectGatewayAssociation. -// -// * Associated: The direct connect gateway and virtual private gateway are -// successfully associated and ready to pass traffic. -// -// * Disassociating: The initial state after calling DeleteDirectConnectGatewayAssociation. -// -// * Disassociated: The virtual private gateway is successfully disassociated -// from the direct connect gateway. Traffic flow between the direct connect -// gateway and virtual private gateway stops. const ( // GatewayAssociationStateAssociating is a GatewayAssociationState enum value GatewayAssociationStateAssociating = "associating" @@ -9457,20 +9081,6 @@ const ( GatewayAssociationStateDisassociated = "disassociated" ) -// State of the direct connect gateway attachment. -// -// * Attaching: The initial state after a virtual interface is created using -// the direct connect gateway. -// -// * Attached: The direct connect gateway and virtual interface are successfully -// attached and ready to pass traffic. -// -// * Detaching: The initial state after calling DeleteVirtualInterface on -// a virtual interface that is attached to a direct connect gateway. -// -// * Detached: The virtual interface is successfully detached from the direct -// connect gateway. Traffic flow between the direct connect gateway and virtual -// interface stops. const ( // GatewayAttachmentStateAttaching is a GatewayAttachmentState enum value GatewayAttachmentStateAttaching = "attaching" @@ -9485,15 +9095,6 @@ const ( GatewayAttachmentStateDetached = "detached" ) -// State of the direct connect gateway. -// -// * Pending: The initial state after calling CreateDirectConnectGateway. -// -// * Available: The direct connect gateway is ready for use. -// -// * Deleting: The initial state after calling DeleteDirectConnectGateway. -// -// * Deleted: The direct connect gateway is deleted and cannot pass traffic. const ( // GatewayStatePending is a GatewayState enum value GatewayStatePending = "pending" @@ -9508,22 +9109,6 @@ const ( GatewayStateDeleted = "deleted" ) -// State of the interconnect. -// -// * Requested: The initial state of an interconnect. The interconnect stays -// in the requested state until the Letter of Authorization (LOA) is sent -// to the customer. -// -// * Pending: The interconnect has been approved, and is being initialized. -// -// * Available: The network link is up, and the interconnect is ready for -// use. -// -// * Down: The network link is down. -// -// * Deleting: The interconnect is in the process of being deleted. -// -// * Deleted: The interconnect has been deleted. const ( // InterconnectStateRequested is a InterconnectState enum value InterconnectStateRequested = "requested" @@ -9544,21 +9129,6 @@ const ( InterconnectStateDeleted = "deleted" ) -// The state of the LAG. -// -// * Requested: The initial state of a LAG. The LAG stays in the requested -// state until the Letter of Authorization (LOA) is available. -// -// * Pending: The LAG has been approved, and is being initialized. -// -// * Available: The network link is established, and the LAG is ready for -// use. -// -// * Down: The network link is down. -// -// * Deleting: The LAG is in the process of being deleted. -// -// * Deleted: The LAG has been deleted. const ( // LagStateRequested is a LagState enum value LagStateRequested = "requested" @@ -9579,43 +9149,11 @@ const ( LagStateDeleted = "deleted" ) -// A standard media type indicating the content type of the LOA-CFA document. -// Currently, the only supported value is "application/pdf". -// -// Default: application/pdf const ( // LoaContentTypeApplicationPdf is a LoaContentType enum value LoaContentTypeApplicationPdf = "application/pdf" ) -// State of the virtual interface. -// -// * Confirming: The creation of the virtual interface is pending confirmation -// from the virtual interface owner. If the owner of the virtual interface -// is different from the owner of the connection on which it is provisioned, -// then the virtual interface will remain in this state until it is confirmed -// by the virtual interface owner. -// -// * Verifying: This state only applies to public virtual interfaces. Each -// public virtual interface needs validation before the virtual interface -// can be created. -// -// * Pending: A virtual interface is in this state from the time that it -// is created until the virtual interface is ready to forward traffic. -// -// * Available: A virtual interface that is able to forward traffic. -// -// * Down: A virtual interface that is BGP down. -// -// * Deleting: A virtual interface is in this state immediately after calling -// DeleteVirtualInterface until it can no longer forward traffic. -// -// * Deleted: A virtual interface that cannot forward traffic. -// -// * Rejected: The virtual interface owner has declined creation of the virtual -// interface. If a virtual interface in the 'Confirming' state is deleted -// by the virtual interface owner, the virtual interface will enter the 'Rejected' -// state. const ( // VirtualInterfaceStateConfirming is a VirtualInterfaceState enum value VirtualInterfaceStateConfirming = "confirming" diff --git a/service/directconnect/directconnectiface/interface.go b/service/directconnect/directconnectiface/interface.go index b4b44281901..9f4429fa6c2 100644 --- a/service/directconnect/directconnectiface/interface.go +++ b/service/directconnect/directconnectiface/interface.go @@ -235,6 +235,10 @@ type DirectConnectAPI interface { UpdateLag(*directconnect.UpdateLagInput) (*directconnect.Lag, error) UpdateLagWithContext(aws.Context, *directconnect.UpdateLagInput, ...request.Option) (*directconnect.Lag, error) UpdateLagRequest(*directconnect.UpdateLagInput) (*request.Request, *directconnect.Lag) + + UpdateVirtualInterfaceAttributes(*directconnect.UpdateVirtualInterfaceAttributesInput) (*directconnect.UpdateVirtualInterfaceAttributesOutput, error) + UpdateVirtualInterfaceAttributesWithContext(aws.Context, *directconnect.UpdateVirtualInterfaceAttributesInput, ...request.Option) (*directconnect.UpdateVirtualInterfaceAttributesOutput, error) + UpdateVirtualInterfaceAttributesRequest(*directconnect.UpdateVirtualInterfaceAttributesInput) (*request.Request, *directconnect.UpdateVirtualInterfaceAttributesOutput) } var _ DirectConnectAPI = (*directconnect.DirectConnect)(nil) diff --git a/service/directconnect/doc.go b/service/directconnect/doc.go index 277fbe626ff..de61cdbfa78 100644 --- a/service/directconnect/doc.go +++ b/service/directconnect/doc.go @@ -4,17 +4,14 @@ // 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). +// over a standard 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 EC2 and Amazon S3) and to Amazon VPC, bypassing Internet +// service providers in your network path. A connection provides access to all +// AWS Regions except the China (Beijing) and (China) Ningxia Regions. AWS resources +// in the China Regions can only be accessed through locations associated with +// those Regions. // // See https://docs.aws.amazon.com/goto/WebAPI/directconnect-2012-10-25 for more information on this service. // diff --git a/service/directconnect/errors.go b/service/directconnect/errors.go index 454cfe5ae58..9d6f810311e 100644 --- a/service/directconnect/errors.go +++ b/service/directconnect/errors.go @@ -7,8 +7,7 @@ const ( // ErrCodeClientException for service response error code // "DirectConnectClientException". // - // The API was called with invalid parameters. The error message will contain - // additional details about the cause. + // One or more parameters are not valid. ErrCodeClientException = "DirectConnectClientException" // ErrCodeDuplicateTagKeysException for service response error code @@ -20,14 +19,12 @@ const ( // ErrCodeServerException for service response error code // "DirectConnectServerException". // - // A server-side error occurred during the API call. The error message will - // contain additional details about the cause. + // A server-side error occurred. ErrCodeServerException = "DirectConnectServerException" // ErrCodeTooManyTagsException for service response error code // "TooManyTagsException". // - // You have reached the limit on the number of tags that can be assigned to - // a Direct Connect resource. + // You have reached the limit on the number of tags that can be assigned. ErrCodeTooManyTagsException = "TooManyTagsException" ) diff --git a/service/ec2/api.go b/service/ec2/api.go index 6d21aada3b4..bc96eea579a 100644 --- a/service/ec2/api.go +++ b/service/ec2/api.go @@ -71054,6 +71054,9 @@ const ( // InstanceTypeG316xlarge is a InstanceType enum value InstanceTypeG316xlarge = "g3.16xlarge" + // InstanceTypeG3sXlarge is a InstanceType enum value + InstanceTypeG3sXlarge = "g3s.xlarge" + // InstanceTypeCg14xlarge is a InstanceType enum value InstanceTypeCg14xlarge = "cg1.4xlarge" diff --git a/service/elasticsearchservice/api.go b/service/elasticsearchservice/api.go index aab3400a93a..c4915fbd8be 100644 --- a/service/elasticsearchservice/api.go +++ b/service/elasticsearchservice/api.go @@ -106,6 +106,97 @@ func (c *ElasticsearchService) AddTagsWithContext(ctx aws.Context, input *AddTag return out, req.Send() } +const opCancelElasticsearchServiceSoftwareUpdate = "CancelElasticsearchServiceSoftwareUpdate" + +// CancelElasticsearchServiceSoftwareUpdateRequest generates a "aws/request.Request" representing the +// client's request for the CancelElasticsearchServiceSoftwareUpdate operation. The "output" return +// value will be populated with the request's response once the request completes +// successfully. +// +// Use "Send" method on the returned Request to send the API call to the service. +// the "output" return value is not valid until after Send returns without error. +// +// See CancelElasticsearchServiceSoftwareUpdate for more information on using the CancelElasticsearchServiceSoftwareUpdate +// API call, and error handling. +// +// This method is useful when you want to inject custom logic or configuration +// into the SDK's request lifecycle. Such as custom headers, or retry logic. +// +// +// // Example sending a request using the CancelElasticsearchServiceSoftwareUpdateRequest method. +// req, resp := client.CancelElasticsearchServiceSoftwareUpdateRequest(params) +// +// err := req.Send() +// if err == nil { // resp is now filled +// fmt.Println(resp) +// } +func (c *ElasticsearchService) CancelElasticsearchServiceSoftwareUpdateRequest(input *CancelElasticsearchServiceSoftwareUpdateInput) (req *request.Request, output *CancelElasticsearchServiceSoftwareUpdateOutput) { + op := &request.Operation{ + Name: opCancelElasticsearchServiceSoftwareUpdate, + HTTPMethod: "POST", + HTTPPath: "/2015-01-01/es/serviceSoftwareUpdate/cancel", + } + + if input == nil { + input = &CancelElasticsearchServiceSoftwareUpdateInput{} + } + + output = &CancelElasticsearchServiceSoftwareUpdateOutput{} + req = c.newRequest(op, input, output) + return +} + +// CancelElasticsearchServiceSoftwareUpdate API operation for Amazon Elasticsearch Service. +// +// Cancels a scheduled service software update for an Amazon ES domain. You +// can only perform this operation before the AutomatedUpdateDate and when the +// UpdateStatus is in the PENDING_UPDATE state. +// +// 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 Elasticsearch Service's +// API operation CancelElasticsearchServiceSoftwareUpdate for usage and error information. +// +// Returned Error Codes: +// * ErrCodeBaseException "BaseException" +// An error occurred while processing the request. +// +// * ErrCodeInternalException "InternalException" +// The request processing has failed because of an unknown error, exception +// or failure (the failure is internal to the service) . Gives http status code +// of 500. +// +// * ErrCodeResourceNotFoundException "ResourceNotFoundException" +// An exception for accessing or deleting a resource that does not exist. Gives +// http status code of 400. +// +// * ErrCodeValidationException "ValidationException" +// An exception for missing / invalid input fields. Gives http status code of +// 400. +// +func (c *ElasticsearchService) CancelElasticsearchServiceSoftwareUpdate(input *CancelElasticsearchServiceSoftwareUpdateInput) (*CancelElasticsearchServiceSoftwareUpdateOutput, error) { + req, out := c.CancelElasticsearchServiceSoftwareUpdateRequest(input) + return out, req.Send() +} + +// CancelElasticsearchServiceSoftwareUpdateWithContext is the same as CancelElasticsearchServiceSoftwareUpdate with the addition of +// the ability to pass a context and additional request options. +// +// See CancelElasticsearchServiceSoftwareUpdate 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 *ElasticsearchService) CancelElasticsearchServiceSoftwareUpdateWithContext(ctx aws.Context, input *CancelElasticsearchServiceSoftwareUpdateInput, opts ...request.Option) (*CancelElasticsearchServiceSoftwareUpdateOutput, error) { + req, out := c.CancelElasticsearchServiceSoftwareUpdateRequest(input) + req.SetContext(ctx) + req.ApplyOptions(opts...) + return out, req.Send() +} + const opCreateElasticsearchDomain = "CreateElasticsearchDomain" // CreateElasticsearchDomainRequest generates a "aws/request.Request" representing the @@ -2032,6 +2123,95 @@ func (c *ElasticsearchService) RemoveTagsWithContext(ctx aws.Context, input *Rem return out, req.Send() } +const opStartElasticsearchServiceSoftwareUpdate = "StartElasticsearchServiceSoftwareUpdate" + +// StartElasticsearchServiceSoftwareUpdateRequest generates a "aws/request.Request" representing the +// client's request for the StartElasticsearchServiceSoftwareUpdate operation. The "output" return +// value will be populated with the request's response once the request completes +// successfully. +// +// Use "Send" method on the returned Request to send the API call to the service. +// the "output" return value is not valid until after Send returns without error. +// +// See StartElasticsearchServiceSoftwareUpdate for more information on using the StartElasticsearchServiceSoftwareUpdate +// API call, and error handling. +// +// This method is useful when you want to inject custom logic or configuration +// into the SDK's request lifecycle. Such as custom headers, or retry logic. +// +// +// // Example sending a request using the StartElasticsearchServiceSoftwareUpdateRequest method. +// req, resp := client.StartElasticsearchServiceSoftwareUpdateRequest(params) +// +// err := req.Send() +// if err == nil { // resp is now filled +// fmt.Println(resp) +// } +func (c *ElasticsearchService) StartElasticsearchServiceSoftwareUpdateRequest(input *StartElasticsearchServiceSoftwareUpdateInput) (req *request.Request, output *StartElasticsearchServiceSoftwareUpdateOutput) { + op := &request.Operation{ + Name: opStartElasticsearchServiceSoftwareUpdate, + HTTPMethod: "POST", + HTTPPath: "/2015-01-01/es/serviceSoftwareUpdate/start", + } + + if input == nil { + input = &StartElasticsearchServiceSoftwareUpdateInput{} + } + + output = &StartElasticsearchServiceSoftwareUpdateOutput{} + req = c.newRequest(op, input, output) + return +} + +// StartElasticsearchServiceSoftwareUpdate API operation for Amazon Elasticsearch Service. +// +// Schedules a service software update for an Amazon ES domain. +// +// 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 Elasticsearch Service's +// API operation StartElasticsearchServiceSoftwareUpdate for usage and error information. +// +// Returned Error Codes: +// * ErrCodeBaseException "BaseException" +// An error occurred while processing the request. +// +// * ErrCodeInternalException "InternalException" +// The request processing has failed because of an unknown error, exception +// or failure (the failure is internal to the service) . Gives http status code +// of 500. +// +// * ErrCodeResourceNotFoundException "ResourceNotFoundException" +// An exception for accessing or deleting a resource that does not exist. Gives +// http status code of 400. +// +// * ErrCodeValidationException "ValidationException" +// An exception for missing / invalid input fields. Gives http status code of +// 400. +// +func (c *ElasticsearchService) StartElasticsearchServiceSoftwareUpdate(input *StartElasticsearchServiceSoftwareUpdateInput) (*StartElasticsearchServiceSoftwareUpdateOutput, error) { + req, out := c.StartElasticsearchServiceSoftwareUpdateRequest(input) + return out, req.Send() +} + +// StartElasticsearchServiceSoftwareUpdateWithContext is the same as StartElasticsearchServiceSoftwareUpdate with the addition of +// the ability to pass a context and additional request options. +// +// See StartElasticsearchServiceSoftwareUpdate 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 *ElasticsearchService) StartElasticsearchServiceSoftwareUpdateWithContext(ctx aws.Context, input *StartElasticsearchServiceSoftwareUpdateInput, opts ...request.Option) (*StartElasticsearchServiceSoftwareUpdateOutput, error) { + req, out := c.StartElasticsearchServiceSoftwareUpdateRequest(input) + req.SetContext(ctx) + req.ApplyOptions(opts...) + return out, req.Send() +} + const opUpdateElasticsearchDomainConfig = "UpdateElasticsearchDomainConfig" // UpdateElasticsearchDomainConfigRequest generates a "aws/request.Request" representing the @@ -2435,6 +2615,76 @@ func (s *AdvancedOptionsStatus) SetStatus(v *OptionStatus) *AdvancedOptionsStatu return s } +// Container for the parameters to the CancelElasticsearchServiceSoftwareUpdate +// operation. Specifies the name of the Elasticsearch domain that you wish to +// cancel a service software update on. +type CancelElasticsearchServiceSoftwareUpdateInput struct { + _ struct{} `type:"structure"` + + // The name of the domain that you want to stop the latest service software + // update on. + // + // DomainName is a required field + DomainName *string `min:"3" type:"string" required:"true"` +} + +// String returns the string representation +func (s CancelElasticsearchServiceSoftwareUpdateInput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s CancelElasticsearchServiceSoftwareUpdateInput) GoString() string { + return s.String() +} + +// Validate inspects the fields of the type to determine if they are valid. +func (s *CancelElasticsearchServiceSoftwareUpdateInput) Validate() error { + invalidParams := request.ErrInvalidParams{Context: "CancelElasticsearchServiceSoftwareUpdateInput"} + if s.DomainName == nil { + invalidParams.Add(request.NewErrParamRequired("DomainName")) + } + if s.DomainName != nil && len(*s.DomainName) < 3 { + invalidParams.Add(request.NewErrParamMinLen("DomainName", 3)) + } + + if invalidParams.Len() > 0 { + return invalidParams + } + return nil +} + +// SetDomainName sets the DomainName field's value. +func (s *CancelElasticsearchServiceSoftwareUpdateInput) SetDomainName(v string) *CancelElasticsearchServiceSoftwareUpdateInput { + s.DomainName = &v + return s +} + +// The result of a CancelElasticsearchServiceSoftwareUpdate operation. Contains +// the status of the update. +type CancelElasticsearchServiceSoftwareUpdateOutput struct { + _ struct{} `type:"structure"` + + // The current status of the Elasticsearch service software update. + ServiceSoftwareOptions *ServiceSoftwareOptions `type:"structure"` +} + +// String returns the string representation +func (s CancelElasticsearchServiceSoftwareUpdateOutput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s CancelElasticsearchServiceSoftwareUpdateOutput) GoString() string { + return s.String() +} + +// SetServiceSoftwareOptions sets the ServiceSoftwareOptions field's value. +func (s *CancelElasticsearchServiceSoftwareUpdateOutput) SetServiceSoftwareOptions(v *ServiceSoftwareOptions) *CancelElasticsearchServiceSoftwareUpdateOutput { + s.ServiceSoftwareOptions = v + return s +} + // Options to specify the Cognito user and identity pools for Kibana authentication. // For more information, see Amazon Cognito Authentication for Kibana (http://docs.aws.amazon.com/elasticsearch-service/latest/developerguide/es-cognito-auth.html). type CognitoOptions struct { @@ -3746,6 +3996,9 @@ type ElasticsearchDomainStatus struct { // active. Processing *bool `type:"boolean"` + // The current status of the Elasticsearch domain's service software. + ServiceSoftwareOptions *ServiceSoftwareOptions `type:"structure"` + // Specifies the status of the SnapshotOptions SnapshotOptions *SnapshotOptions `type:"structure"` @@ -3870,6 +4123,12 @@ func (s *ElasticsearchDomainStatus) SetProcessing(v bool) *ElasticsearchDomainSt return s } +// SetServiceSoftwareOptions sets the ServiceSoftwareOptions field's value. +func (s *ElasticsearchDomainStatus) SetServiceSoftwareOptions(v *ServiceSoftwareOptions) *ElasticsearchDomainStatus { + s.ServiceSoftwareOptions = v + return s +} + // SetSnapshotOptions sets the SnapshotOptions field's value. func (s *ElasticsearchDomainStatus) SetSnapshotOptions(v *SnapshotOptions) *ElasticsearchDomainStatus { s.SnapshotOptions = v @@ -5303,6 +5562,88 @@ func (s *ReservedElasticsearchInstanceOffering) SetUsagePrice(v float64) *Reserv return s } +// The current options of an Elasticsearch domain service software options. +type ServiceSoftwareOptions struct { + _ struct{} `type:"structure"` + + // Timestamp, in Epoch time, until which you can manually request a service + // software update. After this date, we automatically update your service software. + AutomatedUpdateDate *time.Time `type:"timestamp"` + + // True if you are able to cancel your service software version update. False + // if you are not able to cancel your service software version. + Cancellable *bool `type:"boolean"` + + // The current service software version that is present on the domain. + CurrentVersion *string `type:"string"` + + // The description of the UpdateStatus. + Description *string `type:"string"` + + // The new service software version if one is available. + NewVersion *string `type:"string"` + + // True if you are able to update you service software version. False if you + // are not able to update your service software version. + UpdateAvailable *bool `type:"boolean"` + + // The status of your service software update. This field can take the following + // values: ELIGIBLE, PENDING_UPDATE, IN_PROGRESS, COMPLETED, and NOT_ELIGIBLE. + UpdateStatus *string `type:"string" enum:"DeploymentStatus"` +} + +// String returns the string representation +func (s ServiceSoftwareOptions) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s ServiceSoftwareOptions) GoString() string { + return s.String() +} + +// SetAutomatedUpdateDate sets the AutomatedUpdateDate field's value. +func (s *ServiceSoftwareOptions) SetAutomatedUpdateDate(v time.Time) *ServiceSoftwareOptions { + s.AutomatedUpdateDate = &v + return s +} + +// SetCancellable sets the Cancellable field's value. +func (s *ServiceSoftwareOptions) SetCancellable(v bool) *ServiceSoftwareOptions { + s.Cancellable = &v + return s +} + +// SetCurrentVersion sets the CurrentVersion field's value. +func (s *ServiceSoftwareOptions) SetCurrentVersion(v string) *ServiceSoftwareOptions { + s.CurrentVersion = &v + return s +} + +// SetDescription sets the Description field's value. +func (s *ServiceSoftwareOptions) SetDescription(v string) *ServiceSoftwareOptions { + s.Description = &v + return s +} + +// SetNewVersion sets the NewVersion field's value. +func (s *ServiceSoftwareOptions) SetNewVersion(v string) *ServiceSoftwareOptions { + s.NewVersion = &v + return s +} + +// SetUpdateAvailable sets the UpdateAvailable field's value. +func (s *ServiceSoftwareOptions) SetUpdateAvailable(v bool) *ServiceSoftwareOptions { + s.UpdateAvailable = &v + return s +} + +// SetUpdateStatus sets the UpdateStatus field's value. +func (s *ServiceSoftwareOptions) SetUpdateStatus(v string) *ServiceSoftwareOptions { + s.UpdateStatus = &v + return s +} + // Specifies the time, in UTC format, when the service takes a daily automated // snapshot of the specified Elasticsearch domain. Default value is 0 hours. type SnapshotOptions struct { @@ -5366,6 +5707,75 @@ func (s *SnapshotOptionsStatus) SetStatus(v *OptionStatus) *SnapshotOptionsStatu return s } +// Container for the parameters to the StartElasticsearchServiceSoftwareUpdate +// operation. Specifies the name of the Elasticsearch domain that you wish to +// schedule a service software update on. +type StartElasticsearchServiceSoftwareUpdateInput struct { + _ struct{} `type:"structure"` + + // The name of the domain that you want to update to the latest service software. + // + // DomainName is a required field + DomainName *string `min:"3" type:"string" required:"true"` +} + +// String returns the string representation +func (s StartElasticsearchServiceSoftwareUpdateInput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s StartElasticsearchServiceSoftwareUpdateInput) GoString() string { + return s.String() +} + +// Validate inspects the fields of the type to determine if they are valid. +func (s *StartElasticsearchServiceSoftwareUpdateInput) Validate() error { + invalidParams := request.ErrInvalidParams{Context: "StartElasticsearchServiceSoftwareUpdateInput"} + if s.DomainName == nil { + invalidParams.Add(request.NewErrParamRequired("DomainName")) + } + if s.DomainName != nil && len(*s.DomainName) < 3 { + invalidParams.Add(request.NewErrParamMinLen("DomainName", 3)) + } + + if invalidParams.Len() > 0 { + return invalidParams + } + return nil +} + +// SetDomainName sets the DomainName field's value. +func (s *StartElasticsearchServiceSoftwareUpdateInput) SetDomainName(v string) *StartElasticsearchServiceSoftwareUpdateInput { + s.DomainName = &v + return s +} + +// The result of a StartElasticsearchServiceSoftwareUpdate operation. Contains +// the status of the update. +type StartElasticsearchServiceSoftwareUpdateOutput struct { + _ struct{} `type:"structure"` + + // The current status of the Elasticsearch service software update. + ServiceSoftwareOptions *ServiceSoftwareOptions `type:"structure"` +} + +// String returns the string representation +func (s StartElasticsearchServiceSoftwareUpdateOutput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s StartElasticsearchServiceSoftwareUpdateOutput) GoString() string { + return s.String() +} + +// SetServiceSoftwareOptions sets the ServiceSoftwareOptions field's value. +func (s *StartElasticsearchServiceSoftwareUpdateOutput) SetServiceSoftwareOptions(v *ServiceSoftwareOptions) *StartElasticsearchServiceSoftwareUpdateOutput { + s.ServiceSoftwareOptions = v + return s +} + // StorageTypes represents the list of storage related types and their attributes // that are available for given InstanceType. type StorageType struct { @@ -6032,6 +6442,23 @@ func (s *VPCOptions) SetSubnetIds(v []*string) *VPCOptions { return s } +const ( + // DeploymentStatusPendingUpdate is a DeploymentStatus enum value + DeploymentStatusPendingUpdate = "PENDING_UPDATE" + + // DeploymentStatusInProgress is a DeploymentStatus enum value + DeploymentStatusInProgress = "IN_PROGRESS" + + // DeploymentStatusCompleted is a DeploymentStatus enum value + DeploymentStatusCompleted = "COMPLETED" + + // DeploymentStatusNotEligible is a DeploymentStatus enum value + DeploymentStatusNotEligible = "NOT_ELIGIBLE" + + // DeploymentStatusEligible is a DeploymentStatus enum value + DeploymentStatusEligible = "ELIGIBLE" +) + const ( // ESPartitionInstanceTypeM3MediumElasticsearch is a ESPartitionInstanceType enum value ESPartitionInstanceTypeM3MediumElasticsearch = "m3.medium.elasticsearch" diff --git a/service/elasticsearchservice/elasticsearchserviceiface/interface.go b/service/elasticsearchservice/elasticsearchserviceiface/interface.go index a30f9e10007..4d082c2867e 100644 --- a/service/elasticsearchservice/elasticsearchserviceiface/interface.go +++ b/service/elasticsearchservice/elasticsearchserviceiface/interface.go @@ -64,6 +64,10 @@ type ElasticsearchServiceAPI interface { AddTagsWithContext(aws.Context, *elasticsearchservice.AddTagsInput, ...request.Option) (*elasticsearchservice.AddTagsOutput, error) AddTagsRequest(*elasticsearchservice.AddTagsInput) (*request.Request, *elasticsearchservice.AddTagsOutput) + CancelElasticsearchServiceSoftwareUpdate(*elasticsearchservice.CancelElasticsearchServiceSoftwareUpdateInput) (*elasticsearchservice.CancelElasticsearchServiceSoftwareUpdateOutput, error) + CancelElasticsearchServiceSoftwareUpdateWithContext(aws.Context, *elasticsearchservice.CancelElasticsearchServiceSoftwareUpdateInput, ...request.Option) (*elasticsearchservice.CancelElasticsearchServiceSoftwareUpdateOutput, error) + CancelElasticsearchServiceSoftwareUpdateRequest(*elasticsearchservice.CancelElasticsearchServiceSoftwareUpdateInput) (*request.Request, *elasticsearchservice.CancelElasticsearchServiceSoftwareUpdateOutput) + CreateElasticsearchDomain(*elasticsearchservice.CreateElasticsearchDomainInput) (*elasticsearchservice.CreateElasticsearchDomainOutput, error) CreateElasticsearchDomainWithContext(aws.Context, *elasticsearchservice.CreateElasticsearchDomainInput, ...request.Option) (*elasticsearchservice.CreateElasticsearchDomainOutput, error) CreateElasticsearchDomainRequest(*elasticsearchservice.CreateElasticsearchDomainInput) (*request.Request, *elasticsearchservice.CreateElasticsearchDomainOutput) @@ -151,6 +155,10 @@ type ElasticsearchServiceAPI interface { RemoveTagsWithContext(aws.Context, *elasticsearchservice.RemoveTagsInput, ...request.Option) (*elasticsearchservice.RemoveTagsOutput, error) RemoveTagsRequest(*elasticsearchservice.RemoveTagsInput) (*request.Request, *elasticsearchservice.RemoveTagsOutput) + StartElasticsearchServiceSoftwareUpdate(*elasticsearchservice.StartElasticsearchServiceSoftwareUpdateInput) (*elasticsearchservice.StartElasticsearchServiceSoftwareUpdateOutput, error) + StartElasticsearchServiceSoftwareUpdateWithContext(aws.Context, *elasticsearchservice.StartElasticsearchServiceSoftwareUpdateInput, ...request.Option) (*elasticsearchservice.StartElasticsearchServiceSoftwareUpdateOutput, error) + StartElasticsearchServiceSoftwareUpdateRequest(*elasticsearchservice.StartElasticsearchServiceSoftwareUpdateInput) (*request.Request, *elasticsearchservice.StartElasticsearchServiceSoftwareUpdateOutput) + UpdateElasticsearchDomainConfig(*elasticsearchservice.UpdateElasticsearchDomainConfigInput) (*elasticsearchservice.UpdateElasticsearchDomainConfigOutput, error) UpdateElasticsearchDomainConfigWithContext(aws.Context, *elasticsearchservice.UpdateElasticsearchDomainConfigInput, ...request.Option) (*elasticsearchservice.UpdateElasticsearchDomainConfigOutput, error) UpdateElasticsearchDomainConfigRequest(*elasticsearchservice.UpdateElasticsearchDomainConfigInput) (*request.Request, *elasticsearchservice.UpdateElasticsearchDomainConfigOutput) diff --git a/service/lambda/api.go b/service/lambda/api.go index 995cfd6d6cf..2bea0f2faf2 100644 --- a/service/lambda/api.go +++ b/service/lambda/api.go @@ -59,17 +59,16 @@ func (c *Lambda) AddPermissionRequest(input *AddPermissionInput) (req *request.R // // Adds a permission to the resource policy associated with the specified AWS // Lambda function. You use resource policies to grant permissions to event -// sources that use push model. In a push model, event sources (such as Amazon -// S3 and custom applications) invoke your Lambda function. Each permission -// you add to the resource policy allows an event source, permission to invoke +// sources that use the push model. In a push model, event sources (such as +// Amazon S3 and custom applications) invoke your Lambda function. Each permission +// you add to the resource policy allows an event source permission to invoke // the Lambda function. // -// For information about the push model, see Lambda Functions (http://docs.aws.amazon.com/lambda/latest/dg/lambda-introduction.html). -// -// If you are using versioning, the permissions you add are specific to the -// Lambda function version or alias you specify in the AddPermission request -// via the Qualifier parameter. For more information about versioning, see AWS -// Lambda Function Versioning and Aliases (http://docs.aws.amazon.com/lambda/latest/dg/versioning-aliases.html). +// Permissions apply to the Amazon Resource Name (ARN) used to invoke the function, +// which can be unqualified (the unpublished version of the function), or include +// a version or alias. If a client uses a version or alias to invoke a function, +// use the Qualifier parameter to apply permissions to that ARN. For more information +// about versioning, see AWS Lambda Function Versioning and Aliases (http://docs.aws.amazon.com/lambda/latest/dg/versioning-aliases.html). // // This operation requires permission for the lambda:AddPermission action. // @@ -100,6 +99,7 @@ func (c *Lambda) AddPermissionRequest(input *AddPermissionInput) (req *request.R // Lambda function access policy is limited to 20 KB. // // * ErrCodeTooManyRequestsException "TooManyRequestsException" +// Request throughput limit exceeded // // * ErrCodePreconditionFailedException "PreconditionFailedException" // The RevisionId provided does not match the latest RevisionId for the Lambda @@ -202,6 +202,7 @@ func (c *Lambda) CreateAliasRequest(input *CreateAliasInput) (req *request.Reque // API, that AWS Lambda is unable to assume you will get this exception. // // * ErrCodeTooManyRequestsException "TooManyRequestsException" +// Request throughput limit exceeded // // See also, https://docs.aws.amazon.com/goto/WebAPI/lambda-2015-03-31/CreateAlias func (c *Lambda) CreateAlias(input *CreateAliasInput) (*AliasConfiguration, error) { @@ -270,8 +271,8 @@ func (c *Lambda) CreateEventSourceMappingRequest(input *CreateEventSourceMapping // CreateEventSourceMapping API operation for AWS Lambda. // // Identifies a poll-based event source for a Lambda function. It can be either -// an Amazon Kinesis or DynamoDB stream, or an Amazon SQS queue. AWS Lambda -// invokes the specified function when records are posted to the event source. +// an Amazon Kinesis or DynamoDB stream. AWS Lambda invokes the specified function +// when records are posted to the event source. // // This association between a poll-based source and a Lambda function is called // the event source mapping. @@ -285,6 +286,9 @@ func (c *Lambda) CreateEventSourceMappingRequest(input *CreateEventSourceMapping // sources for a single Lambda function, but an SQS queue can be mapped only // to a single Lambda function. // +// You can configure an SQS queue in an account separate from your Lambda function's +// account. Also the queue needs to reside in the same AWS region as your function. +// // If you are using versioning, you can specify a specific function version // or an alias via the function name parameter. For more information about versioning, // see AWS Lambda Function Versioning and Aliases (http://docs.aws.amazon.com/lambda/latest/dg/versioning-aliases.html). @@ -312,6 +316,7 @@ func (c *Lambda) CreateEventSourceMappingRequest(input *CreateEventSourceMapping // The resource already exists. // // * ErrCodeTooManyRequestsException "TooManyRequestsException" +// Request throughput limit exceeded // // * ErrCodeResourceNotFoundException "ResourceNotFoundException" // The resource (for example, a Lambda function or access policy statement) @@ -383,14 +388,9 @@ func (c *Lambda) CreateFunctionRequest(input *CreateFunctionInput) (req *request // CreateFunction API operation for AWS Lambda. // -// Creates a new Lambda function. The function metadata is created from the -// request parameters, and the code for the function is provided by a .zip file -// in the request body. If the function name already exists, the operation will -// fail. Note that the function name is case-sensitive. -// -// If you are using versioning, you can also publish a version of the Lambda -// function you are creating using the Publish parameter. For more information -// about versioning, see AWS Lambda Function Versioning and Aliases (http://docs.aws.amazon.com/lambda/latest/dg/versioning-aliases.html). +// Creates a new Lambda function. The function configuration is created from +// the request parameters, and the code for the function is provided by a .zip +// file. The function name is case-sensitive. // // This operation requires permission for the lambda:CreateFunction action. // @@ -418,6 +418,7 @@ func (c *Lambda) CreateFunctionRequest(input *CreateFunctionInput) (req *request // The resource already exists. // // * ErrCodeTooManyRequestsException "TooManyRequestsException" +// Request throughput limit exceeded // // * ErrCodeCodeStorageExceededException "CodeStorageExceededException" // You have exceeded your maximum total code size per account. Limits (http://docs.aws.amazon.com/lambda/latest/dg/limits.html) @@ -512,6 +513,7 @@ func (c *Lambda) DeleteAliasRequest(input *DeleteAliasInput) (req *request.Reque // API, that AWS Lambda is unable to assume you will get this exception. // // * ErrCodeTooManyRequestsException "TooManyRequestsException" +// Request throughput limit exceeded // // See also, https://docs.aws.amazon.com/goto/WebAPI/lambda-2015-03-31/DeleteAlias func (c *Lambda) DeleteAlias(input *DeleteAliasInput) (*DeleteAliasOutput, error) { @@ -606,6 +608,7 @@ func (c *Lambda) DeleteEventSourceMappingRequest(input *DeleteEventSourceMapping // API, that AWS Lambda is unable to assume you will get this exception. // // * ErrCodeTooManyRequestsException "TooManyRequestsException" +// Request throughput limit exceeded // // * ErrCodeResourceInUseException "ResourceInUseException" // The operation conflicts with the resource's availability. For example, you @@ -680,17 +683,9 @@ func (c *Lambda) DeleteFunctionRequest(input *DeleteFunctionInput) (req *request // DeleteFunction API operation for AWS Lambda. // -// Deletes the specified Lambda function code and configuration. -// -// If you are using the versioning feature and you don't specify a function -// version in your DeleteFunction request, AWS Lambda will delete the function, -// including all its versions, and any aliases pointing to the function versions. -// To delete a specific function version, you must provide the function version -// via the Qualifier parameter. For information about function versioning, see -// AWS Lambda Function Versioning and Aliases (http://docs.aws.amazon.com/lambda/latest/dg/versioning-aliases.html). -// -// When you delete a function the associated resource policy is also deleted. -// You will need to delete the event source mappings explicitly. +// Deletes a Lambda function. To delete a specific function version, use the +// Qualifier parameter. Otherwise, all versions and aliases are deleted. Event +// source mappings are not deleted. // // This operation requires permission for the lambda:DeleteFunction action. // @@ -710,6 +705,7 @@ func (c *Lambda) DeleteFunctionRequest(input *DeleteFunctionInput) (req *request // specified in the request does not exist. // // * ErrCodeTooManyRequestsException "TooManyRequestsException" +// Request throughput limit exceeded // // * ErrCodeInvalidParameterValueException "InvalidParameterValueException" // One of the parameters in the request is invalid. For example, if you provided @@ -788,7 +784,7 @@ func (c *Lambda) DeleteFunctionConcurrencyRequest(input *DeleteFunctionConcurren // DeleteFunctionConcurrency API operation for AWS Lambda. // // Removes concurrent execution limits from this function. For more information, -// see concurrent-executions. +// see Managing Concurrency (http://docs.aws.amazon.com/lambda/latest/dg/concurrent-executions.html). // // 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 @@ -806,6 +802,7 @@ func (c *Lambda) DeleteFunctionConcurrencyRequest(input *DeleteFunctionConcurren // specified in the request does not exist. // // * ErrCodeTooManyRequestsException "TooManyRequestsException" +// Request throughput limit exceeded // // * ErrCodeInvalidParameterValueException "InvalidParameterValueException" // One of the parameters in the request is invalid. For example, if you provided @@ -878,13 +875,8 @@ func (c *Lambda) GetAccountSettingsRequest(input *GetAccountSettingsInput) (req // GetAccountSettings API operation for AWS Lambda. // -// Returns a customer's account settings. -// -// You can use this operation to retrieve Lambda limits information, such as -// code size and concurrency limits. For more information about limits, see -// AWS Lambda Limits (http://docs.aws.amazon.com/lambda/latest/dg/limits.html). -// You can also retrieve resource usage statistics, such as code storage usage -// and function count. +// Retrieves details about your account's limits (http://docs.aws.amazon.com/lambda/latest/dg/limits.html) +// and usage 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 @@ -895,6 +887,7 @@ func (c *Lambda) GetAccountSettingsRequest(input *GetAccountSettingsInput) (req // // Returned Error Codes: // * ErrCodeTooManyRequestsException "TooManyRequestsException" +// Request throughput limit exceeded // // * ErrCodeServiceException "ServiceException" // The AWS Lambda service encountered an internal error. @@ -992,6 +985,7 @@ func (c *Lambda) GetAliasRequest(input *GetAliasInput) (req *request.Request, ou // API, that AWS Lambda is unable to assume you will get this exception. // // * ErrCodeTooManyRequestsException "TooManyRequestsException" +// Request throughput limit exceeded // // See also, https://docs.aws.amazon.com/goto/WebAPI/lambda-2015-03-31/GetAlias func (c *Lambda) GetAlias(input *GetAliasInput) (*AliasConfiguration, error) { @@ -1085,6 +1079,7 @@ func (c *Lambda) GetEventSourceMappingRequest(input *GetEventSourceMappingInput) // API, that AWS Lambda is unable to assume you will get this exception. // // * ErrCodeTooManyRequestsException "TooManyRequestsException" +// Request throughput limit exceeded // // See also, https://docs.aws.amazon.com/goto/WebAPI/lambda-2015-03-31/GetEventSourceMapping func (c *Lambda) GetEventSourceMapping(input *GetEventSourceMappingInput) (*EventSourceMappingConfiguration, error) { @@ -1158,11 +1153,9 @@ func (c *Lambda) GetFunctionRequest(input *GetFunctionInput) (req *request.Reque // information is the same information you provided as parameters when uploading // the function. // -// Using the optional Qualifier parameter, you can specify a specific function -// version for which you want this information. If you don't specify this parameter, -// the API uses unqualified function ARN which return information about the -// $LATEST version of the Lambda function. For more information, see AWS Lambda -// Function Versioning and Aliases (http://docs.aws.amazon.com/lambda/latest/dg/versioning-aliases.html). +// Use the Qualifier parameter to retrieve a published version of the function. +// Otherwise, returns the unpublished version ($LATEST). For more information, +// see AWS Lambda Function Versioning and Aliases (http://docs.aws.amazon.com/lambda/latest/dg/versioning-aliases.html). // // This operation requires permission for the lambda:GetFunction action. // @@ -1182,6 +1175,7 @@ func (c *Lambda) GetFunctionRequest(input *GetFunctionInput) (req *request.Reque // specified in the request does not exist. // // * ErrCodeTooManyRequestsException "TooManyRequestsException" +// Request throughput limit exceeded // // * ErrCodeInvalidParameterValueException "InvalidParameterValueException" // One of the parameters in the request is invalid. For example, if you provided @@ -1284,6 +1278,7 @@ func (c *Lambda) GetFunctionConfigurationRequest(input *GetFunctionConfiguration // specified in the request does not exist. // // * ErrCodeTooManyRequestsException "TooManyRequestsException" +// Request throughput limit exceeded // // * ErrCodeInvalidParameterValueException "InvalidParameterValueException" // One of the parameters in the request is invalid. For example, if you provided @@ -1358,12 +1353,7 @@ func (c *Lambda) GetPolicyRequest(input *GetPolicyInput) (req *request.Request, // // Returns the resource policy associated with the specified Lambda function. // -// If you are using the versioning feature, you can get the resource policy -// associated with the specific Lambda function version or alias by specifying -// the version or alias name using the Qualifier parameter. For more information -// about versioning, see AWS Lambda Function Versioning and Aliases (http://docs.aws.amazon.com/lambda/latest/dg/versioning-aliases.html). -// -// You need permission for the lambda:GetPolicy action. +// This action requires permission for the lambda:GetPolicy 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 @@ -1381,6 +1371,7 @@ func (c *Lambda) GetPolicyRequest(input *GetPolicyInput) (req *request.Request, // specified in the request does not exist. // // * ErrCodeTooManyRequestsException "TooManyRequestsException" +// Request throughput limit exceeded // // * ErrCodeInvalidParameterValueException "InvalidParameterValueException" // One of the parameters in the request is invalid. For example, if you provided @@ -1453,16 +1444,22 @@ func (c *Lambda) InvokeRequest(input *InvokeInput) (req *request.Request, output // Invoke API operation for AWS Lambda. // -// Invokes a specific Lambda function. For an example, see Create the Lambda -// Function and Test It Manually (http://docs.aws.amazon.com/lambda/latest/dg/with-dynamodb-create-function.html#with-dbb-invoke-manually). +// Invokes a Lambda function. For an example, see Create the Lambda Function +// and Test It Manually (http://docs.aws.amazon.com/lambda/latest/dg/with-dynamodb-create-function.html#with-dbb-invoke-manually). // -// If you are using the versioning feature, you can invoke the specific function -// version by providing function version or alias name that is pointing to the -// function version using the Qualifier parameter in the request. If you don't -// provide the Qualifier parameter, the $LATEST version of the Lambda function -// is invoked. Invocations occur at least once in response to an event and functions -// must be idempotent to handle this. For information about the versioning feature, -// see AWS Lambda Function Versioning and Aliases (http://docs.aws.amazon.com/lambda/latest/dg/versioning-aliases.html). +// Specify just a function name to invoke the latest version of the function. +// To invoke a published version, use the Qualifier parameter to specify a version +// or alias (http://docs.aws.amazon.com/lambda/latest/dg/versioning-aliases.html). +// +// If you use the RequestResponse (synchronous) invocation option, the function +// will be invoked only once. If you use the Event (asynchronous) invocation +// option, the function will be invoked at least once in response to an event +// and the function must be idempotent to handle this. +// +// For functions with a long timeout, your client may be disconnected during +// synchronous invocation while it waits for a response. Configure your HTTP +// client, SDK, firewall, proxy, or operating system to allow for long connections +// with timeout or keep-alive settings. // // This operation requires permission for the lambda:InvokeFunction action. // @@ -1499,6 +1496,7 @@ func (c *Lambda) InvokeRequest(input *InvokeInput) (req *request.Request, output // The content type of the Invoke request body is not JSON. // // * ErrCodeTooManyRequestsException "TooManyRequestsException" +// Request throughput limit exceeded // // * ErrCodeInvalidParameterValueException "InvalidParameterValueException" // One of the parameters in the request is invalid. For example, if you provided @@ -1523,6 +1521,7 @@ func (c *Lambda) InvokeRequest(input *InvokeInput) (req *request.Request, output // using the execution role provided for the Lambda function. // // * ErrCodeEC2AccessDeniedException "EC2AccessDeniedException" +// Need additional permissions to configure VPC settings. // // * ErrCodeInvalidSubnetIDException "InvalidSubnetIDException" // The Subnet ID provided in the Lambda function VPC configuration is invalid. @@ -1532,7 +1531,7 @@ func (c *Lambda) InvokeRequest(input *InvokeInput) (req *request.Request, output // invalid. // // * ErrCodeInvalidZipFileException "InvalidZipFileException" -// AWS Lambda could not unzip the function zip file. +// AWS Lambda could not unzip the deployment package. // // * ErrCodeKMSDisabledException "KMSDisabledException" // Lambda was unable to decrypt the environment variables because the KMS key @@ -1624,7 +1623,7 @@ func (c *Lambda) InvokeAsyncRequest(input *InvokeAsyncInput) (req *request.Reque // InvokeAsync API operation for AWS Lambda. // -// This API is deprecated. We recommend you use Invoke API (see Invoke). +// For asynchronous function invocation, use Invoke. // // Submits an invocation request to AWS Lambda. Upon receiving the request, // Lambda executes the specified function asynchronously. To see the logs generated @@ -1751,6 +1750,7 @@ func (c *Lambda) ListAliasesRequest(input *ListAliasesInput) (req *request.Reque // API, that AWS Lambda is unable to assume you will get this exception. // // * ErrCodeTooManyRequestsException "TooManyRequestsException" +// Request throughput limit exceeded // // See also, https://docs.aws.amazon.com/goto/WebAPI/lambda-2015-03-31/ListAliases func (c *Lambda) ListAliases(input *ListAliasesInput) (*ListAliasesOutput, error) { @@ -1830,11 +1830,6 @@ func (c *Lambda) ListEventSourceMappingsRequest(input *ListEventSourceMappingsIn // For each mapping, the API returns configuration information. You can optionally // specify filters to retrieve specific event source mappings. // -// If you are using the versioning feature, you can get list of event source -// mappings for a specific Lambda function version or an alias as described -// in the FunctionName parameter. For information about the versioning feature, -// see AWS Lambda Function Versioning and Aliases (http://docs.aws.amazon.com/lambda/latest/dg/versioning-aliases.html). -// // This operation requires permission for the lambda:ListEventSourceMappings // action. // @@ -1859,6 +1854,7 @@ func (c *Lambda) ListEventSourceMappingsRequest(input *ListEventSourceMappingsIn // API, that AWS Lambda is unable to assume you will get this exception. // // * ErrCodeTooManyRequestsException "TooManyRequestsException" +// Request throughput limit exceeded // // See also, https://docs.aws.amazon.com/goto/WebAPI/lambda-2015-03-31/ListEventSourceMappings func (c *Lambda) ListEventSourceMappings(input *ListEventSourceMappingsInput) (*ListEventSourceMappingsOutput, error) { @@ -2004,6 +2000,7 @@ func (c *Lambda) ListFunctionsRequest(input *ListFunctionsInput) (req *request.R // The AWS Lambda service encountered an internal error. // // * ErrCodeTooManyRequestsException "TooManyRequestsException" +// Request throughput limit exceeded // // * ErrCodeInvalidParameterValueException "InvalidParameterValueException" // One of the parameters in the request is invalid. For example, if you provided @@ -2152,6 +2149,7 @@ func (c *Lambda) ListTagsRequest(input *ListTagsInput) (req *request.Request, ou // API, that AWS Lambda is unable to assume you will get this exception. // // * ErrCodeTooManyRequestsException "TooManyRequestsException" +// Request throughput limit exceeded // // See also, https://docs.aws.amazon.com/goto/WebAPI/lambda-2015-03-31/ListTags func (c *Lambda) ListTags(input *ListTagsInput) (*ListTagsOutput, error) { @@ -2219,8 +2217,8 @@ func (c *Lambda) ListVersionsByFunctionRequest(input *ListVersionsByFunctionInpu // ListVersionsByFunction API operation for AWS Lambda. // -// List all versions of a function. For information about the versioning feature, -// see AWS Lambda Function Versioning and Aliases (http://docs.aws.amazon.com/lambda/latest/dg/versioning-aliases.html). +// Lists all versions of a function. For information about versioning, see AWS +// Lambda Function Versioning and Aliases (http://docs.aws.amazon.com/lambda/latest/dg/versioning-aliases.html). // // 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 @@ -2243,6 +2241,7 @@ func (c *Lambda) ListVersionsByFunctionRequest(input *ListVersionsByFunctionInpu // API, that AWS Lambda is unable to assume you will get this exception. // // * ErrCodeTooManyRequestsException "TooManyRequestsException" +// Request throughput limit exceeded // // See also, https://docs.aws.amazon.com/goto/WebAPI/lambda-2015-03-31/ListVersionsByFunction func (c *Lambda) ListVersionsByFunction(input *ListVersionsByFunctionInput) (*ListVersionsByFunctionOutput, error) { @@ -2337,6 +2336,7 @@ func (c *Lambda) PublishVersionRequest(input *PublishVersionInput) (req *request // API, that AWS Lambda is unable to assume you will get this exception. // // * ErrCodeTooManyRequestsException "TooManyRequestsException" +// Request throughput limit exceeded // // * ErrCodeCodeStorageExceededException "CodeStorageExceededException" // You have exceeded your maximum total code size per account. Limits (http://docs.aws.amazon.com/lambda/latest/dg/limits.html) @@ -2417,7 +2417,7 @@ func (c *Lambda) PutFunctionConcurrencyRequest(input *PutFunctionConcurrencyInpu // Note that Lambda automatically reserves a buffer of 100 concurrent executions // for functions without any reserved concurrency limit. This means if your // account limit is 1000, you have a total of 900 available to allocate to individual -// functions. For more information, see concurrent-executions. +// functions. For more information, see Managing Concurrency (http://docs.aws.amazon.com/lambda/latest/dg/concurrent-executions.html). // // 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 @@ -2440,6 +2440,7 @@ func (c *Lambda) PutFunctionConcurrencyRequest(input *PutFunctionConcurrencyInpu // specified in the request does not exist. // // * ErrCodeTooManyRequestsException "TooManyRequestsException" +// Request throughput limit exceeded // // See also, https://docs.aws.amazon.com/goto/WebAPI/lambda-2015-03-31/PutFunctionConcurrency func (c *Lambda) PutFunctionConcurrency(input *PutFunctionConcurrencyInput) (*PutFunctionConcurrencyOutput, error) { @@ -2509,17 +2510,17 @@ func (c *Lambda) RemovePermissionRequest(input *RemovePermissionInput) (req *req // RemovePermission API operation for AWS Lambda. // -// You can remove individual permissions from an resource policy associated -// with a Lambda function by providing a statement ID that you provided when -// you added the permission. -// -// If you are using versioning, the permissions you remove are specific to the -// Lambda function version or alias you specify in the AddPermission request -// via the Qualifier parameter. For more information about versioning, see AWS -// Lambda Function Versioning and Aliases (http://docs.aws.amazon.com/lambda/latest/dg/versioning-aliases.html). +// Removes permissions from a function. You can remove individual permissions +// from an resource policy associated with a Lambda function by providing a +// statement ID that you provided when you added the permission. When you remove +// permissions, disable the event source mapping or trigger configuration first +// to avoid errors. // -// Note that removal of a permission will cause an active event source to lose -// permission to the function. +// Permissions apply to the Amazon Resource Name (ARN) used to invoke the function, +// which can be unqualified (the unpublished version of the function), or include +// a version or alias. If a client uses a version or alias to invoke a function, +// use the Qualifier parameter to apply permissions to that ARN. For more information +// about versioning, see AWS Lambda Function Versioning and Aliases (http://docs.aws.amazon.com/lambda/latest/dg/versioning-aliases.html). // // You need permission for the lambda:RemovePermission action. // @@ -2544,6 +2545,7 @@ func (c *Lambda) RemovePermissionRequest(input *RemovePermissionInput) (req *req // API, that AWS Lambda is unable to assume you will get this exception. // // * ErrCodeTooManyRequestsException "TooManyRequestsException" +// Request throughput limit exceeded // // * ErrCodePreconditionFailedException "PreconditionFailedException" // The RevisionId provided does not match the latest RevisionId for the Lambda @@ -2645,6 +2647,7 @@ func (c *Lambda) TagResourceRequest(input *TagResourceInput) (req *request.Reque // API, that AWS Lambda is unable to assume you will get this exception. // // * ErrCodeTooManyRequestsException "TooManyRequestsException" +// Request throughput limit exceeded // // See also, https://docs.aws.amazon.com/goto/WebAPI/lambda-2015-03-31/TagResource func (c *Lambda) TagResource(input *TagResourceInput) (*TagResourceOutput, error) { @@ -2739,6 +2742,7 @@ func (c *Lambda) UntagResourceRequest(input *UntagResourceInput) (req *request.R // API, that AWS Lambda is unable to assume you will get this exception. // // * ErrCodeTooManyRequestsException "TooManyRequestsException" +// Request throughput limit exceeded // // See also, https://docs.aws.amazon.com/goto/WebAPI/lambda-2015-03-31/UntagResource func (c *Lambda) UntagResource(input *UntagResourceInput) (*UntagResourceOutput, error) { @@ -2833,6 +2837,7 @@ func (c *Lambda) UpdateAliasRequest(input *UpdateAliasInput) (req *request.Reque // API, that AWS Lambda is unable to assume you will get this exception. // // * ErrCodeTooManyRequestsException "TooManyRequestsException" +// Request throughput limit exceeded // // * ErrCodePreconditionFailedException "PreconditionFailedException" // The RevisionId provided does not match the latest RevisionId for the Lambda @@ -2910,11 +2915,6 @@ func (c *Lambda) UpdateEventSourceMappingRequest(input *UpdateEventSourceMapping // stream. You can change which function will receive the stream records, but // to change the stream itself, you must create a new mapping. // -// If you are using the versioning feature, you can update the event source -// mapping to map to a specific Lambda function version or alias as described -// in the FunctionName parameter. For information about the versioning feature, -// see AWS Lambda Function Versioning and Aliases (http://docs.aws.amazon.com/lambda/latest/dg/versioning-aliases.html). -// // If you disable the event source mapping, AWS Lambda stops polling. If you // enable again, it will resume polling from the time it had stopped polling, // so you don't lose processing of any records. However, if you delete event @@ -2944,6 +2944,7 @@ func (c *Lambda) UpdateEventSourceMappingRequest(input *UpdateEventSourceMapping // API, that AWS Lambda is unable to assume you will get this exception. // // * ErrCodeTooManyRequestsException "TooManyRequestsException" +// Request throughput limit exceeded // // * ErrCodeResourceConflictException "ResourceConflictException" // The resource already exists. @@ -3050,6 +3051,7 @@ func (c *Lambda) UpdateFunctionCodeRequest(input *UpdateFunctionCodeInput) (req // API, that AWS Lambda is unable to assume you will get this exception. // // * ErrCodeTooManyRequestsException "TooManyRequestsException" +// Request throughput limit exceeded // // * ErrCodeCodeStorageExceededException "CodeStorageExceededException" // You have exceeded your maximum total code size per account. Limits (http://docs.aws.amazon.com/lambda/latest/dg/limits.html) @@ -3158,6 +3160,7 @@ func (c *Lambda) UpdateFunctionConfigurationRequest(input *UpdateFunctionConfigu // API, that AWS Lambda is unable to assume you will get this exception. // // * ErrCodeTooManyRequestsException "TooManyRequestsException" +// Request throughput limit exceeded // // * ErrCodeResourceConflictException "ResourceConflictException" // The resource already exists. @@ -3190,7 +3193,8 @@ func (c *Lambda) UpdateFunctionConfigurationWithContext(ctx aws.Context, input * } // Provides limits of code size and concurrency associated with the current -// account and region. +// account and region. For more information or to request a limit increase for +// concurrent executions, see Lambda Limits (http://docs.aws.amazon.com/lambda/latest/dg/limits.html). type AccountLimit struct { _ struct{} `type:"structure"` @@ -3203,10 +3207,8 @@ type AccountLimit struct { // larger files. Default limit is 50 MB. CodeSizeZipped *int64 `type:"long"` - // Number of simultaneous executions of your function per region. For more information - // or to request a limit increase for concurrent executions, see Lambda Function - // Concurrent Executions (http://docs.aws.amazon.com/lambda/latest/dg/concurrent-executions.html). - // The default limit is 1000. + // Number of simultaneous executions of your function per region. The default + // limit is 1000. ConcurrentExecutions *int64 `type:"integer"` // Maximum size, in bytes, of a code package you can upload per region. The @@ -3214,7 +3216,7 @@ type AccountLimit struct { TotalCodeSize *int64 `type:"long"` // The number of concurrent executions available to functions that do not have - // concurrency limits set. For more information, see concurrent-executions. + // concurrency limits set. For more information, see Managing Concurrency (http://docs.aws.amazon.com/lambda/latest/dg/concurrent-executions.html). UnreservedConcurrentExecutions *int64 `type:"integer"` } @@ -3307,52 +3309,40 @@ type AddPermissionInput struct { // This is currently only used for Alexa Smart Home functions. EventSourceToken *string `type:"string"` - // Name of the Lambda function whose resource policy you are updating by adding - // a new permission. + // The name of the lambda function. + // + // Name formats + // + // * Function name - MyFunction. + // + // * Function ARN - arn:aws:lambda:us-west-2:123456789012:function:MyFunction. // - // You can specify a function name (for example, Thumbnail) or you can specify - // Amazon Resource Name (ARN) of the function (for example, arn:aws:lambda:us-west-2:account-id:function:ThumbNail). - // AWS Lambda also allows you to specify partial ARN (for example, account-id:Thumbnail). - // Note that the length constraint applies only to the ARN. If you specify only - // the function name, it is limited to 64 characters in length. + // * Partial ARN - 123456789012:function:MyFunction. + // + // The length constraint applies only to the full ARN. If you specify only the + // function name, it is limited to 64 characters in length. // // FunctionName is a required field FunctionName *string `location:"uri" locationName:"FunctionName" min:"1" type:"string" required:"true"` - // The principal who is getting this permission. It can be Amazon S3 service - // Principal (s3.amazonaws.com) if you want Amazon S3 to invoke the function, - // an AWS account ID if you are granting cross-account permission, or any valid - // AWS service principal such as sns.amazonaws.com. For example, you might want - // to allow a custom application in another AWS account to push events to AWS - // Lambda by invoking your function. + // The principal who is getting this permission. The principal can be an AWS + // service (e.g. s3.amazonaws.com or sns.amazonaws.com) for service triggers, + // or an account ID for cross-account access. If you specify a service as a + // principal, use the SourceArn parameter to limit who can invoke the function + // through that service. // // Principal is a required field Principal *string `type:"string" required:"true"` - // You can use this optional query parameter to describe a qualified ARN using - // a function version or an alias name. The permission will then apply to the - // specific qualified ARN. For example, if you specify function version 2 as - // the qualifier, then permission applies only when request is made using qualified - // function ARN: - // - // arn:aws:lambda:aws-region:acct-id:function:function-name:2 - // - // If you specify an alias name, for example PROD, then the permission is valid - // only for requests made using the alias ARN: - // - // arn:aws:lambda:aws-region:acct-id:function:function-name:PROD - // - // If the qualifier is not specified, the permission is valid only when requests - // is made using unqualified function ARN. - // - // arn:aws:lambda:aws-region:acct-id:function:function-name + // Specify a version or alias to add permissions to a published version of the + // function. Qualifier *string `location:"querystring" locationName:"Qualifier" min:"1" type:"string"` // An optional value you can use to ensure you are updating the latest update // of the function version or alias. If the RevisionID you pass doesn't match // the latest RevisionId of the function or alias, it will fail with an error // message, advising you to retrieve the latest function version or alias RevisionID - // using either or . + // using either GetFunction or GetAlias RevisionId *string `type:"string"` // This parameter is used for S3 and SES. The AWS account ID (without a hyphen) @@ -3364,14 +3354,11 @@ type AddPermissionInput struct { // you don't specify the SourceArn) owned by a specific account. SourceAccount *string `type:"string"` - // This is optional; however, when granting permission to invoke your function, - // you should specify this field with the Amazon Resource Name (ARN) as its - // value. This ensures that only events generated from the specified source - // can invoke the function. + // The Amazon Resource Name of the invoker. // - // If you add a permission without providing the source ARN, any AWS account - // that creates a mapping to your function ARN can send events to invoke your - // Lambda function. + // If you add a permission to a service principal without providing the source + // ARN, any AWS account that creates a mapping to your function ARN can invoke + // your Lambda function. SourceArn *string `type:"string"` // A unique statement identifier. @@ -3522,8 +3509,7 @@ type AliasConfiguration struct { RevisionId *string `type:"string"` // Specifies an additional function versions the alias points to, allowing you - // to dictate what percentage of traffic will invoke each version. For more - // information, see lambda-traffic-shifting-using-aliases. + // to dictate what percentage of traffic will invoke each version. RoutingConfig *AliasRoutingConfiguration `type:"structure"` } @@ -3573,14 +3559,13 @@ func (s *AliasConfiguration) SetRoutingConfig(v *AliasRoutingConfiguration) *Ali return s } -// The parent object that implements what percentage of traffic will invoke -// each function version. For more information, see lambda-traffic-shifting-using-aliases. +// The alias's traffic shifting (http://docs.aws.amazon.com/lambda/latest/dg/lambda-traffic-shifting-using-aliases.html) +// configuration. type AliasRoutingConfiguration struct { _ struct{} `type:"structure"` - // Set this value to dictate what percentage of traffic will invoke the updated - // function version. If set to an empty string, 100 percent of traffic will - // invoke function-version. For more information, see lambda-traffic-shifting-using-aliases. + // The name of the second alias, and the percentage of traffic that is routed + // to it. AdditionalVersionWeights map[string]*float64 `type:"map"` } @@ -3606,9 +3591,18 @@ type CreateAliasInput struct { // Description of the alias. Description *string `type:"string"` - // Name of the Lambda function for which you want to create an alias. Note that - // the length constraint applies only to the ARN. If you specify only the function - // name, it is limited to 64 characters in length. + // The name of the lambda function. + // + // Name formats + // + // * Function name - MyFunction. + // + // * Function ARN - arn:aws:lambda:us-west-2:123456789012:function:MyFunction. + // + // * Partial ARN - 123456789012:function:MyFunction. + // + // The length constraint applies only to the full ARN. If you specify only the + // function name, it is limited to 64 characters in length. // // FunctionName is a required field FunctionName *string `location:"uri" locationName:"FunctionName" min:"1" type:"string" required:"true"` @@ -3625,7 +3619,7 @@ type CreateAliasInput struct { // Specifies an additional version your alias can point to, allowing you to // dictate what percentage of traffic will invoke each version. For more information, - // see lambda-traffic-shifting-using-aliases. + // see Traffic Shifting Using Aliases (http://docs.aws.amazon.com/lambda/latest/dg/lambda-traffic-shifting-using-aliases.html). RoutingConfig *AliasRoutingConfiguration `type:"structure"` } @@ -3703,36 +3697,32 @@ type CreateEventSourceMappingInput struct { // The largest number of records that AWS Lambda will retrieve from your event // source at the time of invoking your function. Your function receives an event // with all the retrieved records. The default for Amazon Kinesis and Amazon - // DynamoDB is 100 records. For SQS, the default is 1. + // DynamoDB is 100 records. Both the default and maximum for Amazon SQS are + // 10 messages. BatchSize *int64 `min:"1" type:"integer"` - // Indicates whether AWS Lambda should begin polling the event source. By default, - // Enabled is true. + // Set to false to disable the event source upon creation. Enabled *bool `type:"boolean"` - // The Amazon Resource Name (ARN) of the event source. Any record added to this - // source could cause AWS Lambda to invoke your Lambda function, it depends - // on the BatchSize. AWS Lambda POSTs the event's records to your Lambda function - // as JSON. + // The Amazon Resource Name (ARN) of the event source. // // EventSourceArn is a required field EventSourceArn *string `type:"string" required:"true"` - // The Lambda function to invoke when AWS Lambda detects an event on the stream. + // The name of the lambda function. + // + // Name formats + // + // * Function name - MyFunction. // - // You can specify the function name (for example, Thumbnail) or you can specify - // Amazon Resource Name (ARN) of the function (for example, arn:aws:lambda:us-west-2:account-id:function:ThumbNail). + // * Function ARN - arn:aws:lambda:us-west-2:123456789012:function:MyFunction. // - // If you are using versioning, you can also provide a qualified function ARN - // (ARN that is qualified with function version or alias name as suffix). For - // more information about versioning, see AWS Lambda Function Versioning and - // Aliases (http://docs.aws.amazon.com/lambda/latest/dg/versioning-aliases.html) + // * Version or Alias ARN - arn:aws:lambda:us-west-2:123456789012:function:MyFunction:PROD. // - // AWS Lambda also allows you to specify only the function name with the account - // ID qualifier (for example, account-id:Thumbnail). + // * Partial ARN - 123456789012:function:MyFunction. // - // Note that the length constraint applies only to the ARN. If you specify only - // the function name, it is limited to 64 characters in length. + // The length constraint applies only to the full ARN. If you specify only the + // function name, it is limited to 64 characters in length. // // FunctionName is a required field FunctionName *string `min:"1" type:"string" required:"true"` @@ -3824,76 +3814,62 @@ func (s *CreateEventSourceMappingInput) SetStartingPositionTimestamp(v time.Time type CreateFunctionInput struct { _ struct{} `type:"structure"` - // The code for the Lambda function. + // The code for the function. // // Code is a required field Code *FunctionCode `type:"structure" required:"true"` - // The parent object that contains the target ARN (Amazon Resource Name) of - // an Amazon SQS queue or Amazon SNS topic. For more information, see dlq. + // A dead letter queue configuration that specifies the queue or topic where + // Lambda sends asynchronous events when they fail processing. For more information, + // see Dead Letter Queues (http://docs.aws.amazon.com/lambda/latest/dg/dlq.html). DeadLetterConfig *DeadLetterConfig `type:"structure"` - // A short, user-defined function description. Lambda does not use this value. - // Assign a meaningful description as you see fit. + // A description of the function. Description *string `type:"string"` - // The parent object that contains your environment's configuration settings. + // Environment variables that are accessible from function code during execution. Environment *Environment `type:"structure"` - // The name you want to assign to the function you are uploading. The function - // names appear in the console and are returned in the ListFunctions API. Function - // names are used to specify functions to other AWS Lambda API operations, such - // as Invoke. Note that the length constraint applies only to the ARN. If you - // specify only the function name, it is limited to 64 characters in length. + // The name of the lambda function. + // + // Name formats + // + // * Function name - MyFunction. + // + // * Function ARN - arn:aws:lambda:us-west-2:123456789012:function:MyFunction. + // + // * Partial ARN - 123456789012:function:MyFunction. + // + // The length constraint applies only to the full ARN. If you specify only the + // function name, it is limited to 64 characters in length. // // FunctionName is a required field FunctionName *string `min:"1" type:"string" required:"true"` - // The function within your code that Lambda calls to begin execution. For Node.js, - // it is the module-name.export value in your function. For Java, it can be - // package.class-name::handler or package.class-name. For more information, - // see Lambda Function Handler (Java) (http://docs.aws.amazon.com/lambda/latest/dg/java-programming-model-handler-types.html). + // The name of the method within your code that Lambda calls to execute your + // function. For more information, see Programming Model (http://docs.aws.amazon.com/lambda/latest/dg/programming-model-v2.html). // // Handler is a required field Handler *string `type:"string" required:"true"` - // The Amazon Resource Name (ARN) of the KMS key used to encrypt your function's - // environment variables. If not provided, AWS Lambda will use a default service - // key. + // The ARN of the KMS key used to encrypt your function's environment variables. + // If not provided, AWS Lambda will use a default service key. KMSKeyArn *string `type:"string"` - // The amount of memory, in MB, your Lambda function is given. Lambda uses this - // memory size to infer the amount of CPU and memory allocated to your function. - // Your function use-case determines your CPU and memory requirements. For example, - // a database operation might need less memory compared to an image processing - // function. The default value is 128 MB. The value must be a multiple of 64 - // MB. + // The amount of memory that your function has access to. Increasing the function's + // memory also increases it's CPU allocation. The default value is 128 MB. The + // value must be a multiple of 64 MB. MemorySize *int64 `min:"128" type:"integer"` - // This boolean parameter can be used to request AWS Lambda to create the Lambda - // function and publish a version as an atomic operation. + // Set to true to publish the first version of the function during creation. Publish *bool `type:"boolean"` - // The Amazon Resource Name (ARN) of the IAM role that Lambda assumes when it - // executes your function to access any other Amazon Web Services (AWS) resources. - // For more information, see AWS Lambda: How it Works (http://docs.aws.amazon.com/lambda/latest/dg/lambda-introduction.html). + // The Amazon Resource Name (ARN) of the function's execution role (http://docs.aws.amazon.com/lambda/latest/dg/intro-permission-model.html#lambda-intro-execution-role). // // Role is a required field Role *string `type:"string" required:"true"` - // The runtime environment for the Lambda function you are uploading. - // - // To use the Python runtime v3.6, set the value to "python3.6". To use the - // Python runtime v2.7, set the value to "python2.7". To use the Node.js runtime - // v6.10, set the value to "nodejs6.10". To use the Node.js runtime v4.3, set - // the value to "nodejs4.3". To use the .NET Core runtime v1.0, set the value - // to "dotnetcore1.0". To use the .NET Core runtime v2.0, set the value to "dotnetcore2.0". - // - // Node v0.10.42 is currently marked as deprecated. You must migrate existing - // functions to the newer Node.js runtime versions available on AWS Lambda (nodejs4.3 - // or nodejs6.10) as soon as possible. Failure to do so will result in an invalid - // parameter error being returned. Note that you will have to follow this procedure - // for each region that contains functions written in the Node v0.10.42 runtime. + // The runtime version for the function. // // Runtime is a required field Runtime *string `type:"string" required:"true" enum:"Runtime"` @@ -3903,12 +3879,12 @@ type CreateFunctionInput struct { // in the AWS Lambda Developer Guide. Tags map[string]*string `type:"map"` - // The function execution time at which Lambda should terminate the function. - // Because the execution time has cost implications, we recommend you set this - // value based on your expected execution time. The default is 3 seconds. + // The amount of time that Lambda allows a function to run before terminating + // it. The default is 3 seconds. The maximum allowed value is 900 seconds. Timeout *int64 `min:"1" type:"integer"` - // The parent object that contains your function's tracing settings. + // Set Mode to Active to sample and trace a subset of incoming requests with + // AWS X-Ray. TracingConfig *TracingConfig `type:"structure"` // If your Lambda function accesses resources in a VPC, you provide this parameter @@ -4057,14 +4033,12 @@ func (s *CreateFunctionInput) SetVpcConfig(v *VpcConfig) *CreateFunctionInput { return s } -// The Amazon Resource Name (ARN) of an Amazon SQS queue or Amazon SNS topic -// you specify as your Dead Letter Queue (DLQ). For more information, see dlq. +// The dead letter queue (http://docs.aws.amazon.com/lambda/latest/dg/dlq.html) +// for failed asynchronous invocations. type DeadLetterConfig struct { _ struct{} `type:"structure"` - // The Amazon Resource Name (ARN) of an Amazon SQS queue or Amazon SNS topic - // you specify as your Dead Letter Queue (DLQ). dlq. For more information, see - // dlq. + // The Amazon Resource Name (ARN) of an Amazon SQS queue or Amazon SNS topic. TargetArn *string `type:"string"` } @@ -4087,10 +4061,18 @@ func (s *DeadLetterConfig) SetTargetArn(v string) *DeadLetterConfig { type DeleteAliasInput struct { _ struct{} `type:"structure"` - // The Lambda function name for which the alias is created. Deleting an alias - // does not delete the function version to which it is pointing. Note that the - // length constraint applies only to the ARN. If you specify only the function - // name, it is limited to 64 characters in length. + // The name of the lambda function. + // + // Name formats + // + // * Function name - MyFunction. + // + // * Function ARN - arn:aws:lambda:us-west-2:123456789012:function:MyFunction. + // + // * Partial ARN - 123456789012:function:MyFunction. + // + // The length constraint applies only to the full ARN. If you specify only the + // function name, it is limited to 64 characters in length. // // FunctionName is a required field FunctionName *string `location:"uri" locationName:"FunctionName" min:"1" type:"string" required:"true"` @@ -4200,8 +4182,18 @@ func (s *DeleteEventSourceMappingInput) SetUUID(v string) *DeleteEventSourceMapp type DeleteFunctionConcurrencyInput struct { _ struct{} `type:"structure"` - // The name of the function you are removing concurrent execution limits from. - // For more information, see concurrent-executions. + // The name of the lambda function. + // + // Name formats + // + // * Function name - MyFunction. + // + // * Function ARN - arn:aws:lambda:us-west-2:123456789012:function:MyFunction. + // + // * Partial ARN - 123456789012:function:MyFunction. + // + // The length constraint applies only to the full ARN. If you specify only the + // function name, it is limited to 64 characters in length. // // FunctionName is a required field FunctionName *string `location:"uri" locationName:"FunctionName" min:"1" type:"string" required:"true"` @@ -4256,33 +4248,24 @@ func (s DeleteFunctionConcurrencyOutput) GoString() string { type DeleteFunctionInput struct { _ struct{} `type:"structure"` - // The Lambda function to delete. + // The name of the lambda function. // - // You can specify the function name (for example, Thumbnail) or you can specify - // Amazon Resource Name (ARN) of the function (for example, arn:aws:lambda:us-west-2:account-id:function:ThumbNail). - // If you are using versioning, you can also provide a qualified function ARN - // (ARN that is qualified with function version or alias name as suffix). AWS - // Lambda also allows you to specify only the function name with the account - // ID qualifier (for example, account-id:Thumbnail). Note that the length constraint - // applies only to the ARN. If you specify only the function name, it is limited - // to 64 characters in length. + // Name formats + // + // * Function name - MyFunction. + // + // * Function ARN - arn:aws:lambda:us-west-2:123456789012:function:MyFunction. + // + // * Partial ARN - 123456789012:function:MyFunction. + // + // The length constraint applies only to the full ARN. If you specify only the + // function name, it is limited to 64 characters in length. // // FunctionName is a required field FunctionName *string `location:"uri" locationName:"FunctionName" min:"1" type:"string" required:"true"` - // Using this optional parameter you can specify a function version (but not - // the $LATEST version) to direct AWS Lambda to delete a specific function version. - // If the function version has one or more aliases pointing to it, you will - // get an error because you cannot have aliases pointing to it. You can delete - // any function version but not the $LATEST, that is, you cannot specify $LATEST - // as the value of this parameter. The $LATEST version can be deleted only when - // you want to delete all the function versions and aliases. - // - // You can only specify a function version, not an alias name, using this parameter. - // You cannot delete a function version using its alias. - // - // If you don't specify this parameter, AWS Lambda will delete the function, - // including all of its versions and aliases. + // Specify a version to delete. You cannot delete a version that is referenced + // by an alias. Qualifier *string `location:"querystring" locationName:"Qualifier" min:"1" type:"string"` } @@ -4341,11 +4324,11 @@ func (s DeleteFunctionOutput) GoString() string { return s.String() } -// The parent object that contains your environment's configuration settings. +// A function's environment variable settings. type Environment struct { _ struct{} `type:"structure"` - // The key-value pairs that represent your environment's configuration settings. + // Environment variable key-value pairs. Variables map[string]*string `type:"map"` } @@ -4365,15 +4348,14 @@ func (s *Environment) SetVariables(v map[string]*string) *Environment { return s } -// The parent object that contains error information associated with your configuration -// settings. +// Error messages for environment variables that could not be applied. type EnvironmentError struct { _ struct{} `type:"structure"` - // The error code returned by the environment error object. + // The error code. ErrorCode *string `type:"string"` - // The message returned by the environment error object. + // The error message. Message *string `type:"string"` } @@ -4399,17 +4381,14 @@ func (s *EnvironmentError) SetMessage(v string) *EnvironmentError { return s } -// The parent object returned that contains your environment's configuration -// settings or any error information associated with your configuration settings. +// The results of a configuration update that applied environment variables. type EnvironmentResponse struct { _ struct{} `type:"structure"` - // The parent object that contains error information associated with your configuration - // settings. + // Error messages for environment variables that could not be applied. Error *EnvironmentError `type:"structure"` - // The key-value pairs returned that represent your environment's configuration - // settings or error information. + // Environment variable key-value pairs. Variables map[string]*string `type:"map"` } @@ -4435,8 +4414,8 @@ func (s *EnvironmentResponse) SetVariables(v map[string]*string) *EnvironmentRes return s } -// Describes mapping between an Amazon Kinesis or DynamoDB stream or an Amazon -// SQS queue and a Lambda function. +// Describes mapping between an Amazon Kinesis or DynamoDB stream and a Lambda +// function. type EventSourceMappingConfiguration struct { _ struct{} `type:"structure"` @@ -4445,8 +4424,8 @@ type EventSourceMappingConfiguration struct { // with all the retrieved records. BatchSize *int64 `min:"1" type:"integer"` - // The Amazon Resource Name (ARN) of the Amazon Kinesis or DynamoDB stream or - // the SQS queue that is the source of events. + // The Amazon Resource Name (ARN) of the Amazon Kinesis or DynamoDB stream that + // is the source of events. EventSourceArn *string `type:"string"` // The Lambda function to invoke when AWS Lambda detects an event on the poll-based @@ -4456,7 +4435,8 @@ type EventSourceMappingConfiguration struct { // The UTC time string indicating the last time the event mapping was updated. LastModified *time.Time `type:"timestamp"` - // The result of the last AWS Lambda invocation of your Lambda function. + // The result of the last AWS Lambda invocation of your Lambda function. This + // value will be null if an SQS queue is the event source. LastProcessingResult *string `type:"string"` // The state of the event source mapping. It can be Creating, Enabled, Disabled, @@ -4529,27 +4509,22 @@ func (s *EventSourceMappingConfiguration) SetUUID(v string) *EventSourceMappingC return s } -// The code for the Lambda function. +// The code for the Lambda function. You can specify either an S3 location, +// or upload a deployment package directly. type FunctionCode struct { _ struct{} `type:"structure"` - // Amazon S3 bucket name where the .zip file containing your deployment package - // is stored. This bucket must reside in the same AWS region where you are creating - // the Lambda function. + // An Amazon S3 bucket in the same region as your function. S3Bucket *string `min:"3" type:"string"` - // The Amazon S3 object (the deployment package) key name you want to upload. + // The Amazon S3 key of the deployment package. S3Key *string `min:"1" type:"string"` - // The Amazon S3 object (the deployment package) version you want to upload. + // For versioned objects, the version of the deployment package object to use. S3ObjectVersion *string `min:"1" type:"string"` - // The contents of your zip file containing your deployment package. If you - // are using the web API directly, the contents of the zip file must be base64-encoded. - // If you are using the AWS SDKs or the AWS CLI, the SDKs or CLI will do the - // encoding for you. For more information about creating a .zip file, see Execution - // Permissions (http://docs.aws.amazon.com/lambda/latest/dg/intro-permission-model.html#lambda-intro-execution-role.html) - // in the AWS Lambda Developer Guide. + // The base64-encoded contents of your zip file containing your deployment package. + // AWS SDK and AWS CLI clients handle the encoding for you. // // ZipFile is automatically base64 encoded/decoded by the SDK. ZipFile []byte `type:"blob"` @@ -4642,77 +4617,68 @@ func (s *FunctionCodeLocation) SetRepositoryType(v string) *FunctionCodeLocation return s } -// A complex type that describes function metadata. +// A Lambda function's configuration settings. type FunctionConfiguration struct { _ struct{} `type:"structure"` - // It is the SHA256 hash of your function deployment package. + // The SHA256 hash of the function's deployment package. CodeSha256 *string `type:"string"` - // The size, in bytes, of the function .zip file you uploaded. + // The size of the function's deployment package in bytes. CodeSize *int64 `type:"long"` - // The parent object that contains the target ARN (Amazon Resource Name) of - // an Amazon SQS queue or Amazon SNS topic. For more information, see dlq. + // The function's dead letter queue. DeadLetterConfig *DeadLetterConfig `type:"structure"` - // The user-provided description. + // The function's description. Description *string `type:"string"` - // The parent object that contains your environment's configuration settings. + // The function's environment variables. Environment *EnvironmentResponse `type:"structure"` - // The Amazon Resource Name (ARN) assigned to the function. + // The function's Amazon Resource Name. FunctionArn *string `type:"string"` - // The name of the function. Note that the length constraint applies only to - // the ARN. If you specify only the function name, it is limited to 64 characters - // in length. + // The name of the function. FunctionName *string `min:"1" type:"string"` // The function Lambda calls to begin executing your function. Handler *string `type:"string"` - // The Amazon Resource Name (ARN) of the KMS key used to encrypt your function's - // environment variables. If empty, it means you are using the AWS Lambda default - // service key. + // The KMS key used to encrypt the function's environment variables. Only returned + // if you've configured a customer managed CMK. KMSKeyArn *string `type:"string"` - // The time stamp of the last time you updated the function. The time stamp - // is conveyed as a string complying with ISO-8601 in this way YYYY-MM-DDThh:mm:ssTZD - // (e.g., 1997-07-16T19:20:30+01:00). For more information, see Date and Time - // Formats (https://www.w3.org/TR/NOTE-datetime). + // The date and time that the function was last updated, in ISO-8601 format + // (https://www.w3.org/TR/NOTE-datetime) (YYYY-MM-DDThh:mm:ssTZD). LastModified *string `type:"string"` - // Returns the ARN (Amazon Resource Name) of the master function. + // The ARN of the master function. MasterArn *string `type:"string"` - // The memory size, in MB, you configured for the function. Must be a multiple - // of 64 MB. + // The memory allocated to the function MemorySize *int64 `min:"128" type:"integer"` // Represents the latest updated revision of the function or alias. RevisionId *string `type:"string"` - // The Amazon Resource Name (ARN) of the IAM role that Lambda assumes when it - // executes your function to access any other Amazon Web Services (AWS) resources. + // The function's execution role. Role *string `type:"string"` // The runtime environment for the Lambda function. Runtime *string `type:"string" enum:"Runtime"` - // The function execution time at which Lambda should terminate the function. - // Because the execution time has cost implications, we recommend you set this - // value based on your expected execution time. The default is 3 seconds. + // The amount of time that Lambda allows a function to run before terminating + // it. Timeout *int64 `min:"1" type:"integer"` - // The parent object that contains your function's tracing settings. + // The function's AWS X-Ray tracing configuration. TracingConfig *TracingConfigResponse `type:"structure"` // The version of the Lambda function. Version *string `min:"1" type:"string"` - // VPC configuration associated with your Lambda function. + // The function's networking configuration. VpcConfig *VpcConfigResponse `type:"structure"` } @@ -4857,12 +4823,10 @@ func (s GetAccountSettingsInput) GoString() string { type GetAccountSettingsOutput struct { _ struct{} `type:"structure"` - // Provides limits of code size and concurrency associated with the current - // account and region. + // Limits related to concurrency and code storage. AccountLimit *AccountLimit `type:"structure"` - // Provides code size usage and function count associated with the current account - // and region. + // The number of functions and amount of storage in use. AccountUsage *AccountUsage `type:"structure"` } @@ -4891,11 +4855,18 @@ func (s *GetAccountSettingsOutput) SetAccountUsage(v *AccountUsage) *GetAccountS type GetAliasInput struct { _ struct{} `type:"structure"` - // Function name for which the alias is created. An alias is a subresource that - // exists only in the context of an existing Lambda function so you must specify - // the function name. Note that the length constraint applies only to the ARN. - // If you specify only the function name, it is limited to 64 characters in - // length. + // The name of the lambda function. + // + // Name formats + // + // * Function name - MyFunction. + // + // * Function ARN - arn:aws:lambda:us-west-2:123456789012:function:MyFunction. + // + // * Partial ARN - 123456789012:function:MyFunction. + // + // The length constraint applies only to the full ARN. If you specify only the + // function name, it is limited to 64 characters in length. // // FunctionName is a required field FunctionName *string `location:"uri" locationName:"FunctionName" min:"1" type:"string" required:"true"` @@ -4991,26 +4962,24 @@ func (s *GetEventSourceMappingInput) SetUUID(v string) *GetEventSourceMappingInp type GetFunctionConfigurationInput struct { _ struct{} `type:"structure"` - // The name of the Lambda function for which you want to retrieve the configuration - // information. + // The name of the lambda function. // - // You can specify a function name (for example, Thumbnail) or you can specify - // Amazon Resource Name (ARN) of the function (for example, arn:aws:lambda:us-west-2:account-id:function:ThumbNail). - // AWS Lambda also allows you to specify a partial ARN (for example, account-id:Thumbnail). - // Note that the length constraint applies only to the ARN. If you specify only - // the function name, it is limited to 64 characters in length. + // Name formats + // + // * Function name - MyFunction. + // + // * Function ARN - arn:aws:lambda:us-west-2:123456789012:function:MyFunction. + // + // * Partial ARN - 123456789012:function:MyFunction. + // + // The length constraint applies only to the full ARN. If you specify only the + // function name, it is limited to 64 characters in length. // // FunctionName is a required field FunctionName *string `location:"uri" locationName:"FunctionName" min:"1" type:"string" required:"true"` - // Using this optional parameter you can specify a function version or an alias - // name. If you specify function version, the API uses qualified function ARN - // and returns information about the specific function version. If you specify - // an alias name, the API uses the alias ARN and returns information about the - // function version to which the alias points. - // - // If you don't specify this parameter, the API uses unqualified function ARN, - // and returns information about the $LATEST function version. + // Specify a version or alias to get details about a published version of the + // function. Qualifier *string `location:"querystring" locationName:"Qualifier" min:"1" type:"string"` } @@ -5058,24 +5027,24 @@ func (s *GetFunctionConfigurationInput) SetQualifier(v string) *GetFunctionConfi type GetFunctionInput struct { _ struct{} `type:"structure"` - // The Lambda function name. + // The name of the lambda function. + // + // Name formats // - // You can specify a function name (for example, Thumbnail) or you can specify - // Amazon Resource Name (ARN) of the function (for example, arn:aws:lambda:us-west-2:account-id:function:ThumbNail). - // AWS Lambda also allows you to specify a partial ARN (for example, account-id:Thumbnail). - // Note that the length constraint applies only to the ARN. If you specify only - // the function name, it is limited to 64 characters in length. + // * Function name - MyFunction. + // + // * Function ARN - arn:aws:lambda:us-west-2:123456789012:function:MyFunction. + // + // * Partial ARN - 123456789012:function:MyFunction. + // + // The length constraint applies only to the full ARN. If you specify only the + // function name, it is limited to 64 characters in length. // // FunctionName is a required field FunctionName *string `location:"uri" locationName:"FunctionName" min:"1" type:"string" required:"true"` - // Use this optional parameter to specify a function version or an alias name. - // If you specify function version, the API uses qualified function ARN for - // the request and returns information about the specific Lambda function version. - // If you specify an alias name, the API uses the alias ARN and returns information - // about the function version to which the alias points. If you don't provide - // this parameter, the API uses unqualified function ARN and returns information - // about the $LATEST version of the Lambda function. + // Specify a version or alias to get details about a published version of the + // function. Qualifier *string `location:"querystring" locationName:"Qualifier" min:"1" type:"string"` } @@ -5124,14 +5093,14 @@ func (s *GetFunctionInput) SetQualifier(v string) *GetFunctionInput { type GetFunctionOutput struct { _ struct{} `type:"structure"` - // The object for the Lambda function location. + // The function's code. Code *FunctionCodeLocation `type:"structure"` // The concurrent execution limit set for this function. For more information, - // see concurrent-executions. + // see Managing Concurrency (http://docs.aws.amazon.com/lambda/latest/dg/concurrent-executions.html). Concurrency *PutFunctionConcurrencyOutput `type:"structure"` - // A complex type that describes function metadata. + // The function's configuration. Configuration *FunctionConfiguration `type:"structure"` // Returns the list of tags associated with the function. For more information, @@ -5177,16 +5146,18 @@ func (s *GetFunctionOutput) SetTags(v map[string]*string) *GetFunctionOutput { type GetPolicyInput struct { _ struct{} `type:"structure"` - // Function name whose resource policy you want to retrieve. + // The name of the lambda function. + // + // Name formats + // + // * Function name - MyFunction. // - // You can specify the function name (for example, Thumbnail) or you can specify - // Amazon Resource Name (ARN) of the function (for example, arn:aws:lambda:us-west-2:account-id:function:ThumbNail). - // If you are using versioning, you can also provide a qualified function ARN - // (ARN that is qualified with function version or alias name as suffix). AWS - // Lambda also allows you to specify only the function name with the account - // ID qualifier (for example, account-id:Thumbnail). Note that the length constraint - // applies only to the ARN. If you specify only the function name, it is limited - // to 64 characters in length. + // * Function ARN - arn:aws:lambda:us-west-2:123456789012:function:MyFunction. + // + // * Partial ARN - 123456789012:function:MyFunction. + // + // The length constraint applies only to the full ARN. If you specify only the + // function name, it is limited to 64 characters in length. // // FunctionName is a required field FunctionName *string `location:"uri" locationName:"FunctionName" min:"1" type:"string" required:"true"` @@ -5277,9 +5248,18 @@ func (s *GetPolicyOutput) SetRevisionId(v string) *GetPolicyOutput { type InvokeAsyncInput struct { _ struct{} `deprecated:"true" type:"structure" payload:"InvokeArgs"` - // The Lambda function name. Note that the length constraint applies only to - // the ARN. If you specify only the function name, it is limited to 64 characters - // in length. + // The name of the lambda function. + // + // Name formats + // + // * Function name - MyFunction. + // + // * Function ARN - arn:aws:lambda:us-west-2:123456789012:function:MyFunction. + // + // * Partial ARN - 123456789012:function:MyFunction. + // + // The length constraint applies only to the full ARN. If you specify only the + // function name, it is limited to 64 characters in length. // // FunctionName is a required field FunctionName *string `location:"uri" locationName:"FunctionName" min:"1" type:"string" required:"true"` @@ -5368,26 +5348,37 @@ type InvokeInput struct { // // The ClientContext JSON must be base64-encoded and has a maximum size of 3583 // bytes. + // + // ClientContext information is returned only if you use the synchronous (RequestResponse) + // invocation type. ClientContext *string `location:"header" locationName:"X-Amz-Client-Context" type:"string"` - // The Lambda function name. + // The name of the lambda function. + // + // Name formats + // + // * Function name - MyFunction. + // + // * Function ARN - arn:aws:lambda:us-west-2:123456789012:function:MyFunction. // - // You can specify a function name (for example, Thumbnail) or you can specify - // Amazon Resource Name (ARN) of the function (for example, arn:aws:lambda:us-west-2:account-id:function:ThumbNail). - // AWS Lambda also allows you to specify a partial ARN (for example, account-id:Thumbnail). - // Note that the length constraint applies only to the ARN. If you specify only - // the function name, it is limited to 64 characters in length. + // * Partial ARN - 123456789012:function:MyFunction. + // + // The length constraint applies only to the full ARN. If you specify only the + // function name, it is limited to 64 characters in length. // // FunctionName is a required field FunctionName *string `location:"uri" locationName:"FunctionName" min:"1" type:"string" required:"true"` - // By default, the Invoke API assumes RequestResponse invocation type. You can - // optionally request asynchronous execution by specifying Event as the InvocationType. - // You can also use this parameter to request AWS Lambda to not execute the - // function but do some verification, such as if the caller is authorized to - // invoke the function and if the inputs are valid. You request this by specifying - // DryRun as the InvocationType. This is useful in a cross-account scenario - // when you want to verify access to a function without running it. + // Choose from the following options. + // + // * RequestResponse (default) - Invoke the function synchronously. Keep + // the connection open until the function returns a response or times out. + // + // * Event - Invoke the function asynchronously. Send events that fail multiple + // times to the function's dead-letter queue (if configured). + // + // * DryRun - Validate parameter values and verify that the user or role + // has permission to invoke the function. InvocationType *string `location:"header" locationName:"X-Amz-Invocation-Type" type:"string" enum:"InvocationType"` // You can set this optional parameter to Tail in the request only if you specify @@ -5399,14 +5390,7 @@ type InvokeInput struct { // JSON that you want to provide to your Lambda function as input. Payload []byte `type:"blob"` - // You can use this optional parameter to specify a Lambda function version - // or alias name. If you specify a function version, the API uses the qualified - // function ARN to invoke a specific Lambda function. If you specify an alias - // name, the API uses the alias ARN to invoke the Lambda function version to - // which the alias points. - // - // If you don't provide this parameter, then the API uses unqualified function - // ARN which results in invocation of the $LATEST version. + // Specify a version or alias to invoke a published version of the function. Qualifier *string `location:"querystring" locationName:"Qualifier" min:"1" type:"string"` } @@ -5480,7 +5464,8 @@ type InvokeOutput struct { _ struct{} `type:"structure" payload:"Payload"` // The function version that has been executed. This value is returned only - // if the invocation type is RequestResponse. For more information, see lambda-traffic-shifting-using-aliases. + // if the invocation type is RequestResponse. For more information, see Traffic + // Shifting Using Aliases (http://docs.aws.amazon.com/lambda/latest/dg/lambda-traffic-shifting-using-aliases.html). ExecutedVersion *string `location:"header" locationName:"X-Amz-Executed-Version" min:"1" type:"string"` // Indicates whether an error occurred while executing the Lambda function. @@ -5554,9 +5539,18 @@ func (s *InvokeOutput) SetStatusCode(v int64) *InvokeOutput { type ListAliasesInput struct { _ struct{} `type:"structure"` - // Lambda function name for which the alias is created. Note that the length - // constraint applies only to the ARN. If you specify only the function name, - // it is limited to 64 characters in length. + // The name of the lambda function. + // + // Name formats + // + // * Function name - MyFunction. + // + // * Function ARN - arn:aws:lambda:us-west-2:123456789012:function:MyFunction. + // + // * Partial ARN - 123456789012:function:MyFunction. + // + // The length constraint applies only to the full ARN. If you specify only the + // function name, it is limited to 64 characters in length. // // FunctionName is a required field FunctionName *string `location:"uri" locationName:"FunctionName" min:"1" type:"string" required:"true"` @@ -5666,20 +5660,24 @@ func (s *ListAliasesOutput) SetNextMarker(v string) *ListAliasesOutput { type ListEventSourceMappingsInput struct { _ struct{} `type:"structure"` - // The Amazon Resource Name (ARN) of the Amazon Kinesis or DynamoDB stream, - // or an SQS queue. (This parameter is optional.) + // The Amazon Resource Name (ARN) of the Amazon Kinesis or DynamoDB stream. + // (This parameter is optional.) EventSourceArn *string `location:"querystring" locationName:"EventSourceArn" type:"string"` - // The name of the Lambda function. + // The name of the lambda function. + // + // Name formats // - // You can specify the function name (for example, Thumbnail) or you can specify - // Amazon Resource Name (ARN) of the function (for example, arn:aws:lambda:us-west-2:account-id:function:ThumbNail). - // If you are using versioning, you can also provide a qualified function ARN - // (ARN that is qualified with function version or alias name as suffix). AWS - // Lambda also allows you to specify only the function name with the account - // ID qualifier (for example, account-id:Thumbnail). Note that the length constraint - // applies only to the ARN. If you specify only the function name, it is limited - // to 64 characters in length. + // * Function name - MyFunction. + // + // * Function ARN - arn:aws:lambda:us-west-2:123456789012:function:MyFunction. + // + // * Version or Alias ARN - arn:aws:lambda:us-west-2:123456789012:function:MyFunction:PROD. + // + // * Partial ARN - 123456789012:function:MyFunction. + // + // The length constraint applies only to the full ARN. If you specify only the + // function name, it is limited to 64 characters in length. FunctionName *string `location:"querystring" locationName:"FunctionName" min:"1" type:"string"` // Optional string. An opaque pagination token returned from a previous ListEventSourceMappings @@ -5778,33 +5776,22 @@ func (s *ListEventSourceMappingsOutput) SetNextMarker(v string) *ListEventSource type ListFunctionsInput struct { _ struct{} `type:"structure"` - // Optional string. If not specified, only the unqualified functions ARNs (Amazon - // Resource Names) will be returned. - // - // Valid value: - // - // ALL: Will return all versions, including $LATEST which will have fully qualified - // ARNs (Amazon Resource Names). + // Set to ALL to list all published versions. If not specified, only the latest + // unpublished version ARN is returned. FunctionVersion *string `location:"querystring" locationName:"FunctionVersion" type:"string" enum:"FunctionVersion"` // Optional string. An opaque pagination token returned from a previous ListFunctions // operation. If present, indicates where to continue the listing. Marker *string `location:"querystring" locationName:"Marker" type:"string"` - // Optional string. If not specified, will return only regular function versions - // (i.e., non-replicated versions). - // - // Valid values are: - // - // The region from which the functions are replicated. For example, if you specify - // us-east-1, only functions replicated from that region will be returned. - // - // ALL: Will return all functions from any region. If specified, you also must - // specify a valid FunctionVersion parameter. + // Specify a region (e.g. us-east-2) to only list functions that were created + // in that region, or ALL to include functions replicated from any region. If + // specified, you also must specify the FunctionVersion. MasterRegion *string `location:"querystring" locationName:"MasterRegion" type:"string"` // Optional integer. Specifies the maximum number of AWS Lambda functions to - // return in response. This parameter value must be greater than 0. + // return in response. This parameter value must be greater than 0. The absolute + // maximum of AWS Lambda functions that can be returned is 50. MaxItems *int64 `location:"querystring" locationName:"MaxItems" min:"1" type:"integer"` } @@ -5855,7 +5842,7 @@ func (s *ListFunctionsInput) SetMaxItems(v int64) *ListFunctionsInput { return s } -// Contains a list of AWS Lambda function configurations (see FunctionConfiguration. +// A list of Lambda functions. type ListFunctionsOutput struct { _ struct{} `type:"structure"` @@ -5956,12 +5943,18 @@ func (s *ListTagsOutput) SetTags(v map[string]*string) *ListTagsOutput { type ListVersionsByFunctionInput struct { _ struct{} `type:"structure"` - // Function name whose versions to list. You can specify a function name (for - // example, Thumbnail) or you can specify Amazon Resource Name (ARN) of the - // function (for example, arn:aws:lambda:us-west-2:account-id:function:ThumbNail). - // AWS Lambda also allows you to specify a partial ARN (for example, account-id:Thumbnail). - // Note that the length constraint applies only to the ARN. If you specify only - // the function name, it is limited to 64 characters in length. + // The name of the lambda function. + // + // Name formats + // + // * Function name - MyFunction. + // + // * Function ARN - arn:aws:lambda:us-west-2:123456789012:function:MyFunction. + // + // * Partial ARN - 123456789012:function:MyFunction. + // + // The length constraint applies only to the full ARN. If you specify only the + // function name, it is limited to 64 characters in length. // // FunctionName is a required field FunctionName *string `location:"uri" locationName:"FunctionName" min:"1" type:"string" required:"true"` @@ -6068,12 +6061,18 @@ type PublishVersionInput struct { // Lambda copies the description from the $LATEST version. Description *string `type:"string"` - // The Lambda function name. You can specify a function name (for example, Thumbnail) - // or you can specify Amazon Resource Name (ARN) of the function (for example, - // arn:aws:lambda:us-west-2:account-id:function:ThumbNail). AWS Lambda also - // allows you to specify a partial ARN (for example, account-id:Thumbnail). - // Note that the length constraint applies only to the ARN. If you specify only - // the function name, it is limited to 64 characters in length. + // The name of the lambda function. + // + // Name formats + // + // * Function name - MyFunction. + // + // * Function ARN - arn:aws:lambda:us-west-2:123456789012:function:MyFunction. + // + // * Partial ARN - 123456789012:function:MyFunction. + // + // The length constraint applies only to the full ARN. If you specify only the + // function name, it is limited to 64 characters in length. // // FunctionName is a required field FunctionName *string `location:"uri" locationName:"FunctionName" min:"1" type:"string" required:"true"` @@ -6081,8 +6080,8 @@ type PublishVersionInput struct { // An optional value you can use to ensure you are updating the latest update // of the function version or alias. If the RevisionID you pass doesn't match // the latest RevisionId of the function or alias, it will fail with an error - // message, advising you to retrieve the latest function version or alias RevisionID - // using either or . + // message, advising you retrieve the latest function version or alias RevisionID + // using either GetFunction or GetAlias. RevisionId *string `type:"string"` } @@ -6139,14 +6138,23 @@ func (s *PublishVersionInput) SetRevisionId(v string) *PublishVersionInput { type PutFunctionConcurrencyInput struct { _ struct{} `type:"structure"` - // The name of the function you are setting concurrent execution limits on. - // For more information, see concurrent-executions. + // The name of the lambda function. + // + // Name formats + // + // * Function name - MyFunction. + // + // * Function ARN - arn:aws:lambda:us-west-2:123456789012:function:MyFunction. + // + // * Partial ARN - 123456789012:function:MyFunction. + // + // The length constraint applies only to the full ARN. If you specify only the + // function name, it is limited to 64 characters in length. // // FunctionName is a required field FunctionName *string `location:"uri" locationName:"FunctionName" min:"1" type:"string" required:"true"` - // The concurrent execution limit reserved for this function. For more information, - // see concurrent-executions. + // The concurrent execution limit reserved for this function. // // ReservedConcurrentExecutions is a required field ReservedConcurrentExecutions *int64 `type:"integer" required:"true"` @@ -6197,7 +6205,7 @@ type PutFunctionConcurrencyOutput struct { _ struct{} `type:"structure"` // The number of concurrent executions reserved for this function. For more - // information, see concurrent-executions. + // information, see Managing Concurrency (http://docs.aws.amazon.com/lambda/latest/dg/concurrent-executions.html). ReservedConcurrentExecutions *int64 `type:"integer"` } @@ -6220,28 +6228,31 @@ func (s *PutFunctionConcurrencyOutput) SetReservedConcurrentExecutions(v int64) type RemovePermissionInput struct { _ struct{} `type:"structure"` - // Lambda function whose resource policy you want to remove a permission from. + // The name of the lambda function. + // + // Name formats + // + // * Function name - MyFunction. + // + // * Function ARN - arn:aws:lambda:us-west-2:123456789012:function:MyFunction. // - // You can specify a function name (for example, Thumbnail) or you can specify - // Amazon Resource Name (ARN) of the function (for example, arn:aws:lambda:us-west-2:account-id:function:ThumbNail). - // AWS Lambda also allows you to specify a partial ARN (for example, account-id:Thumbnail). - // Note that the length constraint applies only to the ARN. If you specify only - // the function name, it is limited to 64 characters in length. + // * Partial ARN - 123456789012:function:MyFunction. + // + // The length constraint applies only to the full ARN. If you specify only the + // function name, it is limited to 64 characters in length. // // FunctionName is a required field FunctionName *string `location:"uri" locationName:"FunctionName" min:"1" type:"string" required:"true"` - // You can specify this optional parameter to remove permission associated with - // a specific function version or function alias. If you don't specify this - // parameter, the API removes permission associated with the unqualified function - // ARN. + // Specify a version or alias to remove permissions from a published version + // of the function. Qualifier *string `location:"querystring" locationName:"Qualifier" min:"1" type:"string"` // An optional value you can use to ensure you are updating the latest update // of the function version or alias. If the RevisionID you pass doesn't match // the latest RevisionId of the function or alias, it will fail with an error // message, advising you to retrieve the latest function version or alias RevisionID - // using either or . + // using either GetFunction or GetAlias. RevisionId *string `location:"querystring" locationName:"RevisionId" type:"string"` // Statement ID of the permission to remove. @@ -6393,15 +6404,11 @@ func (s TagResourceOutput) GoString() string { return s.String() } -// The parent object that contains your function's tracing settings. +// The function's AWS X-Ray tracing configuration. type TracingConfig struct { _ struct{} `type:"structure"` - // Can be either PassThrough or Active. If PassThrough, Lambda will only trace - // the request from an upstream service if it contains a tracing header with - // "sampled=1". If Active, Lambda will respect any tracing header it receives - // from an upstream service. If no tracing header is received, Lambda will call - // X-Ray for a tracing decision. + // The tracing mode. Mode *string `type:"string" enum:"TracingMode"` } @@ -6421,11 +6428,11 @@ func (s *TracingConfig) SetMode(v string) *TracingConfig { return s } -// Parent object of the tracing information associated with your Lambda function. +// The function's AWS X-Ray tracing configuration. type TracingConfigResponse struct { _ struct{} `type:"structure"` - // The tracing mode associated with your Lambda function. + // The tracing mode. Mode *string `type:"string" enum:"TracingMode"` } @@ -6521,9 +6528,18 @@ type UpdateAliasInput struct { // You can change the description of the alias using this parameter. Description *string `type:"string"` - // The function name for which the alias is created. Note that the length constraint - // applies only to the ARN. If you specify only the function name, it is limited - // to 64 characters in length. + // The name of the lambda function. + // + // Name formats + // + // * Function name - MyFunction. + // + // * Function ARN - arn:aws:lambda:us-west-2:123456789012:function:MyFunction. + // + // * Partial ARN - 123456789012:function:MyFunction. + // + // The length constraint applies only to the full ARN. If you specify only the + // function name, it is limited to 64 characters in length. // // FunctionName is a required field FunctionName *string `location:"uri" locationName:"FunctionName" min:"1" type:"string" required:"true"` @@ -6540,13 +6556,13 @@ type UpdateAliasInput struct { // An optional value you can use to ensure you are updating the latest update // of the function version or alias. If the RevisionID you pass doesn't match // the latest RevisionId of the function or alias, it will fail with an error - // message, advising you to retrieve the latest function version or alias RevisionID - // using either or . + // message, advising you retrieve the latest function version or alias RevisionID + // using either GetFunction or GetAlias. RevisionId *string `type:"string"` // Specifies an additional version your alias can point to, allowing you to // dictate what percentage of traffic will invoke each version. For more information, - // see lambda-traffic-shifting-using-aliases. + // see Traffic Shifting Using Aliases (http://docs.aws.amazon.com/lambda/latest/dg/lambda-traffic-shifting-using-aliases.html). RoutingConfig *AliasRoutingConfiguration `type:"structure"` } @@ -6624,29 +6640,29 @@ func (s *UpdateAliasInput) SetRoutingConfig(v *AliasRoutingConfiguration) *Updat type UpdateEventSourceMappingInput struct { _ struct{} `type:"structure"` - // The maximum number of stream records that can be sent to your Lambda function - // for a single invocation. + // The largest number of records that AWS Lambda will retrieve from your event + // source at the time of invoking your function. Your function receives an event + // with all the retrieved records. BatchSize *int64 `min:"1" type:"integer"` // Specifies whether AWS Lambda should actively poll the stream or not. If disabled, // AWS Lambda will not poll the stream. Enabled *bool `type:"boolean"` - // The Lambda function to which you want the stream records sent. + // The name of the lambda function. + // + // Name formats // - // You can specify a function name (for example, Thumbnail) or you can specify - // Amazon Resource Name (ARN) of the function (for example, arn:aws:lambda:us-west-2:account-id:function:ThumbNail). - // AWS Lambda also allows you to specify a partial ARN (for example, account-id:Thumbnail). - // Note that the length constraint applies only to the ARN. If you specify only - // the function name, it is limited to 64 characters in length. + // * Function name - MyFunction. // - // If you are using versioning, you can also provide a qualified function ARN - // (ARN that is qualified with function version or alias name as suffix). For - // more information about versioning, see AWS Lambda Function Versioning and - // Aliases (http://docs.aws.amazon.com/lambda/latest/dg/versioning-aliases.html) + // * Function ARN - arn:aws:lambda:us-west-2:123456789012:function:MyFunction. // - // Note that the length constraint applies only to the ARN. If you specify only - // the function name, it is limited to 64 character in length. + // * Version or Alias ARN - arn:aws:lambda:us-west-2:123456789012:function:MyFunction:PROD. + // + // * Partial ARN - 123456789012:function:MyFunction. + // + // The length constraint applies only to the full ARN. If you specify only the + // function name, it is limited to 64 characters in length. FunctionName *string `min:"1" type:"string"` // The event source mapping identifier. @@ -6719,13 +6735,18 @@ type UpdateFunctionCodeInput struct { // returned in the response. DryRun *bool `type:"boolean"` - // The existing Lambda function name whose code you want to replace. + // The name of the lambda function. + // + // Name formats + // + // * Function name - MyFunction. + // + // * Function ARN - arn:aws:lambda:us-west-2:123456789012:function:MyFunction. // - // You can specify a function name (for example, Thumbnail) or you can specify - // Amazon Resource Name (ARN) of the function (for example, arn:aws:lambda:us-west-2:account-id:function:ThumbNail). - // AWS Lambda also allows you to specify a partial ARN (for example, account-id:Thumbnail). - // Note that the length constraint applies only to the ARN. If you specify only - // the function name, it is limited to 64 characters in length. + // * Partial ARN - 123456789012:function:MyFunction. + // + // The length constraint applies only to the full ARN. If you specify only the + // function name, it is limited to 64 characters in length. // // FunctionName is a required field FunctionName *string `location:"uri" locationName:"FunctionName" min:"1" type:"string" required:"true"` @@ -6738,7 +6759,7 @@ type UpdateFunctionCodeInput struct { // of the function version or alias. If the RevisionID you pass doesn't match // the latest RevisionId of the function or alias, it will fail with an error // message, advising you to retrieve the latest function version or alias RevisionID - // using either or . + // using either using using either GetFunction or GetAlias. RevisionId *string `type:"string"` // Amazon S3 bucket name where the .zip file containing your deployment package @@ -6848,8 +6869,9 @@ func (s *UpdateFunctionCodeInput) SetZipFile(v []byte) *UpdateFunctionCodeInput type UpdateFunctionConfigurationInput struct { _ struct{} `type:"structure"` - // The parent object that contains the target ARN (Amazon Resource Name) of - // an Amazon SQS queue or Amazon SNS topic. For more information, see dlq. + // A dead letter queue configuration that specifies the queue or topic where + // Lambda sends asynchronous events when they fail processing. For more information, + // see Dead Letter Queues (http://docs.aws.amazon.com/lambda/latest/dg/dlq.html). DeadLetterConfig *DeadLetterConfig `type:"structure"` // A short user-defined function description. AWS Lambda does not use this value. @@ -6859,13 +6881,18 @@ type UpdateFunctionConfigurationInput struct { // The parent object that contains your environment's configuration settings. Environment *Environment `type:"structure"` - // The name of the Lambda function. + // The name of the lambda function. + // + // Name formats + // + // * Function name - MyFunction. // - // You can specify a function name (for example, Thumbnail) or you can specify - // Amazon Resource Name (ARN) of the function (for example, arn:aws:lambda:us-west-2:account-id:function:ThumbNail). - // AWS Lambda also allows you to specify a partial ARN (for example, account-id:Thumbnail). - // Note that the length constraint applies only to the ARN. If you specify only - // the function name, it is limited to 64 character in length. + // * Function ARN - arn:aws:lambda:us-west-2:123456789012:function:MyFunction. + // + // * Partial ARN - 123456789012:function:MyFunction. + // + // The length constraint applies only to the full ARN. If you specify only the + // function name, it is limited to 64 characters in length. // // FunctionName is a required field FunctionName *string `location:"uri" locationName:"FunctionName" min:"1" type:"string" required:"true"` @@ -6891,40 +6918,26 @@ type UpdateFunctionConfigurationInput struct { // of the function version or alias. If the RevisionID you pass doesn't match // the latest RevisionId of the function or alias, it will fail with an error // message, advising you to retrieve the latest function version or alias RevisionID - // using either or . + // using either GetFunction or GetAlias. RevisionId *string `type:"string"` // The Amazon Resource Name (ARN) of the IAM role that Lambda will assume when // it executes your function. Role *string `type:"string"` - // The runtime environment for the Lambda function. - // - // To use the Python runtime v3.6, set the value to "python3.6". To use the - // Python runtime v2.7, set the value to "python2.7". To use the Node.js runtime - // v6.10, set the value to "nodejs6.10". To use the Node.js runtime v4.3, set - // the value to "nodejs4.3". To use the .NET Core runtime v1.0, set the value - // to "dotnetcore1.0". To use the .NET Core runtime v2.0, set the value to "dotnetcore2.0". - // - // Node v0.10.42 is currently marked as deprecated. You must migrate existing - // functions to the newer Node.js runtime versions available on AWS Lambda (nodejs4.3 - // or nodejs6.10) as soon as possible. Failure to do so will result in an invalid - // parameter error being returned. Note that you will have to follow this procedure - // for each region that contains functions written in the Node v0.10.42 runtime. + // The runtime version for the function. Runtime *string `type:"string" enum:"Runtime"` - // The function execution time at which AWS Lambda should terminate the function. - // Because the execution time has cost implications, we recommend you set this - // value based on your expected execution time. The default is 3 seconds. + // The amount of time that Lambda allows a function to run before terminating + // it. The default is 3 seconds. The maximum allowed value is 900 seconds. Timeout *int64 `min:"1" type:"integer"` - // The parent object that contains your function's tracing settings. + // Set Mode to Active to sample and trace a subset of incoming requests with + // AWS X-Ray. TracingConfig *TracingConfig `type:"structure"` - // If your Lambda function accesses resources in a VPC, you provide this parameter - // identifying the list of security group IDs and subnet IDs. These must belong - // to the same VPC. You must provide at least one security group and one subnet - // ID. + // Specify security groups and subnets in a VPC to which your Lambda function + // needs access. VpcConfig *VpcConfig `type:"structure"` } @@ -7038,17 +7051,14 @@ func (s *UpdateFunctionConfigurationInput) SetVpcConfig(v *VpcConfig) *UpdateFun return s } -// If your Lambda function accesses resources in a VPC, you provide this parameter -// identifying the list of security group IDs and subnet IDs. These must belong -// to the same VPC. You must provide at least one security group and one subnet -// ID. +// The VPC security groups and subnets attached to a Lambda function. type VpcConfig struct { _ struct{} `type:"structure"` - // A list of one or more security groups IDs in your VPC. + // A list of VPC security groups IDs. SecurityGroupIds []*string `type:"list"` - // A list of one or more subnet IDs in your VPC. + // A list of VPC subnet IDs. SubnetIds []*string `type:"list"` } @@ -7074,17 +7084,17 @@ func (s *VpcConfig) SetSubnetIds(v []*string) *VpcConfig { return s } -// VPC configuration associated with your Lambda function. +// The VPC security groups and subnets attached to a Lambda function. type VpcConfigResponse struct { _ struct{} `type:"structure"` - // A list of security group IDs associated with the Lambda function. + // A list of VPC security groups IDs. SecurityGroupIds []*string `type:"list"` - // A list of subnet IDs associated with the Lambda function. + // A list of VPC subnet IDs. SubnetIds []*string `type:"list"` - // The VPC ID associated with you Lambda function. + // The ID of the VPC. VpcId *string `type:"string"` } diff --git a/service/lambda/errors.go b/service/lambda/errors.go index 447b49ed1a9..4e12ca08f76 100644 --- a/service/lambda/errors.go +++ b/service/lambda/errors.go @@ -12,6 +12,8 @@ const ( // ErrCodeEC2AccessDeniedException for service response error code // "EC2AccessDeniedException". + // + // Need additional permissions to configure VPC settings. ErrCodeEC2AccessDeniedException = "EC2AccessDeniedException" // ErrCodeEC2ThrottledException for service response error code @@ -72,7 +74,7 @@ const ( // ErrCodeInvalidZipFileException for service response error code // "InvalidZipFileException". // - // AWS Lambda could not unzip the function zip file. + // AWS Lambda could not unzip the deployment package. ErrCodeInvalidZipFileException = "InvalidZipFileException" // ErrCodeKMSAccessDeniedException for service response error code @@ -160,6 +162,8 @@ const ( // ErrCodeTooManyRequestsException for service response error code // "TooManyRequestsException". + // + // Request throughput limit exceeded ErrCodeTooManyRequestsException = "TooManyRequestsException" // ErrCodeUnsupportedMediaTypeException for service response error code diff --git a/service/mediaconvert/api.go b/service/mediaconvert/api.go index e815e0bcec6..45e643c59c1 100644 --- a/service/mediaconvert/api.go +++ b/service/mediaconvert/api.go @@ -751,6 +751,12 @@ func (c *MediaConvert) DescribeEndpointsRequest(input *DescribeEndpointsInput) ( Name: opDescribeEndpoints, HTTPMethod: "POST", HTTPPath: "/2017-08-29/endpoints", + Paginator: &request.Paginator{ + InputTokens: []string{"NextToken"}, + OutputTokens: []string{"NextToken"}, + LimitToken: "MaxResults", + TruncationToken: "", + }, } if input == nil { @@ -809,6 +815,56 @@ func (c *MediaConvert) DescribeEndpointsWithContext(ctx aws.Context, input *Desc return out, req.Send() } +// DescribeEndpointsPages iterates over the pages of a DescribeEndpoints operation, +// calling the "fn" function with the response data for each page. To stop +// iterating, return false from the fn function. +// +// See DescribeEndpoints 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 DescribeEndpoints operation. +// pageNum := 0 +// err := client.DescribeEndpointsPages(params, +// func(page *DescribeEndpointsOutput, lastPage bool) bool { +// pageNum++ +// fmt.Println(page) +// return pageNum <= 3 +// }) +// +func (c *MediaConvert) DescribeEndpointsPages(input *DescribeEndpointsInput, fn func(*DescribeEndpointsOutput, bool) bool) error { + return c.DescribeEndpointsPagesWithContext(aws.BackgroundContext(), input, fn) +} + +// DescribeEndpointsPagesWithContext same as DescribeEndpointsPages 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 *MediaConvert) DescribeEndpointsPagesWithContext(ctx aws.Context, input *DescribeEndpointsInput, fn func(*DescribeEndpointsOutput, bool) bool, opts ...request.Option) error { + p := request.Pagination{ + NewRequest: func() (*request.Request, error) { + var inCpy *DescribeEndpointsInput + if input != nil { + tmp := *input + inCpy = &tmp + } + req, _ := c.DescribeEndpointsRequest(inCpy) + req.SetContext(ctx) + req.ApplyOptions(opts...) + return req, nil + }, + } + + cont := true + for p.Next() && cont { + cont = fn(p.Page().(*DescribeEndpointsOutput), !p.HasNextPage()) + } + return p.Err() +} + const opGetJob = "GetJob" // GetJobRequest generates a "aws/request.Request" representing the @@ -1192,6 +1248,12 @@ func (c *MediaConvert) ListJobTemplatesRequest(input *ListJobTemplatesInput) (re Name: opListJobTemplates, HTTPMethod: "GET", HTTPPath: "/2017-08-29/jobTemplates", + Paginator: &request.Paginator{ + InputTokens: []string{"NextToken"}, + OutputTokens: []string{"NextToken"}, + LimitToken: "MaxResults", + TruncationToken: "", + }, } if input == nil { @@ -1251,6 +1313,56 @@ func (c *MediaConvert) ListJobTemplatesWithContext(ctx aws.Context, input *ListJ return out, req.Send() } +// ListJobTemplatesPages iterates over the pages of a ListJobTemplates operation, +// calling the "fn" function with the response data for each page. To stop +// iterating, return false from the fn function. +// +// See ListJobTemplates 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 ListJobTemplates operation. +// pageNum := 0 +// err := client.ListJobTemplatesPages(params, +// func(page *ListJobTemplatesOutput, lastPage bool) bool { +// pageNum++ +// fmt.Println(page) +// return pageNum <= 3 +// }) +// +func (c *MediaConvert) ListJobTemplatesPages(input *ListJobTemplatesInput, fn func(*ListJobTemplatesOutput, bool) bool) error { + return c.ListJobTemplatesPagesWithContext(aws.BackgroundContext(), input, fn) +} + +// ListJobTemplatesPagesWithContext same as ListJobTemplatesPages 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 *MediaConvert) ListJobTemplatesPagesWithContext(ctx aws.Context, input *ListJobTemplatesInput, fn func(*ListJobTemplatesOutput, bool) bool, opts ...request.Option) error { + p := request.Pagination{ + NewRequest: func() (*request.Request, error) { + var inCpy *ListJobTemplatesInput + if input != nil { + tmp := *input + inCpy = &tmp + } + req, _ := c.ListJobTemplatesRequest(inCpy) + req.SetContext(ctx) + req.ApplyOptions(opts...) + return req, nil + }, + } + + cont := true + for p.Next() && cont { + cont = fn(p.Page().(*ListJobTemplatesOutput), !p.HasNextPage()) + } + return p.Err() +} + const opListJobs = "ListJobs" // ListJobsRequest generates a "aws/request.Request" representing the @@ -1282,6 +1394,12 @@ func (c *MediaConvert) ListJobsRequest(input *ListJobsInput) (req *request.Reque Name: opListJobs, HTTPMethod: "GET", HTTPPath: "/2017-08-29/jobs", + Paginator: &request.Paginator{ + InputTokens: []string{"NextToken"}, + OutputTokens: []string{"NextToken"}, + LimitToken: "MaxResults", + TruncationToken: "", + }, } if input == nil { @@ -1342,6 +1460,56 @@ func (c *MediaConvert) ListJobsWithContext(ctx aws.Context, input *ListJobsInput return out, req.Send() } +// ListJobsPages iterates over the pages of a ListJobs operation, +// calling the "fn" function with the response data for each page. To stop +// iterating, return false from the fn function. +// +// See ListJobs 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 ListJobs operation. +// pageNum := 0 +// err := client.ListJobsPages(params, +// func(page *ListJobsOutput, lastPage bool) bool { +// pageNum++ +// fmt.Println(page) +// return pageNum <= 3 +// }) +// +func (c *MediaConvert) ListJobsPages(input *ListJobsInput, fn func(*ListJobsOutput, bool) bool) error { + return c.ListJobsPagesWithContext(aws.BackgroundContext(), input, fn) +} + +// ListJobsPagesWithContext same as ListJobsPages 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 *MediaConvert) ListJobsPagesWithContext(ctx aws.Context, input *ListJobsInput, fn func(*ListJobsOutput, bool) bool, opts ...request.Option) error { + p := request.Pagination{ + NewRequest: func() (*request.Request, error) { + var inCpy *ListJobsInput + if input != nil { + tmp := *input + inCpy = &tmp + } + req, _ := c.ListJobsRequest(inCpy) + req.SetContext(ctx) + req.ApplyOptions(opts...) + return req, nil + }, + } + + cont := true + for p.Next() && cont { + cont = fn(p.Page().(*ListJobsOutput), !p.HasNextPage()) + } + return p.Err() +} + const opListPresets = "ListPresets" // ListPresetsRequest generates a "aws/request.Request" representing the @@ -1373,6 +1541,12 @@ func (c *MediaConvert) ListPresetsRequest(input *ListPresetsInput) (req *request Name: opListPresets, HTTPMethod: "GET", HTTPPath: "/2017-08-29/presets", + Paginator: &request.Paginator{ + InputTokens: []string{"NextToken"}, + OutputTokens: []string{"NextToken"}, + LimitToken: "MaxResults", + TruncationToken: "", + }, } if input == nil { @@ -1432,6 +1606,56 @@ func (c *MediaConvert) ListPresetsWithContext(ctx aws.Context, input *ListPreset return out, req.Send() } +// ListPresetsPages iterates over the pages of a ListPresets operation, +// calling the "fn" function with the response data for each page. To stop +// iterating, return false from the fn function. +// +// See ListPresets 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 ListPresets operation. +// pageNum := 0 +// err := client.ListPresetsPages(params, +// func(page *ListPresetsOutput, lastPage bool) bool { +// pageNum++ +// fmt.Println(page) +// return pageNum <= 3 +// }) +// +func (c *MediaConvert) ListPresetsPages(input *ListPresetsInput, fn func(*ListPresetsOutput, bool) bool) error { + return c.ListPresetsPagesWithContext(aws.BackgroundContext(), input, fn) +} + +// ListPresetsPagesWithContext same as ListPresetsPages 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 *MediaConvert) ListPresetsPagesWithContext(ctx aws.Context, input *ListPresetsInput, fn func(*ListPresetsOutput, bool) bool, opts ...request.Option) error { + p := request.Pagination{ + NewRequest: func() (*request.Request, error) { + var inCpy *ListPresetsInput + if input != nil { + tmp := *input + inCpy = &tmp + } + req, _ := c.ListPresetsRequest(inCpy) + req.SetContext(ctx) + req.ApplyOptions(opts...) + return req, nil + }, + } + + cont := true + for p.Next() && cont { + cont = fn(p.Page().(*ListPresetsOutput), !p.HasNextPage()) + } + return p.Err() +} + const opListQueues = "ListQueues" // ListQueuesRequest generates a "aws/request.Request" representing the @@ -1463,6 +1687,12 @@ func (c *MediaConvert) ListQueuesRequest(input *ListQueuesInput) (req *request.R Name: opListQueues, HTTPMethod: "GET", HTTPPath: "/2017-08-29/queues", + Paginator: &request.Paginator{ + InputTokens: []string{"NextToken"}, + OutputTokens: []string{"NextToken"}, + LimitToken: "MaxResults", + TruncationToken: "", + }, } if input == nil { @@ -1522,6 +1752,56 @@ func (c *MediaConvert) ListQueuesWithContext(ctx aws.Context, input *ListQueuesI return out, req.Send() } +// ListQueuesPages iterates over the pages of a ListQueues operation, +// calling the "fn" function with the response data for each page. To stop +// iterating, return false from the fn function. +// +// See ListQueues 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 ListQueues operation. +// pageNum := 0 +// err := client.ListQueuesPages(params, +// func(page *ListQueuesOutput, lastPage bool) bool { +// pageNum++ +// fmt.Println(page) +// return pageNum <= 3 +// }) +// +func (c *MediaConvert) ListQueuesPages(input *ListQueuesInput, fn func(*ListQueuesOutput, bool) bool) error { + return c.ListQueuesPagesWithContext(aws.BackgroundContext(), input, fn) +} + +// ListQueuesPagesWithContext same as ListQueuesPages 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 *MediaConvert) ListQueuesPagesWithContext(ctx aws.Context, input *ListQueuesInput, fn func(*ListQueuesOutput, bool) bool, opts ...request.Option) error { + p := request.Pagination{ + NewRequest: func() (*request.Request, error) { + var inCpy *ListQueuesInput + if input != nil { + tmp := *input + inCpy = &tmp + } + req, _ := c.ListQueuesRequest(inCpy) + req.SetContext(ctx) + req.ApplyOptions(opts...) + return req, nil + }, + } + + cont := true + for p.Next() && cont { + cont = fn(p.Page().(*ListQueuesOutput), !p.HasNextPage()) + } + return p.Err() +} + const opListTagsForResource = "ListTagsForResource" // ListTagsForResourceRequest generates a "aws/request.Request" representing the diff --git a/service/mediaconvert/mediaconvertiface/interface.go b/service/mediaconvert/mediaconvertiface/interface.go index 5398acb6655..d0ec34bdcae 100644 --- a/service/mediaconvert/mediaconvertiface/interface.go +++ b/service/mediaconvert/mediaconvertiface/interface.go @@ -96,6 +96,9 @@ type MediaConvertAPI interface { DescribeEndpointsWithContext(aws.Context, *mediaconvert.DescribeEndpointsInput, ...request.Option) (*mediaconvert.DescribeEndpointsOutput, error) DescribeEndpointsRequest(*mediaconvert.DescribeEndpointsInput) (*request.Request, *mediaconvert.DescribeEndpointsOutput) + DescribeEndpointsPages(*mediaconvert.DescribeEndpointsInput, func(*mediaconvert.DescribeEndpointsOutput, bool) bool) error + DescribeEndpointsPagesWithContext(aws.Context, *mediaconvert.DescribeEndpointsInput, func(*mediaconvert.DescribeEndpointsOutput, bool) bool, ...request.Option) error + GetJob(*mediaconvert.GetJobInput) (*mediaconvert.GetJobOutput, error) GetJobWithContext(aws.Context, *mediaconvert.GetJobInput, ...request.Option) (*mediaconvert.GetJobOutput, error) GetJobRequest(*mediaconvert.GetJobInput) (*request.Request, *mediaconvert.GetJobOutput) @@ -116,18 +119,30 @@ type MediaConvertAPI interface { ListJobTemplatesWithContext(aws.Context, *mediaconvert.ListJobTemplatesInput, ...request.Option) (*mediaconvert.ListJobTemplatesOutput, error) ListJobTemplatesRequest(*mediaconvert.ListJobTemplatesInput) (*request.Request, *mediaconvert.ListJobTemplatesOutput) + ListJobTemplatesPages(*mediaconvert.ListJobTemplatesInput, func(*mediaconvert.ListJobTemplatesOutput, bool) bool) error + ListJobTemplatesPagesWithContext(aws.Context, *mediaconvert.ListJobTemplatesInput, func(*mediaconvert.ListJobTemplatesOutput, bool) bool, ...request.Option) error + ListJobs(*mediaconvert.ListJobsInput) (*mediaconvert.ListJobsOutput, error) ListJobsWithContext(aws.Context, *mediaconvert.ListJobsInput, ...request.Option) (*mediaconvert.ListJobsOutput, error) ListJobsRequest(*mediaconvert.ListJobsInput) (*request.Request, *mediaconvert.ListJobsOutput) + ListJobsPages(*mediaconvert.ListJobsInput, func(*mediaconvert.ListJobsOutput, bool) bool) error + ListJobsPagesWithContext(aws.Context, *mediaconvert.ListJobsInput, func(*mediaconvert.ListJobsOutput, bool) bool, ...request.Option) error + ListPresets(*mediaconvert.ListPresetsInput) (*mediaconvert.ListPresetsOutput, error) ListPresetsWithContext(aws.Context, *mediaconvert.ListPresetsInput, ...request.Option) (*mediaconvert.ListPresetsOutput, error) ListPresetsRequest(*mediaconvert.ListPresetsInput) (*request.Request, *mediaconvert.ListPresetsOutput) + ListPresetsPages(*mediaconvert.ListPresetsInput, func(*mediaconvert.ListPresetsOutput, bool) bool) error + ListPresetsPagesWithContext(aws.Context, *mediaconvert.ListPresetsInput, func(*mediaconvert.ListPresetsOutput, bool) bool, ...request.Option) error + ListQueues(*mediaconvert.ListQueuesInput) (*mediaconvert.ListQueuesOutput, error) ListQueuesWithContext(aws.Context, *mediaconvert.ListQueuesInput, ...request.Option) (*mediaconvert.ListQueuesOutput, error) ListQueuesRequest(*mediaconvert.ListQueuesInput) (*request.Request, *mediaconvert.ListQueuesOutput) + ListQueuesPages(*mediaconvert.ListQueuesInput, func(*mediaconvert.ListQueuesOutput, bool) bool) error + ListQueuesPagesWithContext(aws.Context, *mediaconvert.ListQueuesInput, func(*mediaconvert.ListQueuesOutput, bool) bool, ...request.Option) error + ListTagsForResource(*mediaconvert.ListTagsForResourceInput) (*mediaconvert.ListTagsForResourceOutput, error) ListTagsForResourceWithContext(aws.Context, *mediaconvert.ListTagsForResourceInput, ...request.Option) (*mediaconvert.ListTagsForResourceOutput, error) ListTagsForResourceRequest(*mediaconvert.ListTagsForResourceInput) (*request.Request, *mediaconvert.ListTagsForResourceOutput) diff --git a/service/rds/api.go b/service/rds/api.go index ff97407c848..76c0855135d 100644 --- a/service/rds/api.go +++ b/service/rds/api.go @@ -10749,7 +10749,7 @@ type BacktrackDBClusterInput struct { // // * Must contain a valid ISO 8601 timestamp. // - // * Cannot contain a timestamp set in the future. + // * Can't contain a timestamp set in the future. // // Example: 2017-07-08T18:00Z // @@ -10765,7 +10765,7 @@ type BacktrackDBClusterInput struct { // // * First character must be a letter. // - // * Cannot end with a hyphen or contain two consecutive hyphens. + // * Can't end with a hyphen or contain two consecutive hyphens. // // Example: my-cluster1 // @@ -11092,13 +11092,13 @@ type CopyDBClusterParameterGroupInput struct { // // Constraints: // - // * Cannot be null, empty, or blank + // * Can't be null, empty, or blank // // * Must contain from 1 to 255 letters, numbers, or hyphens // // * First character must be a letter // - // * Cannot end with a hyphen or contain two consecutive hyphens + // * Can't end with a hyphen or contain two consecutive hyphens // // Example: my-cluster-param-group1 // @@ -11289,7 +11289,7 @@ type CopyDBClusterSnapshotInput struct { // // * First character must be a letter. // - // * Cannot end with a hyphen or contain two consecutive hyphens. + // * Can't end with a hyphen or contain two consecutive hyphens. // // Example: my-cluster-snapshot2 // @@ -11427,13 +11427,13 @@ type CopyDBParameterGroupInput struct { // // Constraints: // - // * Cannot be null, empty, or blank + // * Can't be null, empty, or blank // // * Must contain from 1 to 255 letters, numbers, or hyphens // // * First character must be a letter // - // * Cannot end with a hyphen or contain two consecutive hyphens + // * Can't end with a hyphen or contain two consecutive hyphens // // Example: my-db-parameter-group // @@ -11643,13 +11643,13 @@ type CopyDBSnapshotInput struct { // // Constraints: // - // * Cannot be null, empty, or blank + // * Can't be null, empty, or blank // // * Must contain from 1 to 255 letters, numbers, or hyphens // // * First character must be a letter // - // * Cannot end with a hyphen or contain two consecutive hyphens + // * Can't end with a hyphen or contain two consecutive hyphens // // Example: my-db-snapshot // @@ -11796,13 +11796,13 @@ type CopyOptionGroupInput struct { // // Constraints: // - // * Cannot be null, empty, or blank + // * Can't be null, empty, or blank // // * Must contain from 1 to 255 letters, numbers, or hyphens // // * First character must be a letter // - // * Cannot end with a hyphen or contain two consecutive hyphens + // * Can't end with a hyphen or contain two consecutive hyphens // // Example: my-option-group // @@ -11927,7 +11927,7 @@ type CreateDBClusterInput struct { // // * First character must be a letter. // - // * Cannot end with a hyphen or contain two consecutive hyphens. + // * Can't end with a hyphen or contain two consecutive hyphens. // // Example: my-cluster1 // @@ -11939,7 +11939,8 @@ type CreateDBClusterInput struct { // // Constraints: // - // * If supplied, must match the name of an existing DBClusterParameterGroup. + // * If supplied, must match the name of an existing DB cluster parameter + // group. DBClusterParameterGroupName *string `type:"string"` // A DB subnet group to associate with this DB cluster. @@ -12036,7 +12037,7 @@ type CreateDBClusterInput struct { // // * First character must be a letter. // - // * Cannot be a reserved word for the chosen database engine. + // * Can't be a reserved word for the chosen database engine. MasterUsername *string `type:"string"` // A value that indicates that the DB cluster should be associated with the @@ -12374,7 +12375,7 @@ type CreateDBClusterParameterGroupInput struct { // // Constraints: // - // * Must match the name of an existing DBClusterParameterGroup. + // * Must match the name of an existing DB cluster parameter group. // // This value is stored as a lowercase string. // @@ -12510,7 +12511,7 @@ type CreateDBClusterSnapshotInput struct { // // * First character must be a letter. // - // * Cannot end with a hyphen or contain two consecutive hyphens. + // * Can't end with a hyphen or contain two consecutive hyphens. // // Example: my-cluster1-snapshot1 // @@ -12702,7 +12703,7 @@ type CreateDBInstanceInput struct { // // * Must be a value from 0 to 35 // - // * Cannot be set to 0 if the DB instance is a source to Read Replicas + // * Can't be set to 0 if the DB instance is a source to Read Replicas BackupRetentionPeriod *int64 `type:"integer"` // For supported engines, indicates that the DB instance should be associated @@ -12742,7 +12743,7 @@ type CreateDBInstanceInput struct { // // * First character must be a letter. // - // * Cannot end with a hyphen or contain two consecutive hyphens. + // * Can't end with a hyphen or contain two consecutive hyphens. // // Example: mydbinstance // @@ -12763,7 +12764,7 @@ type CreateDBInstanceInput struct { // // * Must contain 1 to 64 letters or numbers. // - // * Cannot be a word reserved by the specified database engine + // * Can't be a word reserved by the specified database engine // // MariaDB // @@ -12774,7 +12775,7 @@ type CreateDBInstanceInput struct { // // * Must contain 1 to 64 letters or numbers. // - // * Cannot be a word reserved by the specified database engine + // * Can't be a word reserved by the specified database engine // // PostgreSQL // @@ -12789,7 +12790,7 @@ type CreateDBInstanceInput struct { // * Must begin with a letter or an underscore. Subsequent characters can // be letters, underscores, or digits (0-9). // - // * Cannot be a word reserved by the specified database engine + // * Can't be a word reserved by the specified database engine // // Oracle // @@ -12801,7 +12802,7 @@ type CreateDBInstanceInput struct { // // Constraints: // - // * Cannot be longer than 8 characters + // * Can't be longer than 8 characters // // SQL Server // @@ -12817,7 +12818,7 @@ type CreateDBInstanceInput struct { // // * Must contain 1 to 64 letters or numbers. // - // * Cannot be a word reserved by the specified database engine + // * Can't be a word reserved by the specified database engine DBName *string `type:"string"` // The name of the DB parameter group to associate with this DB instance. If @@ -12830,7 +12831,7 @@ type CreateDBInstanceInput struct { // // * First character must be a letter // - // * Cannot end with a hyphen or contain two consecutive hyphens + // * Can't end with a hyphen or contain two consecutive hyphens DBParameterGroupName *string `type:"string"` // A list of DB security groups to associate with this DB instance. @@ -12969,9 +12970,7 @@ type CreateDBInstanceInput struct { // in the Amazon RDS User Guide. // // Constraints: Must be a multiple between 1 and 50 of the storage amount for - // the DB instance. Must also be an integer multiple of 1000. For example, if - // the size of your DB instance is 500 GiB, then your Iops value can be 2000, - // 3000, 4000, or 5000. + // the DB instance. Iops *int64 `type:"integer"` // The AWS KMS key identifier for an encrypted DB instance. @@ -13041,7 +13040,7 @@ type CreateDBInstanceInput struct { // // * Must be 1 to 16 letters or numbers. // - // * Cannot be a reserved word for the chosen database engine. + // * Can't be a reserved word for the chosen database engine. // // Microsoft SQL Server // @@ -13053,7 +13052,7 @@ type CreateDBInstanceInput struct { // // * The first character must be a letter. // - // * Cannot be a reserved word for the chosen database engine. + // * Can't be a reserved word for the chosen database engine. // // MySQL // @@ -13065,7 +13064,7 @@ type CreateDBInstanceInput struct { // // * First character must be a letter. // - // * Cannot be a reserved word for the chosen database engine. + // * Can't be a reserved word for the chosen database engine. // // Oracle // @@ -13077,7 +13076,7 @@ type CreateDBInstanceInput struct { // // * First character must be a letter. // - // * Cannot be a reserved word for the chosen database engine. + // * Can't be a reserved word for the chosen database engine. // // PostgreSQL // @@ -13089,7 +13088,7 @@ type CreateDBInstanceInput struct { // // * First character must be a letter. // - // * Cannot be a reserved word for the chosen database engine. + // * Can't be a reserved word for the chosen database engine. MasterUsername *string `type:"string"` // The interval, in seconds, between points when Enhanced Monitoring metrics @@ -14148,7 +14147,7 @@ type CreateDBParameterGroupInput struct { // // * First character must be a letter // - // * Cannot end with a hyphen or contain two consecutive hyphens + // * Can't end with a hyphen or contain two consecutive hyphens // // This value is stored as a lowercase string. // @@ -14260,7 +14259,7 @@ type CreateDBSecurityGroupInput struct { // // * First character must be a letter // - // * Cannot end with a hyphen or contain two consecutive hyphens + // * Can't end with a hyphen or contain two consecutive hyphens // // * Must not be "Default" // @@ -14360,13 +14359,13 @@ type CreateDBSnapshotInput struct { // // Constraints: // - // * Cannot be null, empty, or blank + // * Can't be null, empty, or blank // // * Must contain from 1 to 255 letters, numbers, or hyphens // // * First character must be a letter // - // * Cannot end with a hyphen or contain two consecutive hyphens + // * Can't end with a hyphen or contain two consecutive hyphens // // Example: my-snapshot-id // @@ -14737,7 +14736,7 @@ type CreateOptionGroupInput struct { // // * First character must be a letter // - // * Cannot end with a hyphen or contain two consecutive hyphens + // * Can't end with a hyphen or contain two consecutive hyphens // // Example: myoptiongroup // @@ -15438,7 +15437,7 @@ type DBClusterParameterGroupNameMessage struct { // // * First character must be a letter // - // * Cannot end with a hyphen or contain two consecutive hyphens + // * Can't end with a hyphen or contain two consecutive hyphens // // This value is stored as a lowercase string. DBClusterParameterGroupName *string `type:"string"` @@ -17285,7 +17284,7 @@ type DeleteDBClusterInput struct { // // * First character must be a letter // - // * Cannot end with a hyphen or contain two consecutive hyphens + // * Can't end with a hyphen or contain two consecutive hyphens FinalDBSnapshotIdentifier *string `type:"string"` // Determines whether a final DB cluster snapshot is created before the DB cluster @@ -17377,7 +17376,7 @@ type DeleteDBClusterParameterGroupInput struct { // // * You can't delete a default DB cluster parameter group. // - // * Cannot be associated with any DB clusters. + // * Can't be associated with any DB clusters. // // DBClusterParameterGroupName is a required field DBClusterParameterGroupName *string `type:"string" required:"true"` @@ -17518,9 +17517,9 @@ type DeleteDBInstanceInput struct { // // * First character must be a letter // - // * Cannot end with a hyphen or contain two consecutive hyphens + // * Can't end with a hyphen or contain two consecutive hyphens // - // * Cannot be specified when deleting a Read Replica. + // * Can't be specified when deleting a Read Replica. FinalDBSnapshotIdentifier *string `type:"string"` // Determines whether a final DB snapshot is created before the DB instance @@ -17617,7 +17616,7 @@ type DeleteDBParameterGroupInput struct { // // * You can't delete a default DB parameter group // - // * Cannot be associated with any DB instances + // * Can't be associated with any DB instances // // DBParameterGroupName is a required field DBParameterGroupName *string `type:"string" required:"true"` @@ -17679,7 +17678,7 @@ type DeleteDBSecurityGroupInput struct { // // * First character must be a letter // - // * Cannot end with a hyphen or contain two consecutive hyphens + // * Can't end with a hyphen or contain two consecutive hyphens // // * Must not be "Default" // @@ -18155,7 +18154,7 @@ type DescribeDBClusterBacktracksInput struct { // // * First character must be a letter. // - // * Cannot end with a hyphen or contain two consecutive hyphens. + // * Can't end with a hyphen or contain two consecutive hyphens. // // Example: my-cluster1 // @@ -20628,7 +20627,7 @@ type DescribeEventsInput struct { // // * If the source type is DBSnapshot, a DBSnapshotIdentifier must be supplied. // - // * Cannot end with a hyphen or contain two consecutive hyphens. + // * Can't end with a hyphen or contain two consecutive hyphens. SourceIdentifier *string `type:"string"` // The event source to retrieve events for. If no value is specified, all events @@ -20918,7 +20917,7 @@ type DescribeOptionGroupsInput struct { // Constraints: Minimum 20, maximum 100. MaxRecords *int64 `type:"integer"` - // The name of the option group to describe. Cannot be supplied together with + // The name of the option group to describe. Can't be supplied together with // EngineName or MajorEngineVersion. OptionGroupName *string `type:"string"` } @@ -22962,7 +22961,7 @@ type ModifyDBClusterInput struct { // // * The first character must be a letter // - // * Cannot end with a hyphen or contain two consecutive hyphens + // * Can't end with a hyphen or contain two consecutive hyphens // // Example: my-cluster2 NewDBClusterIdentifier *string `type:"string"` @@ -23422,7 +23421,7 @@ type ModifyDBInstanceInput struct { // * Can be specified for a PostgreSQL Read Replica only if the source is // running PostgreSQL 9.3.5 // - // * Cannot be set to 0 if the DB instance is a source to Read Replicas + // * Can't be set to 0 if the DB instance is a source to Read Replicas BackupRetentionPeriod *int64 `type:"integer"` // Indicates the certificate that needs to be associated with the instance. @@ -23706,7 +23705,7 @@ type ModifyDBInstanceInput struct { // // * The first character must be a letter. // - // * Cannot end with a hyphen or contain two consecutive hyphens. + // * Can't end with a hyphen or contain two consecutive hyphens. // // Example: mydbinstance NewDBInstanceIdentifier *string `type:"string"` @@ -27233,7 +27232,7 @@ type RestoreDBClusterFromS3Input struct { // // * First character must be a letter. // - // * Cannot end with a hyphen or contain two consecutive hyphens. + // * Can't end with a hyphen or contain two consecutive hyphens. // // Example: my-cluster1 // @@ -27322,7 +27321,7 @@ type RestoreDBClusterFromS3Input struct { // // * First character must be a letter. // - // * Cannot be a reserved word for the chosen database engine. + // * Can't be a reserved word for the chosen database engine. // // MasterUsername is a required field MasterUsername *string `type:"string" required:"true"` @@ -27663,8 +27662,8 @@ func (s *RestoreDBClusterFromS3Output) SetDBCluster(v *DBCluster) *RestoreDBClus type RestoreDBClusterFromSnapshotInput struct { _ struct{} `type:"structure"` - // Provides the list of EC2 Availability Zones that instances in the restored - // DB cluster can be created in. + // Provides the list of Amazon EC2 Availability Zones that instances in the + // restored DB cluster can be created in. AvailabilityZones []*string `locationNameList:"AvailabilityZone" type:"list"` // The target backtrack window, in seconds. To disable backtracking, set this @@ -27687,16 +27686,32 @@ type RestoreDBClusterFromSnapshotInput struct { // // * First character must be a letter // - // * Cannot end with a hyphen or contain two consecutive hyphens + // * Can't end with a hyphen or contain two consecutive hyphens // // Example: my-snapshot-id // // DBClusterIdentifier is a required field DBClusterIdentifier *string `type:"string" required:"true"` + // The name of the DB cluster parameter group to associate with this DB cluster. + // If this argument is omitted, the default DB cluster parameter group for the + // specified engine is used. + // + // Constraints: + // + // * If supplied, must match the name of an existing default DB cluster parameter + // group. + // + // * Must be 1 to 255 letters, numbers, or hyphens. + // + // * First character must be a letter. + // + // * Can't end with a hyphen or contain two consecutive hyphens. + DBClusterParameterGroupName *string `type:"string"` + // The name of the DB subnet group to use for the new DB cluster. // - // Constraints: If supplied, must match the name of an existing DBSubnetGroup. + // Constraints: If supplied, must match the name of an existing DB subnet group. // // Example: mySubnetgroup DBSubnetGroupName *string `type:"string"` @@ -27709,7 +27724,7 @@ type RestoreDBClusterFromSnapshotInput struct { // false. DeletionProtection *bool `type:"boolean"` - // The list of logs that the restored DB cluster is to export to CloudWatch + // The list of logs that the restored DB cluster is to export to Amazon CloudWatch // Logs. The values in the list depend on the DB engine being used. For more // information, see Publishing Database Logs to Amazon CloudWatch Logs (http://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_LogAccess.html#USER_LogAccess.Procedural.UploadtoCloudWatch) // in the Amazon Aurora User Guide. @@ -27745,8 +27760,8 @@ type RestoreDBClusterFromSnapshotInput struct { // the KMS encryption key used to encrypt the new DB cluster, then you can use // the KMS key alias instead of the ARN for the KMS encryption key. // - // If you do not specify a value for the KmsKeyId parameter, then the following - // will occur: + // If you don't specify a value for the KmsKeyId parameter, then the following + // occurs: // // * If the DB snapshot or DB cluster snapshot in SnapshotIdentifier is encrypted, // then the restored DB cluster is encrypted using the KMS key that was used @@ -27761,7 +27776,7 @@ type RestoreDBClusterFromSnapshotInput struct { // The port number on which the new DB cluster accepts connections. // - // Constraints: Value must be 1150-65535 + // Constraints: This value must be 1150-65535 // // Default: The same port as the original DB cluster. Port *int64 `type:"integer"` @@ -27837,6 +27852,12 @@ func (s *RestoreDBClusterFromSnapshotInput) SetDBClusterIdentifier(v string) *Re return s } +// SetDBClusterParameterGroupName sets the DBClusterParameterGroupName field's value. +func (s *RestoreDBClusterFromSnapshotInput) SetDBClusterParameterGroupName(v string) *RestoreDBClusterFromSnapshotInput { + s.DBClusterParameterGroupName = &v + return s +} + // SetDBSubnetGroupName sets the DBSubnetGroupName field's value. func (s *RestoreDBClusterFromSnapshotInput) SetDBSubnetGroupName(v string) *RestoreDBClusterFromSnapshotInput { s.DBSubnetGroupName = &v @@ -27975,11 +27996,27 @@ type RestoreDBClusterToPointInTimeInput struct { // // * First character must be a letter // - // * Cannot end with a hyphen or contain two consecutive hyphens + // * Can't end with a hyphen or contain two consecutive hyphens // // DBClusterIdentifier is a required field DBClusterIdentifier *string `type:"string" required:"true"` + // The name of the DB cluster parameter group to associate with this DB cluster. + // If this argument is omitted, the default DB cluster parameter group for the + // specified engine is used. + // + // Constraints: + // + // * If supplied, must match the name of an existing DB cluster parameter + // group. + // + // * Must be 1 to 255 letters, numbers, or hyphens. + // + // * First character must be a letter. + // + // * Can't end with a hyphen or contain two consecutive hyphens. + DBClusterParameterGroupName *string `type:"string"` + // The DB subnet group name to use for the new DB cluster. // // Constraints: If supplied, must match the name of an existing DBSubnetGroup. @@ -28017,8 +28054,8 @@ type RestoreDBClusterToPointInTimeInput struct { // cluster. The new DB cluster is encrypted with the KMS key identified by the // KmsKeyId parameter. // - // If you do not specify a value for the KmsKeyId parameter, then the following - // will occur: + // If you don't specify a value for the KmsKeyId parameter, then the following + // occurs: // // * If the DB cluster is encrypted, then the restored DB cluster is encrypted // using the KMS key that was used to encrypt the source DB cluster. @@ -28050,9 +28087,9 @@ type RestoreDBClusterToPointInTimeInput struct { // // * Must be specified if UseLatestRestorableTime parameter is not provided // - // * Cannot be specified if UseLatestRestorableTime parameter is true + // * Can't be specified if UseLatestRestorableTime parameter is true // - // * Cannot be specified if RestoreType parameter is copy-on-write + // * Can't be specified if RestoreType parameter is copy-on-write // // Example: 2015-03-07T23:45:00Z RestoreToTime *time.Time `type:"timestamp"` @@ -28091,7 +28128,7 @@ type RestoreDBClusterToPointInTimeInput struct { // // Default: false // - // Constraints: Cannot be specified if RestoreToTime parameter is provided. + // Constraints: Can't be specified if RestoreToTime parameter is provided. UseLatestRestorableTime *bool `type:"boolean"` // A list of VPC security groups that the new DB cluster belongs to. @@ -28136,6 +28173,12 @@ func (s *RestoreDBClusterToPointInTimeInput) SetDBClusterIdentifier(v string) *R return s } +// SetDBClusterParameterGroupName sets the DBClusterParameterGroupName field's value. +func (s *RestoreDBClusterToPointInTimeInput) SetDBClusterParameterGroupName(v string) *RestoreDBClusterToPointInTimeInput { + s.DBClusterParameterGroupName = &v + return s +} + // SetDBSubnetGroupName sets the DBSubnetGroupName field's value. func (s *RestoreDBClusterToPointInTimeInput) SetDBSubnetGroupName(v string) *RestoreDBClusterToPointInTimeInput { s.DBSubnetGroupName = &v @@ -28279,7 +28322,7 @@ type RestoreDBInstanceFromDBSnapshotInput struct { // // * First character must be a letter // - // * Cannot end with a hyphen or contain two consecutive hyphens + // * Can't end with a hyphen or contain two consecutive hyphens // // Example: my-snapshot-id // @@ -28291,6 +28334,21 @@ type RestoreDBInstanceFromDBSnapshotInput struct { // This parameter doesn't apply to the MySQL, PostgreSQL, or MariaDB engines. DBName *string `type:"string"` + // The name of the DB parameter group to associate with this DB instance. If + // this argument is omitted, the default DBParameterGroup for the specified + // engine is used. + // + // Constraints: + // + // * If supplied, must match the name of an existing DBParameterGroup. + // + // * Must be 1 to 255 letters, numbers, or hyphens. + // + // * First character must be a letter. + // + // * Can't end with a hyphen or contain two consecutive hyphens. + DBParameterGroupName *string `type:"string"` + // The identifier for the DB snapshot to restore from. // // Constraints: @@ -28512,6 +28570,12 @@ func (s *RestoreDBInstanceFromDBSnapshotInput) SetDBName(v string) *RestoreDBIns return s } +// SetDBParameterGroupName sets the DBParameterGroupName field's value. +func (s *RestoreDBInstanceFromDBSnapshotInput) SetDBParameterGroupName(v string) *RestoreDBInstanceFromDBSnapshotInput { + s.DBParameterGroupName = &v + return s +} + // SetDBSnapshotIdentifier sets the DBSnapshotIdentifier field's value. func (s *RestoreDBInstanceFromDBSnapshotInput) SetDBSnapshotIdentifier(v string) *RestoreDBInstanceFromDBSnapshotInput { s.DBSnapshotIdentifier = &v @@ -28720,7 +28784,7 @@ type RestoreDBInstanceFromS3Input struct { // // * First character must be a letter. // - // * Cannot end with a hyphen or contain two consecutive hyphens. + // * Can't end with a hyphen or contain two consecutive hyphens. // // Example: mydbinstance // @@ -28815,7 +28879,7 @@ type RestoreDBInstanceFromS3Input struct { // // * First character must be a letter. // - // * Cannot be a reserved word for the chosen database engine. + // * Can't be a reserved word for the chosen database engine. MasterUsername *string `type:"string"` // The interval, in seconds, between points when Enhanced Monitoring metrics @@ -29323,6 +29387,21 @@ type RestoreDBInstanceToPointInTimeInput struct { // This parameter is not used for the MySQL or MariaDB engines. DBName *string `type:"string"` + // The name of the DB parameter group to associate with this DB instance. If + // this argument is omitted, the default DBParameterGroup for the specified + // engine is used. + // + // Constraints: + // + // * If supplied, must match the name of an existing DBParameterGroup. + // + // * Must be 1 to 255 letters, numbers, or hyphens. + // + // * First character must be a letter. + // + // * Can't end with a hyphen or contain two consecutive hyphens. + DBParameterGroupName *string `type:"string"` + // The DB subnet group name to use for the new instance. // // Constraints: If supplied, must match the name of an existing DBSubnetGroup. @@ -29447,7 +29526,7 @@ type RestoreDBInstanceToPointInTimeInput struct { // // * Must be before the latest restorable time for the DB instance // - // * Cannot be specified if UseLatestRestorableTime parameter is true + // * Can't be specified if UseLatestRestorableTime parameter is true // // Example: 2009-09-07T23:45:00Z RestoreTime *time.Time `type:"timestamp"` @@ -29482,7 +29561,7 @@ type RestoreDBInstanceToPointInTimeInput struct { // // * First character must be a letter // - // * Cannot end with a hyphen or contain two consecutive hyphens + // * Can't end with a hyphen or contain two consecutive hyphens // // TargetDBInstanceIdentifier is a required field TargetDBInstanceIdentifier *string `type:"string" required:"true"` @@ -29503,7 +29582,7 @@ type RestoreDBInstanceToPointInTimeInput struct { // // Default: false // - // Constraints: Cannot be specified if RestoreTime parameter is provided. + // Constraints: Can't be specified if RestoreTime parameter is provided. UseLatestRestorableTime *bool `type:"boolean"` } @@ -29563,6 +29642,12 @@ func (s *RestoreDBInstanceToPointInTimeInput) SetDBName(v string) *RestoreDBInst return s } +// SetDBParameterGroupName sets the DBParameterGroupName field's value. +func (s *RestoreDBInstanceToPointInTimeInput) SetDBParameterGroupName(v string) *RestoreDBInstanceToPointInTimeInput { + s.DBParameterGroupName = &v + return s +} + // SetDBSubnetGroupName sets the DBSubnetGroupName field's value. func (s *RestoreDBInstanceToPointInTimeInput) SetDBSubnetGroupName(v string) *RestoreDBInstanceToPointInTimeInput { s.DBSubnetGroupName = &v diff --git a/service/servicecatalog/api.go b/service/servicecatalog/api.go index 75d03c5acc1..79a4a3a896e 100644 --- a/service/servicecatalog/api.go +++ b/service/servicecatalog/api.go @@ -272,6 +272,93 @@ func (c *ServiceCatalog) AssociateProductWithPortfolioWithContext(ctx aws.Contex return out, req.Send() } +const opAssociateServiceActionWithProvisioningArtifact = "AssociateServiceActionWithProvisioningArtifact" + +// AssociateServiceActionWithProvisioningArtifactRequest generates a "aws/request.Request" representing the +// client's request for the AssociateServiceActionWithProvisioningArtifact operation. The "output" return +// value will be populated with the request's response once the request completes +// successfully. +// +// Use "Send" method on the returned Request to send the API call to the service. +// the "output" return value is not valid until after Send returns without error. +// +// See AssociateServiceActionWithProvisioningArtifact for more information on using the AssociateServiceActionWithProvisioningArtifact +// API call, and error handling. +// +// This method is useful when you want to inject custom logic or configuration +// into the SDK's request lifecycle. Such as custom headers, or retry logic. +// +// +// // Example sending a request using the AssociateServiceActionWithProvisioningArtifactRequest method. +// req, resp := client.AssociateServiceActionWithProvisioningArtifactRequest(params) +// +// err := req.Send() +// if err == nil { // resp is now filled +// fmt.Println(resp) +// } +// +// See also, https://docs.aws.amazon.com/goto/WebAPI/servicecatalog-2015-12-10/AssociateServiceActionWithProvisioningArtifact +func (c *ServiceCatalog) AssociateServiceActionWithProvisioningArtifactRequest(input *AssociateServiceActionWithProvisioningArtifactInput) (req *request.Request, output *AssociateServiceActionWithProvisioningArtifactOutput) { + op := &request.Operation{ + Name: opAssociateServiceActionWithProvisioningArtifact, + HTTPMethod: "POST", + HTTPPath: "/", + } + + if input == nil { + input = &AssociateServiceActionWithProvisioningArtifactInput{} + } + + output = &AssociateServiceActionWithProvisioningArtifactOutput{} + req = c.newRequest(op, input, output) + return +} + +// AssociateServiceActionWithProvisioningArtifact API operation for AWS Service Catalog. +// +// Associates a self-service action with a provisioning artifact. +// +// 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 Service Catalog's +// API operation AssociateServiceActionWithProvisioningArtifact for usage and error information. +// +// Returned Error Codes: +// * ErrCodeResourceNotFoundException "ResourceNotFoundException" +// The specified resource was not found. +// +// * ErrCodeDuplicateResourceException "DuplicateResourceException" +// The specified resource is a duplicate. +// +// * ErrCodeLimitExceededException "LimitExceededException" +// The current limits of the service would have been exceeded by this operation. +// Decrease your resource use or increase your service limits and retry the +// operation. +// +// See also, https://docs.aws.amazon.com/goto/WebAPI/servicecatalog-2015-12-10/AssociateServiceActionWithProvisioningArtifact +func (c *ServiceCatalog) AssociateServiceActionWithProvisioningArtifact(input *AssociateServiceActionWithProvisioningArtifactInput) (*AssociateServiceActionWithProvisioningArtifactOutput, error) { + req, out := c.AssociateServiceActionWithProvisioningArtifactRequest(input) + return out, req.Send() +} + +// AssociateServiceActionWithProvisioningArtifactWithContext is the same as AssociateServiceActionWithProvisioningArtifact with the addition of +// the ability to pass a context and additional request options. +// +// See AssociateServiceActionWithProvisioningArtifact 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 *ServiceCatalog) AssociateServiceActionWithProvisioningArtifactWithContext(ctx aws.Context, input *AssociateServiceActionWithProvisioningArtifactInput, opts ...request.Option) (*AssociateServiceActionWithProvisioningArtifactOutput, error) { + req, out := c.AssociateServiceActionWithProvisioningArtifactRequest(input) + req.SetContext(ctx) + req.ApplyOptions(opts...) + return out, req.Send() +} + const opAssociateTagOptionWithResource = "AssociateTagOptionWithResource" // AssociateTagOptionWithResourceRequest generates a "aws/request.Request" representing the @@ -372,6 +459,165 @@ func (c *ServiceCatalog) AssociateTagOptionWithResourceWithContext(ctx aws.Conte return out, req.Send() } +const opBatchAssociateServiceActionWithProvisioningArtifact = "BatchAssociateServiceActionWithProvisioningArtifact" + +// BatchAssociateServiceActionWithProvisioningArtifactRequest generates a "aws/request.Request" representing the +// client's request for the BatchAssociateServiceActionWithProvisioningArtifact operation. The "output" return +// value will be populated with the request's response once the request completes +// successfully. +// +// Use "Send" method on the returned Request to send the API call to the service. +// the "output" return value is not valid until after Send returns without error. +// +// See BatchAssociateServiceActionWithProvisioningArtifact for more information on using the BatchAssociateServiceActionWithProvisioningArtifact +// API call, and error handling. +// +// This method is useful when you want to inject custom logic or configuration +// into the SDK's request lifecycle. Such as custom headers, or retry logic. +// +// +// // Example sending a request using the BatchAssociateServiceActionWithProvisioningArtifactRequest method. +// req, resp := client.BatchAssociateServiceActionWithProvisioningArtifactRequest(params) +// +// err := req.Send() +// if err == nil { // resp is now filled +// fmt.Println(resp) +// } +// +// See also, https://docs.aws.amazon.com/goto/WebAPI/servicecatalog-2015-12-10/BatchAssociateServiceActionWithProvisioningArtifact +func (c *ServiceCatalog) BatchAssociateServiceActionWithProvisioningArtifactRequest(input *BatchAssociateServiceActionWithProvisioningArtifactInput) (req *request.Request, output *BatchAssociateServiceActionWithProvisioningArtifactOutput) { + op := &request.Operation{ + Name: opBatchAssociateServiceActionWithProvisioningArtifact, + HTTPMethod: "POST", + HTTPPath: "/", + } + + if input == nil { + input = &BatchAssociateServiceActionWithProvisioningArtifactInput{} + } + + output = &BatchAssociateServiceActionWithProvisioningArtifactOutput{} + req = c.newRequest(op, input, output) + return +} + +// BatchAssociateServiceActionWithProvisioningArtifact API operation for AWS Service Catalog. +// +// Associates multiple self-service actions with provisioning artifacts. +// +// 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 Service Catalog's +// API operation BatchAssociateServiceActionWithProvisioningArtifact for usage and error information. +// +// Returned Error Codes: +// * ErrCodeInvalidParametersException "InvalidParametersException" +// One or more parameters provided to the operation are not valid. +// +// See also, https://docs.aws.amazon.com/goto/WebAPI/servicecatalog-2015-12-10/BatchAssociateServiceActionWithProvisioningArtifact +func (c *ServiceCatalog) BatchAssociateServiceActionWithProvisioningArtifact(input *BatchAssociateServiceActionWithProvisioningArtifactInput) (*BatchAssociateServiceActionWithProvisioningArtifactOutput, error) { + req, out := c.BatchAssociateServiceActionWithProvisioningArtifactRequest(input) + return out, req.Send() +} + +// BatchAssociateServiceActionWithProvisioningArtifactWithContext is the same as BatchAssociateServiceActionWithProvisioningArtifact with the addition of +// the ability to pass a context and additional request options. +// +// See BatchAssociateServiceActionWithProvisioningArtifact 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 *ServiceCatalog) BatchAssociateServiceActionWithProvisioningArtifactWithContext(ctx aws.Context, input *BatchAssociateServiceActionWithProvisioningArtifactInput, opts ...request.Option) (*BatchAssociateServiceActionWithProvisioningArtifactOutput, error) { + req, out := c.BatchAssociateServiceActionWithProvisioningArtifactRequest(input) + req.SetContext(ctx) + req.ApplyOptions(opts...) + return out, req.Send() +} + +const opBatchDisassociateServiceActionFromProvisioningArtifact = "BatchDisassociateServiceActionFromProvisioningArtifact" + +// BatchDisassociateServiceActionFromProvisioningArtifactRequest generates a "aws/request.Request" representing the +// client's request for the BatchDisassociateServiceActionFromProvisioningArtifact operation. The "output" return +// value will be populated with the request's response once the request completes +// successfully. +// +// Use "Send" method on the returned Request to send the API call to the service. +// the "output" return value is not valid until after Send returns without error. +// +// See BatchDisassociateServiceActionFromProvisioningArtifact for more information on using the BatchDisassociateServiceActionFromProvisioningArtifact +// API call, and error handling. +// +// This method is useful when you want to inject custom logic or configuration +// into the SDK's request lifecycle. Such as custom headers, or retry logic. +// +// +// // Example sending a request using the BatchDisassociateServiceActionFromProvisioningArtifactRequest method. +// req, resp := client.BatchDisassociateServiceActionFromProvisioningArtifactRequest(params) +// +// err := req.Send() +// if err == nil { // resp is now filled +// fmt.Println(resp) +// } +// +// See also, https://docs.aws.amazon.com/goto/WebAPI/servicecatalog-2015-12-10/BatchDisassociateServiceActionFromProvisioningArtifact +func (c *ServiceCatalog) BatchDisassociateServiceActionFromProvisioningArtifactRequest(input *BatchDisassociateServiceActionFromProvisioningArtifactInput) (req *request.Request, output *BatchDisassociateServiceActionFromProvisioningArtifactOutput) { + op := &request.Operation{ + Name: opBatchDisassociateServiceActionFromProvisioningArtifact, + HTTPMethod: "POST", + HTTPPath: "/", + } + + if input == nil { + input = &BatchDisassociateServiceActionFromProvisioningArtifactInput{} + } + + output = &BatchDisassociateServiceActionFromProvisioningArtifactOutput{} + req = c.newRequest(op, input, output) + return +} + +// BatchDisassociateServiceActionFromProvisioningArtifact API operation for AWS Service Catalog. +// +// Disassociates a batch of self-service actions from the specified provisioning +// artifact. +// +// 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 Service Catalog's +// API operation BatchDisassociateServiceActionFromProvisioningArtifact for usage and error information. +// +// Returned Error Codes: +// * ErrCodeInvalidParametersException "InvalidParametersException" +// One or more parameters provided to the operation are not valid. +// +// See also, https://docs.aws.amazon.com/goto/WebAPI/servicecatalog-2015-12-10/BatchDisassociateServiceActionFromProvisioningArtifact +func (c *ServiceCatalog) BatchDisassociateServiceActionFromProvisioningArtifact(input *BatchDisassociateServiceActionFromProvisioningArtifactInput) (*BatchDisassociateServiceActionFromProvisioningArtifactOutput, error) { + req, out := c.BatchDisassociateServiceActionFromProvisioningArtifactRequest(input) + return out, req.Send() +} + +// BatchDisassociateServiceActionFromProvisioningArtifactWithContext is the same as BatchDisassociateServiceActionFromProvisioningArtifact with the addition of +// the ability to pass a context and additional request options. +// +// See BatchDisassociateServiceActionFromProvisioningArtifact 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 *ServiceCatalog) BatchDisassociateServiceActionFromProvisioningArtifactWithContext(ctx aws.Context, input *BatchDisassociateServiceActionFromProvisioningArtifactInput, opts ...request.Option) (*BatchDisassociateServiceActionFromProvisioningArtifactOutput, error) { + req, out := c.BatchDisassociateServiceActionFromProvisioningArtifactRequest(input) + req.SetContext(ctx) + req.ApplyOptions(opts...) + return out, req.Send() +} + const opCopyProduct = "CopyProduct" // CopyProductRequest generates a "aws/request.Request" representing the @@ -1002,6 +1248,90 @@ func (c *ServiceCatalog) CreateProvisioningArtifactWithContext(ctx aws.Context, return out, req.Send() } +const opCreateServiceAction = "CreateServiceAction" + +// CreateServiceActionRequest generates a "aws/request.Request" representing the +// client's request for the CreateServiceAction operation. The "output" return +// value will be populated with the request's response once the request completes +// successfully. +// +// Use "Send" method on the returned Request to send the API call to the service. +// the "output" return value is not valid until after Send returns without error. +// +// See CreateServiceAction for more information on using the CreateServiceAction +// API call, and error handling. +// +// This method is useful when you want to inject custom logic or configuration +// into the SDK's request lifecycle. Such as custom headers, or retry logic. +// +// +// // Example sending a request using the CreateServiceActionRequest method. +// req, resp := client.CreateServiceActionRequest(params) +// +// err := req.Send() +// if err == nil { // resp is now filled +// fmt.Println(resp) +// } +// +// See also, https://docs.aws.amazon.com/goto/WebAPI/servicecatalog-2015-12-10/CreateServiceAction +func (c *ServiceCatalog) CreateServiceActionRequest(input *CreateServiceActionInput) (req *request.Request, output *CreateServiceActionOutput) { + op := &request.Operation{ + Name: opCreateServiceAction, + HTTPMethod: "POST", + HTTPPath: "/", + } + + if input == nil { + input = &CreateServiceActionInput{} + } + + output = &CreateServiceActionOutput{} + req = c.newRequest(op, input, output) + return +} + +// CreateServiceAction API operation for AWS Service Catalog. +// +// Creates a self-service 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 AWS Service Catalog's +// API operation CreateServiceAction for usage and error information. +// +// Returned Error Codes: +// * ErrCodeInvalidParametersException "InvalidParametersException" +// One or more parameters provided to the operation are not valid. +// +// * ErrCodeLimitExceededException "LimitExceededException" +// The current limits of the service would have been exceeded by this operation. +// Decrease your resource use or increase your service limits and retry the +// operation. +// +// See also, https://docs.aws.amazon.com/goto/WebAPI/servicecatalog-2015-12-10/CreateServiceAction +func (c *ServiceCatalog) CreateServiceAction(input *CreateServiceActionInput) (*CreateServiceActionOutput, error) { + req, out := c.CreateServiceActionRequest(input) + return out, req.Send() +} + +// CreateServiceActionWithContext is the same as CreateServiceAction with the addition of +// the ability to pass a context and additional request options. +// +// See CreateServiceAction 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 *ServiceCatalog) CreateServiceActionWithContext(ctx aws.Context, input *CreateServiceActionInput, opts ...request.Option) (*CreateServiceActionOutput, error) { + req, out := c.CreateServiceActionRequest(input) + req.SetContext(ctx) + req.ApplyOptions(opts...) + return out, req.Send() +} + const opCreateTagOption = "CreateTagOption" // CreateTagOptionRequest generates a "aws/request.Request" representing the @@ -1613,44 +1943,127 @@ func (c *ServiceCatalog) DeleteProvisioningArtifactWithContext(ctx aws.Context, return out, req.Send() } -const opDeleteTagOption = "DeleteTagOption" +const opDeleteServiceAction = "DeleteServiceAction" -// DeleteTagOptionRequest generates a "aws/request.Request" representing the -// client's request for the DeleteTagOption operation. The "output" return +// DeleteServiceActionRequest generates a "aws/request.Request" representing the +// client's request for the DeleteServiceAction operation. The "output" return // value will be populated with the request's response once the request completes // successfully. // // Use "Send" method on the returned Request to send the API call to the service. // the "output" return value is not valid until after Send returns without error. // -// See DeleteTagOption for more information on using the DeleteTagOption +// See DeleteServiceAction for more information on using the DeleteServiceAction // API call, and error handling. // // This method is useful when you want to inject custom logic or configuration // into the SDK's request lifecycle. Such as custom headers, or retry logic. // // -// // Example sending a request using the DeleteTagOptionRequest method. -// req, resp := client.DeleteTagOptionRequest(params) +// // Example sending a request using the DeleteServiceActionRequest method. +// req, resp := client.DeleteServiceActionRequest(params) // // err := req.Send() // if err == nil { // resp is now filled // fmt.Println(resp) // } // -// See also, https://docs.aws.amazon.com/goto/WebAPI/servicecatalog-2015-12-10/DeleteTagOption -func (c *ServiceCatalog) DeleteTagOptionRequest(input *DeleteTagOptionInput) (req *request.Request, output *DeleteTagOptionOutput) { +// See also, https://docs.aws.amazon.com/goto/WebAPI/servicecatalog-2015-12-10/DeleteServiceAction +func (c *ServiceCatalog) DeleteServiceActionRequest(input *DeleteServiceActionInput) (req *request.Request, output *DeleteServiceActionOutput) { op := &request.Operation{ - Name: opDeleteTagOption, + Name: opDeleteServiceAction, HTTPMethod: "POST", HTTPPath: "/", } if input == nil { - input = &DeleteTagOptionInput{} + input = &DeleteServiceActionInput{} } - output = &DeleteTagOptionOutput{} + output = &DeleteServiceActionOutput{} + req = c.newRequest(op, input, output) + return +} + +// DeleteServiceAction API operation for AWS Service Catalog. +// +// Deletes a self-service 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 AWS Service Catalog's +// API operation DeleteServiceAction for usage and error information. +// +// Returned Error Codes: +// * ErrCodeResourceNotFoundException "ResourceNotFoundException" +// The specified resource was not found. +// +// * ErrCodeResourceInUseException "ResourceInUseException" +// A resource that is currently in use. Ensure that the resource is not in use +// and retry the operation. +// +// See also, https://docs.aws.amazon.com/goto/WebAPI/servicecatalog-2015-12-10/DeleteServiceAction +func (c *ServiceCatalog) DeleteServiceAction(input *DeleteServiceActionInput) (*DeleteServiceActionOutput, error) { + req, out := c.DeleteServiceActionRequest(input) + return out, req.Send() +} + +// DeleteServiceActionWithContext is the same as DeleteServiceAction with the addition of +// the ability to pass a context and additional request options. +// +// See DeleteServiceAction 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 *ServiceCatalog) DeleteServiceActionWithContext(ctx aws.Context, input *DeleteServiceActionInput, opts ...request.Option) (*DeleteServiceActionOutput, error) { + req, out := c.DeleteServiceActionRequest(input) + req.SetContext(ctx) + req.ApplyOptions(opts...) + return out, req.Send() +} + +const opDeleteTagOption = "DeleteTagOption" + +// DeleteTagOptionRequest generates a "aws/request.Request" representing the +// client's request for the DeleteTagOption operation. The "output" return +// value will be populated with the request's response once the request completes +// successfully. +// +// Use "Send" method on the returned Request to send the API call to the service. +// the "output" return value is not valid until after Send returns without error. +// +// See DeleteTagOption for more information on using the DeleteTagOption +// API call, and error handling. +// +// This method is useful when you want to inject custom logic or configuration +// into the SDK's request lifecycle. Such as custom headers, or retry logic. +// +// +// // Example sending a request using the DeleteTagOptionRequest method. +// req, resp := client.DeleteTagOptionRequest(params) +// +// err := req.Send() +// if err == nil { // resp is now filled +// fmt.Println(resp) +// } +// +// See also, https://docs.aws.amazon.com/goto/WebAPI/servicecatalog-2015-12-10/DeleteTagOption +func (c *ServiceCatalog) DeleteTagOptionRequest(input *DeleteTagOptionInput) (req *request.Request, output *DeleteTagOptionOutput) { + op := &request.Operation{ + Name: opDeleteTagOption, + HTTPMethod: "POST", + HTTPPath: "/", + } + + if input == nil { + input = &DeleteTagOptionInput{} + } + + output = &DeleteTagOptionOutput{} req = c.newRequest(op, input, output) return } @@ -2597,6 +3010,85 @@ func (c *ServiceCatalog) DescribeRecordWithContext(ctx aws.Context, input *Descr return out, req.Send() } +const opDescribeServiceAction = "DescribeServiceAction" + +// DescribeServiceActionRequest generates a "aws/request.Request" representing the +// client's request for the DescribeServiceAction operation. The "output" return +// value will be populated with the request's response once the request completes +// successfully. +// +// Use "Send" method on the returned Request to send the API call to the service. +// the "output" return value is not valid until after Send returns without error. +// +// See DescribeServiceAction for more information on using the DescribeServiceAction +// API call, and error handling. +// +// This method is useful when you want to inject custom logic or configuration +// into the SDK's request lifecycle. Such as custom headers, or retry logic. +// +// +// // Example sending a request using the DescribeServiceActionRequest method. +// req, resp := client.DescribeServiceActionRequest(params) +// +// err := req.Send() +// if err == nil { // resp is now filled +// fmt.Println(resp) +// } +// +// See also, https://docs.aws.amazon.com/goto/WebAPI/servicecatalog-2015-12-10/DescribeServiceAction +func (c *ServiceCatalog) DescribeServiceActionRequest(input *DescribeServiceActionInput) (req *request.Request, output *DescribeServiceActionOutput) { + op := &request.Operation{ + Name: opDescribeServiceAction, + HTTPMethod: "POST", + HTTPPath: "/", + } + + if input == nil { + input = &DescribeServiceActionInput{} + } + + output = &DescribeServiceActionOutput{} + req = c.newRequest(op, input, output) + return +} + +// DescribeServiceAction API operation for AWS Service Catalog. +// +// Describes a self-service 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 AWS Service Catalog's +// API operation DescribeServiceAction for usage and error information. +// +// Returned Error Codes: +// * ErrCodeResourceNotFoundException "ResourceNotFoundException" +// The specified resource was not found. +// +// See also, https://docs.aws.amazon.com/goto/WebAPI/servicecatalog-2015-12-10/DescribeServiceAction +func (c *ServiceCatalog) DescribeServiceAction(input *DescribeServiceActionInput) (*DescribeServiceActionOutput, error) { + req, out := c.DescribeServiceActionRequest(input) + return out, req.Send() +} + +// DescribeServiceActionWithContext is the same as DescribeServiceAction with the addition of +// the ability to pass a context and additional request options. +// +// See DescribeServiceAction 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 *ServiceCatalog) DescribeServiceActionWithContext(ctx aws.Context, input *DescribeServiceActionInput, opts ...request.Option) (*DescribeServiceActionOutput, error) { + req, out := c.DescribeServiceActionRequest(input) + req.SetContext(ctx) + req.ApplyOptions(opts...) + return out, req.Send() +} + const opDescribeTagOption = "DescribeTagOption" // DescribeTagOptionRequest generates a "aws/request.Request" representing the @@ -2849,6 +3341,86 @@ func (c *ServiceCatalog) DisassociateProductFromPortfolioWithContext(ctx aws.Con return out, req.Send() } +const opDisassociateServiceActionFromProvisioningArtifact = "DisassociateServiceActionFromProvisioningArtifact" + +// DisassociateServiceActionFromProvisioningArtifactRequest generates a "aws/request.Request" representing the +// client's request for the DisassociateServiceActionFromProvisioningArtifact operation. The "output" return +// value will be populated with the request's response once the request completes +// successfully. +// +// Use "Send" method on the returned Request to send the API call to the service. +// the "output" return value is not valid until after Send returns without error. +// +// See DisassociateServiceActionFromProvisioningArtifact for more information on using the DisassociateServiceActionFromProvisioningArtifact +// API call, and error handling. +// +// This method is useful when you want to inject custom logic or configuration +// into the SDK's request lifecycle. Such as custom headers, or retry logic. +// +// +// // Example sending a request using the DisassociateServiceActionFromProvisioningArtifactRequest method. +// req, resp := client.DisassociateServiceActionFromProvisioningArtifactRequest(params) +// +// err := req.Send() +// if err == nil { // resp is now filled +// fmt.Println(resp) +// } +// +// See also, https://docs.aws.amazon.com/goto/WebAPI/servicecatalog-2015-12-10/DisassociateServiceActionFromProvisioningArtifact +func (c *ServiceCatalog) DisassociateServiceActionFromProvisioningArtifactRequest(input *DisassociateServiceActionFromProvisioningArtifactInput) (req *request.Request, output *DisassociateServiceActionFromProvisioningArtifactOutput) { + op := &request.Operation{ + Name: opDisassociateServiceActionFromProvisioningArtifact, + HTTPMethod: "POST", + HTTPPath: "/", + } + + if input == nil { + input = &DisassociateServiceActionFromProvisioningArtifactInput{} + } + + output = &DisassociateServiceActionFromProvisioningArtifactOutput{} + req = c.newRequest(op, input, output) + return +} + +// DisassociateServiceActionFromProvisioningArtifact API operation for AWS Service Catalog. +// +// Disassociates the specified self-service action association from the specified +// provisioning artifact. +// +// 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 Service Catalog's +// API operation DisassociateServiceActionFromProvisioningArtifact for usage and error information. +// +// Returned Error Codes: +// * ErrCodeResourceNotFoundException "ResourceNotFoundException" +// The specified resource was not found. +// +// See also, https://docs.aws.amazon.com/goto/WebAPI/servicecatalog-2015-12-10/DisassociateServiceActionFromProvisioningArtifact +func (c *ServiceCatalog) DisassociateServiceActionFromProvisioningArtifact(input *DisassociateServiceActionFromProvisioningArtifactInput) (*DisassociateServiceActionFromProvisioningArtifactOutput, error) { + req, out := c.DisassociateServiceActionFromProvisioningArtifactRequest(input) + return out, req.Send() +} + +// DisassociateServiceActionFromProvisioningArtifactWithContext is the same as DisassociateServiceActionFromProvisioningArtifact with the addition of +// the ability to pass a context and additional request options. +// +// See DisassociateServiceActionFromProvisioningArtifact 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 *ServiceCatalog) DisassociateServiceActionFromProvisioningArtifactWithContext(ctx aws.Context, input *DisassociateServiceActionFromProvisioningArtifactInput, opts ...request.Option) (*DisassociateServiceActionFromProvisioningArtifactOutput, error) { + req, out := c.DisassociateServiceActionFromProvisioningArtifactRequest(input) + req.SetContext(ctx) + req.ApplyOptions(opts...) + return out, req.Send() +} + const opDisassociateTagOptionFromResource = "DisassociateTagOptionFromResource" // DisassociateTagOptionFromResourceRequest generates a "aws/request.Request" representing the @@ -3021,6 +3593,93 @@ func (c *ServiceCatalog) ExecuteProvisionedProductPlanWithContext(ctx aws.Contex return out, req.Send() } +const opExecuteProvisionedProductServiceAction = "ExecuteProvisionedProductServiceAction" + +// ExecuteProvisionedProductServiceActionRequest generates a "aws/request.Request" representing the +// client's request for the ExecuteProvisionedProductServiceAction operation. The "output" return +// value will be populated with the request's response once the request completes +// successfully. +// +// Use "Send" method on the returned Request to send the API call to the service. +// the "output" return value is not valid until after Send returns without error. +// +// See ExecuteProvisionedProductServiceAction for more information on using the ExecuteProvisionedProductServiceAction +// API call, and error handling. +// +// This method is useful when you want to inject custom logic or configuration +// into the SDK's request lifecycle. Such as custom headers, or retry logic. +// +// +// // Example sending a request using the ExecuteProvisionedProductServiceActionRequest method. +// req, resp := client.ExecuteProvisionedProductServiceActionRequest(params) +// +// err := req.Send() +// if err == nil { // resp is now filled +// fmt.Println(resp) +// } +// +// See also, https://docs.aws.amazon.com/goto/WebAPI/servicecatalog-2015-12-10/ExecuteProvisionedProductServiceAction +func (c *ServiceCatalog) ExecuteProvisionedProductServiceActionRequest(input *ExecuteProvisionedProductServiceActionInput) (req *request.Request, output *ExecuteProvisionedProductServiceActionOutput) { + op := &request.Operation{ + Name: opExecuteProvisionedProductServiceAction, + HTTPMethod: "POST", + HTTPPath: "/", + } + + if input == nil { + input = &ExecuteProvisionedProductServiceActionInput{} + } + + output = &ExecuteProvisionedProductServiceActionOutput{} + req = c.newRequest(op, input, output) + return +} + +// ExecuteProvisionedProductServiceAction API operation for AWS Service Catalog. +// +// Executes a self-service action against a provisioned product. +// +// 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 Service Catalog's +// API operation ExecuteProvisionedProductServiceAction for usage and error information. +// +// Returned Error Codes: +// * ErrCodeInvalidParametersException "InvalidParametersException" +// One or more parameters provided to the operation are not valid. +// +// * ErrCodeResourceNotFoundException "ResourceNotFoundException" +// The specified resource was not found. +// +// * ErrCodeInvalidStateException "InvalidStateException" +// An attempt was made to modify a resource that is in a state that is not valid. +// Check your resources to ensure that they are in valid states before retrying +// the operation. +// +// See also, https://docs.aws.amazon.com/goto/WebAPI/servicecatalog-2015-12-10/ExecuteProvisionedProductServiceAction +func (c *ServiceCatalog) ExecuteProvisionedProductServiceAction(input *ExecuteProvisionedProductServiceActionInput) (*ExecuteProvisionedProductServiceActionOutput, error) { + req, out := c.ExecuteProvisionedProductServiceActionRequest(input) + return out, req.Send() +} + +// ExecuteProvisionedProductServiceActionWithContext is the same as ExecuteProvisionedProductServiceAction with the addition of +// the ability to pass a context and additional request options. +// +// See ExecuteProvisionedProductServiceAction 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 *ServiceCatalog) ExecuteProvisionedProductServiceActionWithContext(ctx aws.Context, input *ExecuteProvisionedProductServiceActionInput, opts ...request.Option) (*ExecuteProvisionedProductServiceActionOutput, error) { + req, out := c.ExecuteProvisionedProductServiceActionRequest(input) + req.SetContext(ctx) + req.ApplyOptions(opts...) + return out, req.Send() +} + const opListAcceptedPortfolioShares = "ListAcceptedPortfolioShares" // ListAcceptedPortfolioSharesRequest generates a "aws/request.Request" representing the @@ -4090,7 +4749,146 @@ func (c *ServiceCatalog) ListProvisioningArtifactsWithContext(ctx aws.Context, i return out, req.Send() } -const opListRecordHistory = "ListRecordHistory" +const opListProvisioningArtifactsForServiceAction = "ListProvisioningArtifactsForServiceAction" + +// ListProvisioningArtifactsForServiceActionRequest generates a "aws/request.Request" representing the +// client's request for the ListProvisioningArtifactsForServiceAction operation. The "output" return +// value will be populated with the request's response once the request completes +// successfully. +// +// Use "Send" method on the returned Request to send the API call to the service. +// the "output" return value is not valid until after Send returns without error. +// +// See ListProvisioningArtifactsForServiceAction for more information on using the ListProvisioningArtifactsForServiceAction +// API call, and error handling. +// +// This method is useful when you want to inject custom logic or configuration +// into the SDK's request lifecycle. Such as custom headers, or retry logic. +// +// +// // Example sending a request using the ListProvisioningArtifactsForServiceActionRequest method. +// req, resp := client.ListProvisioningArtifactsForServiceActionRequest(params) +// +// err := req.Send() +// if err == nil { // resp is now filled +// fmt.Println(resp) +// } +// +// See also, https://docs.aws.amazon.com/goto/WebAPI/servicecatalog-2015-12-10/ListProvisioningArtifactsForServiceAction +func (c *ServiceCatalog) ListProvisioningArtifactsForServiceActionRequest(input *ListProvisioningArtifactsForServiceActionInput) (req *request.Request, output *ListProvisioningArtifactsForServiceActionOutput) { + op := &request.Operation{ + Name: opListProvisioningArtifactsForServiceAction, + HTTPMethod: "POST", + HTTPPath: "/", + Paginator: &request.Paginator{ + InputTokens: []string{"PageToken"}, + OutputTokens: []string{"NextPageToken"}, + LimitToken: "PageSize", + TruncationToken: "", + }, + } + + if input == nil { + input = &ListProvisioningArtifactsForServiceActionInput{} + } + + output = &ListProvisioningArtifactsForServiceActionOutput{} + req = c.newRequest(op, input, output) + return +} + +// ListProvisioningArtifactsForServiceAction API operation for AWS Service Catalog. +// +// Lists all provisioning artifacts (also known as versions) for the specified +// self-service 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 AWS Service Catalog's +// API operation ListProvisioningArtifactsForServiceAction for usage and error information. +// +// Returned Error Codes: +// * ErrCodeResourceNotFoundException "ResourceNotFoundException" +// The specified resource was not found. +// +// * ErrCodeInvalidParametersException "InvalidParametersException" +// One or more parameters provided to the operation are not valid. +// +// See also, https://docs.aws.amazon.com/goto/WebAPI/servicecatalog-2015-12-10/ListProvisioningArtifactsForServiceAction +func (c *ServiceCatalog) ListProvisioningArtifactsForServiceAction(input *ListProvisioningArtifactsForServiceActionInput) (*ListProvisioningArtifactsForServiceActionOutput, error) { + req, out := c.ListProvisioningArtifactsForServiceActionRequest(input) + return out, req.Send() +} + +// ListProvisioningArtifactsForServiceActionWithContext is the same as ListProvisioningArtifactsForServiceAction with the addition of +// the ability to pass a context and additional request options. +// +// See ListProvisioningArtifactsForServiceAction 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 *ServiceCatalog) ListProvisioningArtifactsForServiceActionWithContext(ctx aws.Context, input *ListProvisioningArtifactsForServiceActionInput, opts ...request.Option) (*ListProvisioningArtifactsForServiceActionOutput, error) { + req, out := c.ListProvisioningArtifactsForServiceActionRequest(input) + req.SetContext(ctx) + req.ApplyOptions(opts...) + return out, req.Send() +} + +// ListProvisioningArtifactsForServiceActionPages iterates over the pages of a ListProvisioningArtifactsForServiceAction operation, +// calling the "fn" function with the response data for each page. To stop +// iterating, return false from the fn function. +// +// See ListProvisioningArtifactsForServiceAction 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 ListProvisioningArtifactsForServiceAction operation. +// pageNum := 0 +// err := client.ListProvisioningArtifactsForServiceActionPages(params, +// func(page *ListProvisioningArtifactsForServiceActionOutput, lastPage bool) bool { +// pageNum++ +// fmt.Println(page) +// return pageNum <= 3 +// }) +// +func (c *ServiceCatalog) ListProvisioningArtifactsForServiceActionPages(input *ListProvisioningArtifactsForServiceActionInput, fn func(*ListProvisioningArtifactsForServiceActionOutput, bool) bool) error { + return c.ListProvisioningArtifactsForServiceActionPagesWithContext(aws.BackgroundContext(), input, fn) +} + +// ListProvisioningArtifactsForServiceActionPagesWithContext same as ListProvisioningArtifactsForServiceActionPages 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 *ServiceCatalog) ListProvisioningArtifactsForServiceActionPagesWithContext(ctx aws.Context, input *ListProvisioningArtifactsForServiceActionInput, fn func(*ListProvisioningArtifactsForServiceActionOutput, bool) bool, opts ...request.Option) error { + p := request.Pagination{ + NewRequest: func() (*request.Request, error) { + var inCpy *ListProvisioningArtifactsForServiceActionInput + if input != nil { + tmp := *input + inCpy = &tmp + } + req, _ := c.ListProvisioningArtifactsForServiceActionRequest(inCpy) + req.SetContext(ctx) + req.ApplyOptions(opts...) + return req, nil + }, + } + + cont := true + for p.Next() && cont { + cont = fn(p.Page().(*ListProvisioningArtifactsForServiceActionOutput), !p.HasNextPage()) + } + return p.Err() +} + +const opListRecordHistory = "ListRecordHistory" // ListRecordHistoryRequest generates a "aws/request.Request" representing the // client's request for the ListRecordHistory operation. The "output" return @@ -4312,133 +5110,128 @@ func (c *ServiceCatalog) ListResourcesForTagOptionPagesWithContext(ctx aws.Conte return p.Err() } -const opListTagOptions = "ListTagOptions" +const opListServiceActions = "ListServiceActions" -// ListTagOptionsRequest generates a "aws/request.Request" representing the -// client's request for the ListTagOptions operation. The "output" return +// ListServiceActionsRequest generates a "aws/request.Request" representing the +// client's request for the ListServiceActions operation. The "output" return // value will be populated with the request's response once the request completes // successfully. // // Use "Send" method on the returned Request to send the API call to the service. // the "output" return value is not valid until after Send returns without error. // -// See ListTagOptions for more information on using the ListTagOptions +// See ListServiceActions for more information on using the ListServiceActions // API call, and error handling. // // This method is useful when you want to inject custom logic or configuration // into the SDK's request lifecycle. Such as custom headers, or retry logic. // // -// // Example sending a request using the ListTagOptionsRequest method. -// req, resp := client.ListTagOptionsRequest(params) +// // Example sending a request using the ListServiceActionsRequest method. +// req, resp := client.ListServiceActionsRequest(params) // // err := req.Send() // if err == nil { // resp is now filled // fmt.Println(resp) // } // -// See also, https://docs.aws.amazon.com/goto/WebAPI/servicecatalog-2015-12-10/ListTagOptions -func (c *ServiceCatalog) ListTagOptionsRequest(input *ListTagOptionsInput) (req *request.Request, output *ListTagOptionsOutput) { +// See also, https://docs.aws.amazon.com/goto/WebAPI/servicecatalog-2015-12-10/ListServiceActions +func (c *ServiceCatalog) ListServiceActionsRequest(input *ListServiceActionsInput) (req *request.Request, output *ListServiceActionsOutput) { op := &request.Operation{ - Name: opListTagOptions, + Name: opListServiceActions, HTTPMethod: "POST", HTTPPath: "/", Paginator: &request.Paginator{ InputTokens: []string{"PageToken"}, - OutputTokens: []string{"PageToken"}, + OutputTokens: []string{"NextPageToken"}, LimitToken: "PageSize", TruncationToken: "", }, } if input == nil { - input = &ListTagOptionsInput{} + input = &ListServiceActionsInput{} } - output = &ListTagOptionsOutput{} + output = &ListServiceActionsOutput{} req = c.newRequest(op, input, output) return } -// ListTagOptions API operation for AWS Service Catalog. +// ListServiceActions API operation for AWS Service Catalog. // -// Lists the specified TagOptions or all TagOptions. +// Lists all self-service actions. // // 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 Service Catalog's -// API operation ListTagOptions for usage and error information. +// API operation ListServiceActions for usage and error information. // // Returned Error Codes: -// * ErrCodeTagOptionNotMigratedException "TagOptionNotMigratedException" -// An operation requiring TagOptions failed because the TagOptions migration -// process has not been performed for this account. Please use the AWS console -// to perform the migration process before retrying the operation. -// // * ErrCodeInvalidParametersException "InvalidParametersException" // One or more parameters provided to the operation are not valid. // -// See also, https://docs.aws.amazon.com/goto/WebAPI/servicecatalog-2015-12-10/ListTagOptions -func (c *ServiceCatalog) ListTagOptions(input *ListTagOptionsInput) (*ListTagOptionsOutput, error) { - req, out := c.ListTagOptionsRequest(input) +// See also, https://docs.aws.amazon.com/goto/WebAPI/servicecatalog-2015-12-10/ListServiceActions +func (c *ServiceCatalog) ListServiceActions(input *ListServiceActionsInput) (*ListServiceActionsOutput, error) { + req, out := c.ListServiceActionsRequest(input) return out, req.Send() } -// ListTagOptionsWithContext is the same as ListTagOptions with the addition of +// ListServiceActionsWithContext is the same as ListServiceActions with the addition of // the ability to pass a context and additional request options. // -// See ListTagOptions for details on how to use this API operation. +// See ListServiceActions 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 *ServiceCatalog) ListTagOptionsWithContext(ctx aws.Context, input *ListTagOptionsInput, opts ...request.Option) (*ListTagOptionsOutput, error) { - req, out := c.ListTagOptionsRequest(input) +func (c *ServiceCatalog) ListServiceActionsWithContext(ctx aws.Context, input *ListServiceActionsInput, opts ...request.Option) (*ListServiceActionsOutput, error) { + req, out := c.ListServiceActionsRequest(input) req.SetContext(ctx) req.ApplyOptions(opts...) return out, req.Send() } -// ListTagOptionsPages iterates over the pages of a ListTagOptions operation, +// ListServiceActionsPages iterates over the pages of a ListServiceActions operation, // calling the "fn" function with the response data for each page. To stop // iterating, return false from the fn function. // -// See ListTagOptions method for more information on how to use this operation. +// See ListServiceActions 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 ListTagOptions operation. +// // Example iterating over at most 3 pages of a ListServiceActions operation. // pageNum := 0 -// err := client.ListTagOptionsPages(params, -// func(page *ListTagOptionsOutput, lastPage bool) bool { +// err := client.ListServiceActionsPages(params, +// func(page *ListServiceActionsOutput, lastPage bool) bool { // pageNum++ // fmt.Println(page) // return pageNum <= 3 // }) // -func (c *ServiceCatalog) ListTagOptionsPages(input *ListTagOptionsInput, fn func(*ListTagOptionsOutput, bool) bool) error { - return c.ListTagOptionsPagesWithContext(aws.BackgroundContext(), input, fn) +func (c *ServiceCatalog) ListServiceActionsPages(input *ListServiceActionsInput, fn func(*ListServiceActionsOutput, bool) bool) error { + return c.ListServiceActionsPagesWithContext(aws.BackgroundContext(), input, fn) } -// ListTagOptionsPagesWithContext same as ListTagOptionsPages except +// ListServiceActionsPagesWithContext same as ListServiceActionsPages 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 *ServiceCatalog) ListTagOptionsPagesWithContext(ctx aws.Context, input *ListTagOptionsInput, fn func(*ListTagOptionsOutput, bool) bool, opts ...request.Option) error { +func (c *ServiceCatalog) ListServiceActionsPagesWithContext(ctx aws.Context, input *ListServiceActionsInput, fn func(*ListServiceActionsOutput, bool) bool, opts ...request.Option) error { p := request.Pagination{ NewRequest: func() (*request.Request, error) { - var inCpy *ListTagOptionsInput + var inCpy *ListServiceActionsInput if input != nil { tmp := *input inCpy = &tmp } - req, _ := c.ListTagOptionsRequest(inCpy) + req, _ := c.ListServiceActionsRequest(inCpy) req.SetContext(ctx) req.ApplyOptions(opts...) return req, nil @@ -4447,144 +5240,423 @@ func (c *ServiceCatalog) ListTagOptionsPagesWithContext(ctx aws.Context, input * cont := true for p.Next() && cont { - cont = fn(p.Page().(*ListTagOptionsOutput), !p.HasNextPage()) + cont = fn(p.Page().(*ListServiceActionsOutput), !p.HasNextPage()) } return p.Err() } -const opProvisionProduct = "ProvisionProduct" +const opListServiceActionsForProvisioningArtifact = "ListServiceActionsForProvisioningArtifact" -// ProvisionProductRequest generates a "aws/request.Request" representing the -// client's request for the ProvisionProduct operation. The "output" return +// ListServiceActionsForProvisioningArtifactRequest generates a "aws/request.Request" representing the +// client's request for the ListServiceActionsForProvisioningArtifact operation. The "output" return // value will be populated with the request's response once the request completes // successfully. // // Use "Send" method on the returned Request to send the API call to the service. // the "output" return value is not valid until after Send returns without error. // -// See ProvisionProduct for more information on using the ProvisionProduct +// See ListServiceActionsForProvisioningArtifact for more information on using the ListServiceActionsForProvisioningArtifact // API call, and error handling. // // This method is useful when you want to inject custom logic or configuration // into the SDK's request lifecycle. Such as custom headers, or retry logic. // // -// // Example sending a request using the ProvisionProductRequest method. -// req, resp := client.ProvisionProductRequest(params) +// // Example sending a request using the ListServiceActionsForProvisioningArtifactRequest method. +// req, resp := client.ListServiceActionsForProvisioningArtifactRequest(params) // // err := req.Send() // if err == nil { // resp is now filled // fmt.Println(resp) // } // -// See also, https://docs.aws.amazon.com/goto/WebAPI/servicecatalog-2015-12-10/ProvisionProduct -func (c *ServiceCatalog) ProvisionProductRequest(input *ProvisionProductInput) (req *request.Request, output *ProvisionProductOutput) { +// See also, https://docs.aws.amazon.com/goto/WebAPI/servicecatalog-2015-12-10/ListServiceActionsForProvisioningArtifact +func (c *ServiceCatalog) ListServiceActionsForProvisioningArtifactRequest(input *ListServiceActionsForProvisioningArtifactInput) (req *request.Request, output *ListServiceActionsForProvisioningArtifactOutput) { op := &request.Operation{ - Name: opProvisionProduct, + Name: opListServiceActionsForProvisioningArtifact, HTTPMethod: "POST", HTTPPath: "/", + Paginator: &request.Paginator{ + InputTokens: []string{"PageToken"}, + OutputTokens: []string{"NextPageToken"}, + LimitToken: "PageSize", + TruncationToken: "", + }, } if input == nil { - input = &ProvisionProductInput{} + input = &ListServiceActionsForProvisioningArtifactInput{} } - output = &ProvisionProductOutput{} + output = &ListServiceActionsForProvisioningArtifactOutput{} req = c.newRequest(op, input, output) return } -// ProvisionProduct API operation for AWS Service Catalog. -// -// Provisions the specified product. -// -// A provisioned product is a resourced instance of a product. For example, -// provisioning a product based on a CloudFormation template launches a CloudFormation -// stack and its underlying resources. You can check the status of this request -// using DescribeRecord. +// ListServiceActionsForProvisioningArtifact API operation for AWS Service Catalog. // -// If the request contains a tag key with an empty list of values, there is -// a tag conflict for that key. Do not include conflicted keys as tags, or this -// causes the error "Parameter validation failed: Missing required parameter -// in Tags[N]:Value". +// Returns a paginated list of self-service actions associated with the specified +// Product ID and Provisioning Artifact 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 AWS Service Catalog's -// API operation ProvisionProduct for usage and error information. +// API operation ListServiceActionsForProvisioningArtifact for usage and error information. // // Returned Error Codes: -// * ErrCodeInvalidParametersException "InvalidParametersException" -// One or more parameters provided to the operation are not valid. -// // * ErrCodeResourceNotFoundException "ResourceNotFoundException" // The specified resource was not found. // -// * ErrCodeDuplicateResourceException "DuplicateResourceException" -// The specified resource is a duplicate. +// * ErrCodeInvalidParametersException "InvalidParametersException" +// One or more parameters provided to the operation are not valid. // -// See also, https://docs.aws.amazon.com/goto/WebAPI/servicecatalog-2015-12-10/ProvisionProduct -func (c *ServiceCatalog) ProvisionProduct(input *ProvisionProductInput) (*ProvisionProductOutput, error) { - req, out := c.ProvisionProductRequest(input) +// See also, https://docs.aws.amazon.com/goto/WebAPI/servicecatalog-2015-12-10/ListServiceActionsForProvisioningArtifact +func (c *ServiceCatalog) ListServiceActionsForProvisioningArtifact(input *ListServiceActionsForProvisioningArtifactInput) (*ListServiceActionsForProvisioningArtifactOutput, error) { + req, out := c.ListServiceActionsForProvisioningArtifactRequest(input) return out, req.Send() } -// ProvisionProductWithContext is the same as ProvisionProduct with the addition of +// ListServiceActionsForProvisioningArtifactWithContext is the same as ListServiceActionsForProvisioningArtifact with the addition of // the ability to pass a context and additional request options. // -// See ProvisionProduct for details on how to use this API operation. +// See ListServiceActionsForProvisioningArtifact 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 *ServiceCatalog) ProvisionProductWithContext(ctx aws.Context, input *ProvisionProductInput, opts ...request.Option) (*ProvisionProductOutput, error) { - req, out := c.ProvisionProductRequest(input) +func (c *ServiceCatalog) ListServiceActionsForProvisioningArtifactWithContext(ctx aws.Context, input *ListServiceActionsForProvisioningArtifactInput, opts ...request.Option) (*ListServiceActionsForProvisioningArtifactOutput, error) { + req, out := c.ListServiceActionsForProvisioningArtifactRequest(input) req.SetContext(ctx) req.ApplyOptions(opts...) return out, req.Send() } -const opRejectPortfolioShare = "RejectPortfolioShare" +// ListServiceActionsForProvisioningArtifactPages iterates over the pages of a ListServiceActionsForProvisioningArtifact operation, +// calling the "fn" function with the response data for each page. To stop +// iterating, return false from the fn function. +// +// See ListServiceActionsForProvisioningArtifact 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 ListServiceActionsForProvisioningArtifact operation. +// pageNum := 0 +// err := client.ListServiceActionsForProvisioningArtifactPages(params, +// func(page *ListServiceActionsForProvisioningArtifactOutput, lastPage bool) bool { +// pageNum++ +// fmt.Println(page) +// return pageNum <= 3 +// }) +// +func (c *ServiceCatalog) ListServiceActionsForProvisioningArtifactPages(input *ListServiceActionsForProvisioningArtifactInput, fn func(*ListServiceActionsForProvisioningArtifactOutput, bool) bool) error { + return c.ListServiceActionsForProvisioningArtifactPagesWithContext(aws.BackgroundContext(), input, fn) +} -// RejectPortfolioShareRequest generates a "aws/request.Request" representing the -// client's request for the RejectPortfolioShare operation. The "output" return +// ListServiceActionsForProvisioningArtifactPagesWithContext same as ListServiceActionsForProvisioningArtifactPages 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 *ServiceCatalog) ListServiceActionsForProvisioningArtifactPagesWithContext(ctx aws.Context, input *ListServiceActionsForProvisioningArtifactInput, fn func(*ListServiceActionsForProvisioningArtifactOutput, bool) bool, opts ...request.Option) error { + p := request.Pagination{ + NewRequest: func() (*request.Request, error) { + var inCpy *ListServiceActionsForProvisioningArtifactInput + if input != nil { + tmp := *input + inCpy = &tmp + } + req, _ := c.ListServiceActionsForProvisioningArtifactRequest(inCpy) + req.SetContext(ctx) + req.ApplyOptions(opts...) + return req, nil + }, + } + + cont := true + for p.Next() && cont { + cont = fn(p.Page().(*ListServiceActionsForProvisioningArtifactOutput), !p.HasNextPage()) + } + return p.Err() +} + +const opListTagOptions = "ListTagOptions" + +// ListTagOptionsRequest generates a "aws/request.Request" representing the +// client's request for the ListTagOptions operation. The "output" return // value will be populated with the request's response once the request completes // successfully. // // Use "Send" method on the returned Request to send the API call to the service. // the "output" return value is not valid until after Send returns without error. // -// See RejectPortfolioShare for more information on using the RejectPortfolioShare +// See ListTagOptions for more information on using the ListTagOptions // API call, and error handling. // // This method is useful when you want to inject custom logic or configuration // into the SDK's request lifecycle. Such as custom headers, or retry logic. // // -// // Example sending a request using the RejectPortfolioShareRequest method. -// req, resp := client.RejectPortfolioShareRequest(params) +// // Example sending a request using the ListTagOptionsRequest method. +// req, resp := client.ListTagOptionsRequest(params) // // err := req.Send() // if err == nil { // resp is now filled // fmt.Println(resp) // } // -// See also, https://docs.aws.amazon.com/goto/WebAPI/servicecatalog-2015-12-10/RejectPortfolioShare -func (c *ServiceCatalog) RejectPortfolioShareRequest(input *RejectPortfolioShareInput) (req *request.Request, output *RejectPortfolioShareOutput) { +// See also, https://docs.aws.amazon.com/goto/WebAPI/servicecatalog-2015-12-10/ListTagOptions +func (c *ServiceCatalog) ListTagOptionsRequest(input *ListTagOptionsInput) (req *request.Request, output *ListTagOptionsOutput) { op := &request.Operation{ - Name: opRejectPortfolioShare, + Name: opListTagOptions, HTTPMethod: "POST", HTTPPath: "/", + Paginator: &request.Paginator{ + InputTokens: []string{"PageToken"}, + OutputTokens: []string{"PageToken"}, + LimitToken: "PageSize", + TruncationToken: "", + }, } if input == nil { - input = &RejectPortfolioShareInput{} + input = &ListTagOptionsInput{} } - output = &RejectPortfolioShareOutput{} + output = &ListTagOptionsOutput{} + req = c.newRequest(op, input, output) + return +} + +// ListTagOptions API operation for AWS Service Catalog. +// +// Lists the specified TagOptions or all TagOptions. +// +// 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 Service Catalog's +// API operation ListTagOptions for usage and error information. +// +// Returned Error Codes: +// * ErrCodeTagOptionNotMigratedException "TagOptionNotMigratedException" +// An operation requiring TagOptions failed because the TagOptions migration +// process has not been performed for this account. Please use the AWS console +// to perform the migration process before retrying the operation. +// +// * ErrCodeInvalidParametersException "InvalidParametersException" +// One or more parameters provided to the operation are not valid. +// +// See also, https://docs.aws.amazon.com/goto/WebAPI/servicecatalog-2015-12-10/ListTagOptions +func (c *ServiceCatalog) ListTagOptions(input *ListTagOptionsInput) (*ListTagOptionsOutput, error) { + req, out := c.ListTagOptionsRequest(input) + return out, req.Send() +} + +// ListTagOptionsWithContext is the same as ListTagOptions with the addition of +// the ability to pass a context and additional request options. +// +// See ListTagOptions 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 *ServiceCatalog) ListTagOptionsWithContext(ctx aws.Context, input *ListTagOptionsInput, opts ...request.Option) (*ListTagOptionsOutput, error) { + req, out := c.ListTagOptionsRequest(input) + req.SetContext(ctx) + req.ApplyOptions(opts...) + return out, req.Send() +} + +// ListTagOptionsPages iterates over the pages of a ListTagOptions operation, +// calling the "fn" function with the response data for each page. To stop +// iterating, return false from the fn function. +// +// See ListTagOptions 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 ListTagOptions operation. +// pageNum := 0 +// err := client.ListTagOptionsPages(params, +// func(page *ListTagOptionsOutput, lastPage bool) bool { +// pageNum++ +// fmt.Println(page) +// return pageNum <= 3 +// }) +// +func (c *ServiceCatalog) ListTagOptionsPages(input *ListTagOptionsInput, fn func(*ListTagOptionsOutput, bool) bool) error { + return c.ListTagOptionsPagesWithContext(aws.BackgroundContext(), input, fn) +} + +// ListTagOptionsPagesWithContext same as ListTagOptionsPages 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 *ServiceCatalog) ListTagOptionsPagesWithContext(ctx aws.Context, input *ListTagOptionsInput, fn func(*ListTagOptionsOutput, bool) bool, opts ...request.Option) error { + p := request.Pagination{ + NewRequest: func() (*request.Request, error) { + var inCpy *ListTagOptionsInput + if input != nil { + tmp := *input + inCpy = &tmp + } + req, _ := c.ListTagOptionsRequest(inCpy) + req.SetContext(ctx) + req.ApplyOptions(opts...) + return req, nil + }, + } + + cont := true + for p.Next() && cont { + cont = fn(p.Page().(*ListTagOptionsOutput), !p.HasNextPage()) + } + return p.Err() +} + +const opProvisionProduct = "ProvisionProduct" + +// ProvisionProductRequest generates a "aws/request.Request" representing the +// client's request for the ProvisionProduct operation. The "output" return +// value will be populated with the request's response once the request completes +// successfully. +// +// Use "Send" method on the returned Request to send the API call to the service. +// the "output" return value is not valid until after Send returns without error. +// +// See ProvisionProduct for more information on using the ProvisionProduct +// API call, and error handling. +// +// This method is useful when you want to inject custom logic or configuration +// into the SDK's request lifecycle. Such as custom headers, or retry logic. +// +// +// // Example sending a request using the ProvisionProductRequest method. +// req, resp := client.ProvisionProductRequest(params) +// +// err := req.Send() +// if err == nil { // resp is now filled +// fmt.Println(resp) +// } +// +// See also, https://docs.aws.amazon.com/goto/WebAPI/servicecatalog-2015-12-10/ProvisionProduct +func (c *ServiceCatalog) ProvisionProductRequest(input *ProvisionProductInput) (req *request.Request, output *ProvisionProductOutput) { + op := &request.Operation{ + Name: opProvisionProduct, + HTTPMethod: "POST", + HTTPPath: "/", + } + + if input == nil { + input = &ProvisionProductInput{} + } + + output = &ProvisionProductOutput{} + req = c.newRequest(op, input, output) + return +} + +// ProvisionProduct API operation for AWS Service Catalog. +// +// Provisions the specified product. +// +// A provisioned product is a resourced instance of a product. For example, +// provisioning a product based on a CloudFormation template launches a CloudFormation +// stack and its underlying resources. You can check the status of this request +// using DescribeRecord. +// +// If the request contains a tag key with an empty list of values, there is +// a tag conflict for that key. Do not include conflicted keys as tags, or this +// causes the error "Parameter validation failed: Missing required parameter +// in Tags[N]:Value". +// +// 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 Service Catalog's +// API operation ProvisionProduct for usage and error information. +// +// Returned Error Codes: +// * ErrCodeInvalidParametersException "InvalidParametersException" +// One or more parameters provided to the operation are not valid. +// +// * ErrCodeResourceNotFoundException "ResourceNotFoundException" +// The specified resource was not found. +// +// * ErrCodeDuplicateResourceException "DuplicateResourceException" +// The specified resource is a duplicate. +// +// See also, https://docs.aws.amazon.com/goto/WebAPI/servicecatalog-2015-12-10/ProvisionProduct +func (c *ServiceCatalog) ProvisionProduct(input *ProvisionProductInput) (*ProvisionProductOutput, error) { + req, out := c.ProvisionProductRequest(input) + return out, req.Send() +} + +// ProvisionProductWithContext is the same as ProvisionProduct with the addition of +// the ability to pass a context and additional request options. +// +// See ProvisionProduct 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 *ServiceCatalog) ProvisionProductWithContext(ctx aws.Context, input *ProvisionProductInput, opts ...request.Option) (*ProvisionProductOutput, error) { + req, out := c.ProvisionProductRequest(input) + req.SetContext(ctx) + req.ApplyOptions(opts...) + return out, req.Send() +} + +const opRejectPortfolioShare = "RejectPortfolioShare" + +// RejectPortfolioShareRequest generates a "aws/request.Request" representing the +// client's request for the RejectPortfolioShare operation. The "output" return +// value will be populated with the request's response once the request completes +// successfully. +// +// Use "Send" method on the returned Request to send the API call to the service. +// the "output" return value is not valid until after Send returns without error. +// +// See RejectPortfolioShare for more information on using the RejectPortfolioShare +// API call, and error handling. +// +// This method is useful when you want to inject custom logic or configuration +// into the SDK's request lifecycle. Such as custom headers, or retry logic. +// +// +// // Example sending a request using the RejectPortfolioShareRequest method. +// req, resp := client.RejectPortfolioShareRequest(params) +// +// err := req.Send() +// if err == nil { // resp is now filled +// fmt.Println(resp) +// } +// +// See also, https://docs.aws.amazon.com/goto/WebAPI/servicecatalog-2015-12-10/RejectPortfolioShare +func (c *ServiceCatalog) RejectPortfolioShareRequest(input *RejectPortfolioShareInput) (req *request.Request, output *RejectPortfolioShareOutput) { + op := &request.Operation{ + Name: opRejectPortfolioShare, + HTTPMethod: "POST", + HTTPPath: "/", + } + + if input == nil { + input = &RejectPortfolioShareInput{} + } + + output = &RejectPortfolioShareOutput{} req = c.newRequest(op, input, output) return } @@ -5637,81 +6709,163 @@ func (c *ServiceCatalog) UpdateProvisioningArtifactWithContext(ctx aws.Context, return out, req.Send() } -const opUpdateTagOption = "UpdateTagOption" +const opUpdateServiceAction = "UpdateServiceAction" -// UpdateTagOptionRequest generates a "aws/request.Request" representing the -// client's request for the UpdateTagOption operation. The "output" return +// UpdateServiceActionRequest generates a "aws/request.Request" representing the +// client's request for the UpdateServiceAction operation. The "output" return // value will be populated with the request's response once the request completes // successfully. // // Use "Send" method on the returned Request to send the API call to the service. // the "output" return value is not valid until after Send returns without error. // -// See UpdateTagOption for more information on using the UpdateTagOption +// See UpdateServiceAction for more information on using the UpdateServiceAction // API call, and error handling. // // This method is useful when you want to inject custom logic or configuration // into the SDK's request lifecycle. Such as custom headers, or retry logic. // // -// // Example sending a request using the UpdateTagOptionRequest method. -// req, resp := client.UpdateTagOptionRequest(params) +// // Example sending a request using the UpdateServiceActionRequest method. +// req, resp := client.UpdateServiceActionRequest(params) // // err := req.Send() // if err == nil { // resp is now filled // fmt.Println(resp) // } // -// See also, https://docs.aws.amazon.com/goto/WebAPI/servicecatalog-2015-12-10/UpdateTagOption -func (c *ServiceCatalog) UpdateTagOptionRequest(input *UpdateTagOptionInput) (req *request.Request, output *UpdateTagOptionOutput) { +// See also, https://docs.aws.amazon.com/goto/WebAPI/servicecatalog-2015-12-10/UpdateServiceAction +func (c *ServiceCatalog) UpdateServiceActionRequest(input *UpdateServiceActionInput) (req *request.Request, output *UpdateServiceActionOutput) { op := &request.Operation{ - Name: opUpdateTagOption, + Name: opUpdateServiceAction, HTTPMethod: "POST", HTTPPath: "/", } if input == nil { - input = &UpdateTagOptionInput{} + input = &UpdateServiceActionInput{} } - output = &UpdateTagOptionOutput{} + output = &UpdateServiceActionOutput{} req = c.newRequest(op, input, output) return } -// UpdateTagOption API operation for AWS Service Catalog. +// UpdateServiceAction API operation for AWS Service Catalog. // -// Updates the specified TagOption. +// Updates a self-service 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 AWS Service Catalog's -// API operation UpdateTagOption for usage and error information. +// API operation UpdateServiceAction for usage and error information. // // Returned Error Codes: -// * ErrCodeTagOptionNotMigratedException "TagOptionNotMigratedException" -// An operation requiring TagOptions failed because the TagOptions migration -// process has not been performed for this account. Please use the AWS console -// to perform the migration process before retrying the operation. -// // * ErrCodeResourceNotFoundException "ResourceNotFoundException" // The specified resource was not found. // -// * ErrCodeDuplicateResourceException "DuplicateResourceException" -// The specified resource is a duplicate. -// // * ErrCodeInvalidParametersException "InvalidParametersException" // One or more parameters provided to the operation are not valid. // -// See also, https://docs.aws.amazon.com/goto/WebAPI/servicecatalog-2015-12-10/UpdateTagOption -func (c *ServiceCatalog) UpdateTagOption(input *UpdateTagOptionInput) (*UpdateTagOptionOutput, error) { - req, out := c.UpdateTagOptionRequest(input) +// See also, https://docs.aws.amazon.com/goto/WebAPI/servicecatalog-2015-12-10/UpdateServiceAction +func (c *ServiceCatalog) UpdateServiceAction(input *UpdateServiceActionInput) (*UpdateServiceActionOutput, error) { + req, out := c.UpdateServiceActionRequest(input) return out, req.Send() } -// UpdateTagOptionWithContext is the same as UpdateTagOption with the addition of +// UpdateServiceActionWithContext is the same as UpdateServiceAction with the addition of +// the ability to pass a context and additional request options. +// +// See UpdateServiceAction 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 *ServiceCatalog) UpdateServiceActionWithContext(ctx aws.Context, input *UpdateServiceActionInput, opts ...request.Option) (*UpdateServiceActionOutput, error) { + req, out := c.UpdateServiceActionRequest(input) + req.SetContext(ctx) + req.ApplyOptions(opts...) + return out, req.Send() +} + +const opUpdateTagOption = "UpdateTagOption" + +// UpdateTagOptionRequest generates a "aws/request.Request" representing the +// client's request for the UpdateTagOption operation. The "output" return +// value will be populated with the request's response once the request completes +// successfully. +// +// Use "Send" method on the returned Request to send the API call to the service. +// the "output" return value is not valid until after Send returns without error. +// +// See UpdateTagOption for more information on using the UpdateTagOption +// API call, and error handling. +// +// This method is useful when you want to inject custom logic or configuration +// into the SDK's request lifecycle. Such as custom headers, or retry logic. +// +// +// // Example sending a request using the UpdateTagOptionRequest method. +// req, resp := client.UpdateTagOptionRequest(params) +// +// err := req.Send() +// if err == nil { // resp is now filled +// fmt.Println(resp) +// } +// +// See also, https://docs.aws.amazon.com/goto/WebAPI/servicecatalog-2015-12-10/UpdateTagOption +func (c *ServiceCatalog) UpdateTagOptionRequest(input *UpdateTagOptionInput) (req *request.Request, output *UpdateTagOptionOutput) { + op := &request.Operation{ + Name: opUpdateTagOption, + HTTPMethod: "POST", + HTTPPath: "/", + } + + if input == nil { + input = &UpdateTagOptionInput{} + } + + output = &UpdateTagOptionOutput{} + req = c.newRequest(op, input, output) + return +} + +// UpdateTagOption API operation for AWS Service Catalog. +// +// Updates the specified TagOption. +// +// 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 Service Catalog's +// API operation UpdateTagOption for usage and error information. +// +// Returned Error Codes: +// * ErrCodeTagOptionNotMigratedException "TagOptionNotMigratedException" +// An operation requiring TagOptions failed because the TagOptions migration +// process has not been performed for this account. Please use the AWS console +// to perform the migration process before retrying the operation. +// +// * ErrCodeResourceNotFoundException "ResourceNotFoundException" +// The specified resource was not found. +// +// * ErrCodeDuplicateResourceException "DuplicateResourceException" +// The specified resource is a duplicate. +// +// * ErrCodeInvalidParametersException "InvalidParametersException" +// One or more parameters provided to the operation are not valid. +// +// See also, https://docs.aws.amazon.com/goto/WebAPI/servicecatalog-2015-12-10/UpdateTagOption +func (c *ServiceCatalog) UpdateTagOption(input *UpdateTagOptionInput) (*UpdateTagOptionOutput, error) { + req, out := c.UpdateTagOptionRequest(input) + return out, req.Send() +} + +// UpdateTagOptionWithContext is the same as UpdateTagOption with the addition of // the ability to pass a context and additional request options. // // See UpdateTagOption for details on how to use this API operation. @@ -5911,33 +7065,305 @@ func (s *AssociatePrincipalWithPortfolioInput) SetPortfolioId(v string) *Associa return s } -// SetPrincipalARN sets the PrincipalARN field's value. -func (s *AssociatePrincipalWithPortfolioInput) SetPrincipalARN(v string) *AssociatePrincipalWithPortfolioInput { - s.PrincipalARN = &v +// SetPrincipalARN sets the PrincipalARN field's value. +func (s *AssociatePrincipalWithPortfolioInput) SetPrincipalARN(v string) *AssociatePrincipalWithPortfolioInput { + s.PrincipalARN = &v + return s +} + +// SetPrincipalType sets the PrincipalType field's value. +func (s *AssociatePrincipalWithPortfolioInput) SetPrincipalType(v string) *AssociatePrincipalWithPortfolioInput { + s.PrincipalType = &v + return s +} + +type AssociatePrincipalWithPortfolioOutput struct { + _ struct{} `type:"structure"` +} + +// String returns the string representation +func (s AssociatePrincipalWithPortfolioOutput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s AssociatePrincipalWithPortfolioOutput) GoString() string { + return s.String() +} + +type AssociateProductWithPortfolioInput struct { + _ struct{} `type:"structure"` + + // The language code. + // + // * en - English (default) + // + // * jp - Japanese + // + // * zh - Chinese + AcceptLanguage *string `type:"string"` + + // The portfolio identifier. + // + // PortfolioId is a required field + PortfolioId *string `min:"1" type:"string" required:"true"` + + // The product identifier. + // + // ProductId is a required field + ProductId *string `min:"1" type:"string" required:"true"` + + // The identifier of the source portfolio. + SourcePortfolioId *string `min:"1" type:"string"` +} + +// String returns the string representation +func (s AssociateProductWithPortfolioInput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s AssociateProductWithPortfolioInput) GoString() string { + return s.String() +} + +// Validate inspects the fields of the type to determine if they are valid. +func (s *AssociateProductWithPortfolioInput) Validate() error { + invalidParams := request.ErrInvalidParams{Context: "AssociateProductWithPortfolioInput"} + if s.PortfolioId == nil { + invalidParams.Add(request.NewErrParamRequired("PortfolioId")) + } + if s.PortfolioId != nil && len(*s.PortfolioId) < 1 { + invalidParams.Add(request.NewErrParamMinLen("PortfolioId", 1)) + } + if s.ProductId == nil { + invalidParams.Add(request.NewErrParamRequired("ProductId")) + } + if s.ProductId != nil && len(*s.ProductId) < 1 { + invalidParams.Add(request.NewErrParamMinLen("ProductId", 1)) + } + if s.SourcePortfolioId != nil && len(*s.SourcePortfolioId) < 1 { + invalidParams.Add(request.NewErrParamMinLen("SourcePortfolioId", 1)) + } + + if invalidParams.Len() > 0 { + return invalidParams + } + return nil +} + +// SetAcceptLanguage sets the AcceptLanguage field's value. +func (s *AssociateProductWithPortfolioInput) SetAcceptLanguage(v string) *AssociateProductWithPortfolioInput { + s.AcceptLanguage = &v + return s +} + +// SetPortfolioId sets the PortfolioId field's value. +func (s *AssociateProductWithPortfolioInput) SetPortfolioId(v string) *AssociateProductWithPortfolioInput { + s.PortfolioId = &v + return s +} + +// SetProductId sets the ProductId field's value. +func (s *AssociateProductWithPortfolioInput) SetProductId(v string) *AssociateProductWithPortfolioInput { + s.ProductId = &v + return s +} + +// SetSourcePortfolioId sets the SourcePortfolioId field's value. +func (s *AssociateProductWithPortfolioInput) SetSourcePortfolioId(v string) *AssociateProductWithPortfolioInput { + s.SourcePortfolioId = &v + return s +} + +type AssociateProductWithPortfolioOutput struct { + _ struct{} `type:"structure"` +} + +// String returns the string representation +func (s AssociateProductWithPortfolioOutput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s AssociateProductWithPortfolioOutput) GoString() string { + return s.String() +} + +type AssociateServiceActionWithProvisioningArtifactInput struct { + _ struct{} `type:"structure"` + + // The language code. + // + // * en - English (default) + // + // * jp - Japanese + // + // * zh - Chinese + AcceptLanguage *string `type:"string"` + + // The product identifier. For example, prod-abcdzk7xy33qa. + // + // ProductId is a required field + ProductId *string `min:"1" type:"string" required:"true"` + + // The identifier of the provisioning artifact. For example, pa-4abcdjnxjj6ne. + // + // ProvisioningArtifactId is a required field + ProvisioningArtifactId *string `min:"1" type:"string" required:"true"` + + // The self-service action identifier. For example, act-fs7abcd89wxyz. + // + // ServiceActionId is a required field + ServiceActionId *string `min:"1" type:"string" required:"true"` +} + +// String returns the string representation +func (s AssociateServiceActionWithProvisioningArtifactInput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s AssociateServiceActionWithProvisioningArtifactInput) GoString() string { + return s.String() +} + +// Validate inspects the fields of the type to determine if they are valid. +func (s *AssociateServiceActionWithProvisioningArtifactInput) Validate() error { + invalidParams := request.ErrInvalidParams{Context: "AssociateServiceActionWithProvisioningArtifactInput"} + if s.ProductId == nil { + invalidParams.Add(request.NewErrParamRequired("ProductId")) + } + if s.ProductId != nil && len(*s.ProductId) < 1 { + invalidParams.Add(request.NewErrParamMinLen("ProductId", 1)) + } + if s.ProvisioningArtifactId == nil { + invalidParams.Add(request.NewErrParamRequired("ProvisioningArtifactId")) + } + if s.ProvisioningArtifactId != nil && len(*s.ProvisioningArtifactId) < 1 { + invalidParams.Add(request.NewErrParamMinLen("ProvisioningArtifactId", 1)) + } + if s.ServiceActionId == nil { + invalidParams.Add(request.NewErrParamRequired("ServiceActionId")) + } + if s.ServiceActionId != nil && len(*s.ServiceActionId) < 1 { + invalidParams.Add(request.NewErrParamMinLen("ServiceActionId", 1)) + } + + if invalidParams.Len() > 0 { + return invalidParams + } + return nil +} + +// SetAcceptLanguage sets the AcceptLanguage field's value. +func (s *AssociateServiceActionWithProvisioningArtifactInput) SetAcceptLanguage(v string) *AssociateServiceActionWithProvisioningArtifactInput { + s.AcceptLanguage = &v + return s +} + +// SetProductId sets the ProductId field's value. +func (s *AssociateServiceActionWithProvisioningArtifactInput) SetProductId(v string) *AssociateServiceActionWithProvisioningArtifactInput { + s.ProductId = &v + return s +} + +// SetProvisioningArtifactId sets the ProvisioningArtifactId field's value. +func (s *AssociateServiceActionWithProvisioningArtifactInput) SetProvisioningArtifactId(v string) *AssociateServiceActionWithProvisioningArtifactInput { + s.ProvisioningArtifactId = &v + return s +} + +// SetServiceActionId sets the ServiceActionId field's value. +func (s *AssociateServiceActionWithProvisioningArtifactInput) SetServiceActionId(v string) *AssociateServiceActionWithProvisioningArtifactInput { + s.ServiceActionId = &v + return s +} + +type AssociateServiceActionWithProvisioningArtifactOutput struct { + _ struct{} `type:"structure"` +} + +// String returns the string representation +func (s AssociateServiceActionWithProvisioningArtifactOutput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s AssociateServiceActionWithProvisioningArtifactOutput) GoString() string { + return s.String() +} + +type AssociateTagOptionWithResourceInput struct { + _ struct{} `type:"structure"` + + // The resource identifier. + // + // ResourceId is a required field + ResourceId *string `type:"string" required:"true"` + + // The TagOption identifier. + // + // TagOptionId is a required field + TagOptionId *string `min:"1" type:"string" required:"true"` +} + +// String returns the string representation +func (s AssociateTagOptionWithResourceInput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s AssociateTagOptionWithResourceInput) GoString() string { + return s.String() +} + +// Validate inspects the fields of the type to determine if they are valid. +func (s *AssociateTagOptionWithResourceInput) Validate() error { + invalidParams := request.ErrInvalidParams{Context: "AssociateTagOptionWithResourceInput"} + if s.ResourceId == nil { + invalidParams.Add(request.NewErrParamRequired("ResourceId")) + } + if s.TagOptionId == nil { + invalidParams.Add(request.NewErrParamRequired("TagOptionId")) + } + if s.TagOptionId != nil && len(*s.TagOptionId) < 1 { + invalidParams.Add(request.NewErrParamMinLen("TagOptionId", 1)) + } + + if invalidParams.Len() > 0 { + return invalidParams + } + return nil +} + +// SetResourceId sets the ResourceId field's value. +func (s *AssociateTagOptionWithResourceInput) SetResourceId(v string) *AssociateTagOptionWithResourceInput { + s.ResourceId = &v return s } -// SetPrincipalType sets the PrincipalType field's value. -func (s *AssociatePrincipalWithPortfolioInput) SetPrincipalType(v string) *AssociatePrincipalWithPortfolioInput { - s.PrincipalType = &v +// SetTagOptionId sets the TagOptionId field's value. +func (s *AssociateTagOptionWithResourceInput) SetTagOptionId(v string) *AssociateTagOptionWithResourceInput { + s.TagOptionId = &v return s } -type AssociatePrincipalWithPortfolioOutput struct { +type AssociateTagOptionWithResourceOutput struct { _ struct{} `type:"structure"` } // String returns the string representation -func (s AssociatePrincipalWithPortfolioOutput) String() string { +func (s AssociateTagOptionWithResourceOutput) String() string { return awsutil.Prettify(s) } // GoString returns the string representation -func (s AssociatePrincipalWithPortfolioOutput) GoString() string { +func (s AssociateTagOptionWithResourceOutput) GoString() string { return s.String() } -type AssociateProductWithPortfolioInput struct { +type BatchAssociateServiceActionWithProvisioningArtifactInput struct { _ struct{} `type:"structure"` // The language code. @@ -5949,47 +7375,41 @@ type AssociateProductWithPortfolioInput struct { // * zh - Chinese AcceptLanguage *string `type:"string"` - // The portfolio identifier. - // - // PortfolioId is a required field - PortfolioId *string `min:"1" type:"string" required:"true"` - - // The product identifier. + // One or more associations, each consisting of the Action ID, the Product ID, + // and the Provisioning Artifact ID. // - // ProductId is a required field - ProductId *string `min:"1" type:"string" required:"true"` - - // The identifier of the source portfolio. - SourcePortfolioId *string `min:"1" type:"string"` + // ServiceActionAssociations is a required field + ServiceActionAssociations []*ServiceActionAssociation `min:"1" type:"list" required:"true"` } // String returns the string representation -func (s AssociateProductWithPortfolioInput) String() string { +func (s BatchAssociateServiceActionWithProvisioningArtifactInput) String() string { return awsutil.Prettify(s) } // GoString returns the string representation -func (s AssociateProductWithPortfolioInput) GoString() string { +func (s BatchAssociateServiceActionWithProvisioningArtifactInput) GoString() string { return s.String() } // Validate inspects the fields of the type to determine if they are valid. -func (s *AssociateProductWithPortfolioInput) Validate() error { - invalidParams := request.ErrInvalidParams{Context: "AssociateProductWithPortfolioInput"} - if s.PortfolioId == nil { - invalidParams.Add(request.NewErrParamRequired("PortfolioId")) - } - if s.PortfolioId != nil && len(*s.PortfolioId) < 1 { - invalidParams.Add(request.NewErrParamMinLen("PortfolioId", 1)) +func (s *BatchAssociateServiceActionWithProvisioningArtifactInput) Validate() error { + invalidParams := request.ErrInvalidParams{Context: "BatchAssociateServiceActionWithProvisioningArtifactInput"} + if s.ServiceActionAssociations == nil { + invalidParams.Add(request.NewErrParamRequired("ServiceActionAssociations")) } - if s.ProductId == nil { - invalidParams.Add(request.NewErrParamRequired("ProductId")) - } - if s.ProductId != nil && len(*s.ProductId) < 1 { - invalidParams.Add(request.NewErrParamMinLen("ProductId", 1)) + if s.ServiceActionAssociations != nil && len(s.ServiceActionAssociations) < 1 { + invalidParams.Add(request.NewErrParamMinLen("ServiceActionAssociations", 1)) } - if s.SourcePortfolioId != nil && len(*s.SourcePortfolioId) < 1 { - invalidParams.Add(request.NewErrParamMinLen("SourcePortfolioId", 1)) + if s.ServiceActionAssociations != nil { + for i, v := range s.ServiceActionAssociations { + if v == nil { + continue + } + if err := v.Validate(); err != nil { + invalidParams.AddNested(fmt.Sprintf("%s[%v]", "ServiceActionAssociations", i), err.(request.ErrInvalidParams)) + } + } } if invalidParams.Len() > 0 { @@ -5999,78 +7419,88 @@ func (s *AssociateProductWithPortfolioInput) Validate() error { } // SetAcceptLanguage sets the AcceptLanguage field's value. -func (s *AssociateProductWithPortfolioInput) SetAcceptLanguage(v string) *AssociateProductWithPortfolioInput { +func (s *BatchAssociateServiceActionWithProvisioningArtifactInput) SetAcceptLanguage(v string) *BatchAssociateServiceActionWithProvisioningArtifactInput { s.AcceptLanguage = &v return s } -// SetPortfolioId sets the PortfolioId field's value. -func (s *AssociateProductWithPortfolioInput) SetPortfolioId(v string) *AssociateProductWithPortfolioInput { - s.PortfolioId = &v - return s -} - -// SetProductId sets the ProductId field's value. -func (s *AssociateProductWithPortfolioInput) SetProductId(v string) *AssociateProductWithPortfolioInput { - s.ProductId = &v - return s -} - -// SetSourcePortfolioId sets the SourcePortfolioId field's value. -func (s *AssociateProductWithPortfolioInput) SetSourcePortfolioId(v string) *AssociateProductWithPortfolioInput { - s.SourcePortfolioId = &v +// SetServiceActionAssociations sets the ServiceActionAssociations field's value. +func (s *BatchAssociateServiceActionWithProvisioningArtifactInput) SetServiceActionAssociations(v []*ServiceActionAssociation) *BatchAssociateServiceActionWithProvisioningArtifactInput { + s.ServiceActionAssociations = v return s } -type AssociateProductWithPortfolioOutput struct { +type BatchAssociateServiceActionWithProvisioningArtifactOutput struct { _ struct{} `type:"structure"` + + // An object that contains a list of errors, along with information to help + // you identify the self-service action. + FailedServiceActionAssociations []*FailedServiceActionAssociation `type:"list"` } // String returns the string representation -func (s AssociateProductWithPortfolioOutput) String() string { +func (s BatchAssociateServiceActionWithProvisioningArtifactOutput) String() string { return awsutil.Prettify(s) } // GoString returns the string representation -func (s AssociateProductWithPortfolioOutput) GoString() string { +func (s BatchAssociateServiceActionWithProvisioningArtifactOutput) GoString() string { return s.String() } -type AssociateTagOptionWithResourceInput struct { +// SetFailedServiceActionAssociations sets the FailedServiceActionAssociations field's value. +func (s *BatchAssociateServiceActionWithProvisioningArtifactOutput) SetFailedServiceActionAssociations(v []*FailedServiceActionAssociation) *BatchAssociateServiceActionWithProvisioningArtifactOutput { + s.FailedServiceActionAssociations = v + return s +} + +type BatchDisassociateServiceActionFromProvisioningArtifactInput struct { _ struct{} `type:"structure"` - // The resource identifier. + // The language code. // - // ResourceId is a required field - ResourceId *string `type:"string" required:"true"` + // * en - English (default) + // + // * jp - Japanese + // + // * zh - Chinese + AcceptLanguage *string `type:"string"` - // The TagOption identifier. + // One or more associations, each consisting of the Action ID, the Product ID, + // and the Provisioning Artifact ID. // - // TagOptionId is a required field - TagOptionId *string `min:"1" type:"string" required:"true"` + // ServiceActionAssociations is a required field + ServiceActionAssociations []*ServiceActionAssociation `min:"1" type:"list" required:"true"` } // String returns the string representation -func (s AssociateTagOptionWithResourceInput) String() string { +func (s BatchDisassociateServiceActionFromProvisioningArtifactInput) String() string { return awsutil.Prettify(s) } // GoString returns the string representation -func (s AssociateTagOptionWithResourceInput) GoString() string { +func (s BatchDisassociateServiceActionFromProvisioningArtifactInput) GoString() string { return s.String() } // Validate inspects the fields of the type to determine if they are valid. -func (s *AssociateTagOptionWithResourceInput) Validate() error { - invalidParams := request.ErrInvalidParams{Context: "AssociateTagOptionWithResourceInput"} - if s.ResourceId == nil { - invalidParams.Add(request.NewErrParamRequired("ResourceId")) +func (s *BatchDisassociateServiceActionFromProvisioningArtifactInput) Validate() error { + invalidParams := request.ErrInvalidParams{Context: "BatchDisassociateServiceActionFromProvisioningArtifactInput"} + if s.ServiceActionAssociations == nil { + invalidParams.Add(request.NewErrParamRequired("ServiceActionAssociations")) } - if s.TagOptionId == nil { - invalidParams.Add(request.NewErrParamRequired("TagOptionId")) + if s.ServiceActionAssociations != nil && len(s.ServiceActionAssociations) < 1 { + invalidParams.Add(request.NewErrParamMinLen("ServiceActionAssociations", 1)) } - if s.TagOptionId != nil && len(*s.TagOptionId) < 1 { - invalidParams.Add(request.NewErrParamMinLen("TagOptionId", 1)) + if s.ServiceActionAssociations != nil { + for i, v := range s.ServiceActionAssociations { + if v == nil { + continue + } + if err := v.Validate(); err != nil { + invalidParams.AddNested(fmt.Sprintf("%s[%v]", "ServiceActionAssociations", i), err.(request.ErrInvalidParams)) + } + } } if invalidParams.Len() > 0 { @@ -6079,32 +7509,42 @@ func (s *AssociateTagOptionWithResourceInput) Validate() error { return nil } -// SetResourceId sets the ResourceId field's value. -func (s *AssociateTagOptionWithResourceInput) SetResourceId(v string) *AssociateTagOptionWithResourceInput { - s.ResourceId = &v +// SetAcceptLanguage sets the AcceptLanguage field's value. +func (s *BatchDisassociateServiceActionFromProvisioningArtifactInput) SetAcceptLanguage(v string) *BatchDisassociateServiceActionFromProvisioningArtifactInput { + s.AcceptLanguage = &v return s } -// SetTagOptionId sets the TagOptionId field's value. -func (s *AssociateTagOptionWithResourceInput) SetTagOptionId(v string) *AssociateTagOptionWithResourceInput { - s.TagOptionId = &v +// SetServiceActionAssociations sets the ServiceActionAssociations field's value. +func (s *BatchDisassociateServiceActionFromProvisioningArtifactInput) SetServiceActionAssociations(v []*ServiceActionAssociation) *BatchDisassociateServiceActionFromProvisioningArtifactInput { + s.ServiceActionAssociations = v return s } -type AssociateTagOptionWithResourceOutput struct { +type BatchDisassociateServiceActionFromProvisioningArtifactOutput struct { _ struct{} `type:"structure"` + + // An object that contains a list of errors, along with information to help + // you identify the self-service action. + FailedServiceActionAssociations []*FailedServiceActionAssociation `type:"list"` } // String returns the string representation -func (s AssociateTagOptionWithResourceOutput) String() string { +func (s BatchDisassociateServiceActionFromProvisioningArtifactOutput) String() string { return awsutil.Prettify(s) } // GoString returns the string representation -func (s AssociateTagOptionWithResourceOutput) GoString() string { +func (s BatchDisassociateServiceActionFromProvisioningArtifactOutput) GoString() string { return s.String() } +// SetFailedServiceActionAssociations sets the FailedServiceActionAssociations field's value. +func (s *BatchDisassociateServiceActionFromProvisioningArtifactOutput) SetFailedServiceActionAssociations(v []*FailedServiceActionAssociation) *BatchDisassociateServiceActionFromProvisioningArtifactOutput { + s.FailedServiceActionAssociations = v + return s +} + // Information about a CloudWatch dashboard. type CloudWatchDashboard struct { _ struct{} `type:"structure"` @@ -7330,13 +8770,171 @@ func (s *CreateProvisioningArtifactInput) Validate() error { if s.ProductId == nil { invalidParams.Add(request.NewErrParamRequired("ProductId")) } - if s.ProductId != nil && len(*s.ProductId) < 1 { - invalidParams.Add(request.NewErrParamMinLen("ProductId", 1)) + if s.ProductId != nil && len(*s.ProductId) < 1 { + invalidParams.Add(request.NewErrParamMinLen("ProductId", 1)) + } + if s.Parameters != nil { + if err := s.Parameters.Validate(); err != nil { + invalidParams.AddNested("Parameters", err.(request.ErrInvalidParams)) + } + } + + if invalidParams.Len() > 0 { + return invalidParams + } + return nil +} + +// SetAcceptLanguage sets the AcceptLanguage field's value. +func (s *CreateProvisioningArtifactInput) SetAcceptLanguage(v string) *CreateProvisioningArtifactInput { + s.AcceptLanguage = &v + return s +} + +// SetIdempotencyToken sets the IdempotencyToken field's value. +func (s *CreateProvisioningArtifactInput) SetIdempotencyToken(v string) *CreateProvisioningArtifactInput { + s.IdempotencyToken = &v + return s +} + +// SetParameters sets the Parameters field's value. +func (s *CreateProvisioningArtifactInput) SetParameters(v *ProvisioningArtifactProperties) *CreateProvisioningArtifactInput { + s.Parameters = v + return s +} + +// SetProductId sets the ProductId field's value. +func (s *CreateProvisioningArtifactInput) SetProductId(v string) *CreateProvisioningArtifactInput { + s.ProductId = &v + return s +} + +type CreateProvisioningArtifactOutput struct { + _ struct{} `type:"structure"` + + // The URL of the CloudFormation template in Amazon S3, in JSON format. + Info map[string]*string `min:"1" type:"map"` + + // Information about the provisioning artifact. + ProvisioningArtifactDetail *ProvisioningArtifactDetail `type:"structure"` + + // The status of the current request. + Status *string `type:"string" enum:"Status"` +} + +// String returns the string representation +func (s CreateProvisioningArtifactOutput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s CreateProvisioningArtifactOutput) GoString() string { + return s.String() +} + +// SetInfo sets the Info field's value. +func (s *CreateProvisioningArtifactOutput) SetInfo(v map[string]*string) *CreateProvisioningArtifactOutput { + s.Info = v + return s +} + +// SetProvisioningArtifactDetail sets the ProvisioningArtifactDetail field's value. +func (s *CreateProvisioningArtifactOutput) SetProvisioningArtifactDetail(v *ProvisioningArtifactDetail) *CreateProvisioningArtifactOutput { + s.ProvisioningArtifactDetail = v + return s +} + +// SetStatus sets the Status field's value. +func (s *CreateProvisioningArtifactOutput) SetStatus(v string) *CreateProvisioningArtifactOutput { + s.Status = &v + return s +} + +type CreateServiceActionInput struct { + _ struct{} `type:"structure"` + + // The language code. + // + // * en - English (default) + // + // * jp - Japanese + // + // * zh - Chinese + AcceptLanguage *string `type:"string"` + + // The self-service action definition. Can be one of the following: + // + // NameThe name of the AWS Systems Manager Document. For example, AWS-RestartEC2Instance. + // + // VersionThe AWS Systems Manager automation document version. For example, + // "Version": "1" + // + // AssumeRoleThe Amazon Resource Name (ARN) of the role that performs the self-service + // actions on your behalf. For example, "AssumeRole": "arn:aws:iam::12345678910:role/ActionRole". + // + // To reuse the provisioned product launch role, set to "AssumeRole": "LAUNCH_ROLE". + // + // ParametersThe list of parameters in JSON format. + // + // For example: [{\"Name\":\"InstanceId\",\"Type\":\"TARGET\"}]. + // + // Definition is a required field + Definition map[string]*string `min:"1" type:"map" required:"true"` + + // The service action definition type. For example, SSM_AUTOMATION. + // + // DefinitionType is a required field + DefinitionType *string `type:"string" required:"true" enum:"ServiceActionDefinitionType"` + + // The self-service action description. + Description *string `type:"string"` + + // A unique identifier that you provide to ensure idempotency. If multiple requests + // differ only by the idempotency token, the same response is returned for each + // repeated request. + // + // IdempotencyToken is a required field + IdempotencyToken *string `min:"1" type:"string" required:"true" idempotencyToken:"true"` + + // The self-service action name. + // + // Name is a required field + Name *string `min:"1" type:"string" required:"true"` +} + +// String returns the string representation +func (s CreateServiceActionInput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s CreateServiceActionInput) GoString() string { + return s.String() +} + +// Validate inspects the fields of the type to determine if they are valid. +func (s *CreateServiceActionInput) Validate() error { + invalidParams := request.ErrInvalidParams{Context: "CreateServiceActionInput"} + if s.Definition == nil { + invalidParams.Add(request.NewErrParamRequired("Definition")) + } + if s.Definition != nil && len(s.Definition) < 1 { + invalidParams.Add(request.NewErrParamMinLen("Definition", 1)) + } + if s.DefinitionType == nil { + invalidParams.Add(request.NewErrParamRequired("DefinitionType")) + } + if s.IdempotencyToken == nil { + invalidParams.Add(request.NewErrParamRequired("IdempotencyToken")) + } + if s.IdempotencyToken != nil && len(*s.IdempotencyToken) < 1 { + invalidParams.Add(request.NewErrParamMinLen("IdempotencyToken", 1)) + } + if s.Name == nil { + invalidParams.Add(request.NewErrParamRequired("Name")) } - if s.Parameters != nil { - if err := s.Parameters.Validate(); err != nil { - invalidParams.AddNested("Parameters", err.(request.ErrInvalidParams)) - } + if s.Name != nil && len(*s.Name) < 1 { + invalidParams.Add(request.NewErrParamMinLen("Name", 1)) } if invalidParams.Len() > 0 { @@ -7346,67 +8944,61 @@ func (s *CreateProvisioningArtifactInput) Validate() error { } // SetAcceptLanguage sets the AcceptLanguage field's value. -func (s *CreateProvisioningArtifactInput) SetAcceptLanguage(v string) *CreateProvisioningArtifactInput { +func (s *CreateServiceActionInput) SetAcceptLanguage(v string) *CreateServiceActionInput { s.AcceptLanguage = &v return s } -// SetIdempotencyToken sets the IdempotencyToken field's value. -func (s *CreateProvisioningArtifactInput) SetIdempotencyToken(v string) *CreateProvisioningArtifactInput { - s.IdempotencyToken = &v +// SetDefinition sets the Definition field's value. +func (s *CreateServiceActionInput) SetDefinition(v map[string]*string) *CreateServiceActionInput { + s.Definition = v return s } -// SetParameters sets the Parameters field's value. -func (s *CreateProvisioningArtifactInput) SetParameters(v *ProvisioningArtifactProperties) *CreateProvisioningArtifactInput { - s.Parameters = v +// SetDefinitionType sets the DefinitionType field's value. +func (s *CreateServiceActionInput) SetDefinitionType(v string) *CreateServiceActionInput { + s.DefinitionType = &v return s } -// SetProductId sets the ProductId field's value. -func (s *CreateProvisioningArtifactInput) SetProductId(v string) *CreateProvisioningArtifactInput { - s.ProductId = &v +// SetDescription sets the Description field's value. +func (s *CreateServiceActionInput) SetDescription(v string) *CreateServiceActionInput { + s.Description = &v return s } -type CreateProvisioningArtifactOutput struct { - _ struct{} `type:"structure"` +// SetIdempotencyToken sets the IdempotencyToken field's value. +func (s *CreateServiceActionInput) SetIdempotencyToken(v string) *CreateServiceActionInput { + s.IdempotencyToken = &v + return s +} - // The URL of the CloudFormation template in Amazon S3, in JSON format. - Info map[string]*string `min:"1" type:"map"` +// SetName sets the Name field's value. +func (s *CreateServiceActionInput) SetName(v string) *CreateServiceActionInput { + s.Name = &v + return s +} - // Information about the provisioning artifact. - ProvisioningArtifactDetail *ProvisioningArtifactDetail `type:"structure"` +type CreateServiceActionOutput struct { + _ struct{} `type:"structure"` - // The status of the current request. - Status *string `type:"string" enum:"Status"` + // An object containing information about the self-service action. + ServiceActionDetail *ServiceActionDetail `type:"structure"` } // String returns the string representation -func (s CreateProvisioningArtifactOutput) String() string { +func (s CreateServiceActionOutput) String() string { return awsutil.Prettify(s) } // GoString returns the string representation -func (s CreateProvisioningArtifactOutput) GoString() string { +func (s CreateServiceActionOutput) GoString() string { return s.String() } -// SetInfo sets the Info field's value. -func (s *CreateProvisioningArtifactOutput) SetInfo(v map[string]*string) *CreateProvisioningArtifactOutput { - s.Info = v - return s -} - -// SetProvisioningArtifactDetail sets the ProvisioningArtifactDetail field's value. -func (s *CreateProvisioningArtifactOutput) SetProvisioningArtifactDetail(v *ProvisioningArtifactDetail) *CreateProvisioningArtifactOutput { - s.ProvisioningArtifactDetail = v - return s -} - -// SetStatus sets the Status field's value. -func (s *CreateProvisioningArtifactOutput) SetStatus(v string) *CreateProvisioningArtifactOutput { - s.Status = &v +// SetServiceActionDetail sets the ServiceActionDetail field's value. +func (s *CreateServiceActionOutput) SetServiceActionDetail(v *ServiceActionDetail) *CreateServiceActionOutput { + s.ServiceActionDetail = v return s } @@ -7952,6 +9544,76 @@ func (s DeleteProvisioningArtifactOutput) GoString() string { return s.String() } +type DeleteServiceActionInput struct { + _ struct{} `type:"structure"` + + // The language code. + // + // * en - English (default) + // + // * jp - Japanese + // + // * zh - Chinese + AcceptLanguage *string `type:"string"` + + // The self-service action identifier. For example, act-fs7abcd89wxyz. + // + // Id is a required field + Id *string `min:"1" type:"string" required:"true"` +} + +// String returns the string representation +func (s DeleteServiceActionInput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s DeleteServiceActionInput) GoString() string { + return s.String() +} + +// Validate inspects the fields of the type to determine if they are valid. +func (s *DeleteServiceActionInput) Validate() error { + invalidParams := request.ErrInvalidParams{Context: "DeleteServiceActionInput"} + if s.Id == nil { + invalidParams.Add(request.NewErrParamRequired("Id")) + } + if s.Id != nil && len(*s.Id) < 1 { + invalidParams.Add(request.NewErrParamMinLen("Id", 1)) + } + + if invalidParams.Len() > 0 { + return invalidParams + } + return nil +} + +// SetAcceptLanguage sets the AcceptLanguage field's value. +func (s *DeleteServiceActionInput) SetAcceptLanguage(v string) *DeleteServiceActionInput { + s.AcceptLanguage = &v + return s +} + +// SetId sets the Id field's value. +func (s *DeleteServiceActionInput) SetId(v string) *DeleteServiceActionInput { + s.Id = &v + return s +} + +type DeleteServiceActionOutput struct { + _ struct{} `type:"structure"` +} + +// String returns the string representation +func (s DeleteServiceActionOutput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s DeleteServiceActionOutput) GoString() string { + return s.String() +} + type DeleteTagOptionInput struct { _ struct{} `type:"structure"` @@ -9167,6 +10829,85 @@ func (s *DescribeRecordOutput) SetRecordOutputs(v []*RecordOutput) *DescribeReco return s } +type DescribeServiceActionInput struct { + _ struct{} `type:"structure"` + + // The language code. + // + // * en - English (default) + // + // * jp - Japanese + // + // * zh - Chinese + AcceptLanguage *string `type:"string"` + + // The self-service action identifier. + // + // Id is a required field + Id *string `min:"1" type:"string" required:"true"` +} + +// String returns the string representation +func (s DescribeServiceActionInput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s DescribeServiceActionInput) GoString() string { + return s.String() +} + +// Validate inspects the fields of the type to determine if they are valid. +func (s *DescribeServiceActionInput) Validate() error { + invalidParams := request.ErrInvalidParams{Context: "DescribeServiceActionInput"} + if s.Id == nil { + invalidParams.Add(request.NewErrParamRequired("Id")) + } + if s.Id != nil && len(*s.Id) < 1 { + invalidParams.Add(request.NewErrParamMinLen("Id", 1)) + } + + if invalidParams.Len() > 0 { + return invalidParams + } + return nil +} + +// SetAcceptLanguage sets the AcceptLanguage field's value. +func (s *DescribeServiceActionInput) SetAcceptLanguage(v string) *DescribeServiceActionInput { + s.AcceptLanguage = &v + return s +} + +// SetId sets the Id field's value. +func (s *DescribeServiceActionInput) SetId(v string) *DescribeServiceActionInput { + s.Id = &v + return s +} + +type DescribeServiceActionOutput struct { + _ struct{} `type:"structure"` + + // Detailed information about the self-service action. + ServiceActionDetail *ServiceActionDetail `type:"structure"` +} + +// String returns the string representation +func (s DescribeServiceActionOutput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s DescribeServiceActionOutput) GoString() string { + return s.String() +} + +// SetServiceActionDetail sets the ServiceActionDetail field's value. +func (s *DescribeServiceActionOutput) SetServiceActionDetail(v *ServiceActionDetail) *DescribeServiceActionOutput { + s.ServiceActionDetail = v + return s +} + type DescribeTagOptionInput struct { _ struct{} `type:"structure"` @@ -9335,37 +11076,135 @@ type DisassociateProductFromPortfolioInput struct { // PortfolioId is a required field PortfolioId *string `min:"1" type:"string" required:"true"` - // The product identifier. + // The product identifier. + // + // ProductId is a required field + ProductId *string `min:"1" type:"string" required:"true"` +} + +// String returns the string representation +func (s DisassociateProductFromPortfolioInput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s DisassociateProductFromPortfolioInput) GoString() string { + return s.String() +} + +// Validate inspects the fields of the type to determine if they are valid. +func (s *DisassociateProductFromPortfolioInput) Validate() error { + invalidParams := request.ErrInvalidParams{Context: "DisassociateProductFromPortfolioInput"} + if s.PortfolioId == nil { + invalidParams.Add(request.NewErrParamRequired("PortfolioId")) + } + if s.PortfolioId != nil && len(*s.PortfolioId) < 1 { + invalidParams.Add(request.NewErrParamMinLen("PortfolioId", 1)) + } + if s.ProductId == nil { + invalidParams.Add(request.NewErrParamRequired("ProductId")) + } + if s.ProductId != nil && len(*s.ProductId) < 1 { + invalidParams.Add(request.NewErrParamMinLen("ProductId", 1)) + } + + if invalidParams.Len() > 0 { + return invalidParams + } + return nil +} + +// SetAcceptLanguage sets the AcceptLanguage field's value. +func (s *DisassociateProductFromPortfolioInput) SetAcceptLanguage(v string) *DisassociateProductFromPortfolioInput { + s.AcceptLanguage = &v + return s +} + +// SetPortfolioId sets the PortfolioId field's value. +func (s *DisassociateProductFromPortfolioInput) SetPortfolioId(v string) *DisassociateProductFromPortfolioInput { + s.PortfolioId = &v + return s +} + +// SetProductId sets the ProductId field's value. +func (s *DisassociateProductFromPortfolioInput) SetProductId(v string) *DisassociateProductFromPortfolioInput { + s.ProductId = &v + return s +} + +type DisassociateProductFromPortfolioOutput struct { + _ struct{} `type:"structure"` +} + +// String returns the string representation +func (s DisassociateProductFromPortfolioOutput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s DisassociateProductFromPortfolioOutput) GoString() string { + return s.String() +} + +type DisassociateServiceActionFromProvisioningArtifactInput struct { + _ struct{} `type:"structure"` + + // The language code. + // + // * en - English (default) + // + // * jp - Japanese + // + // * zh - Chinese + AcceptLanguage *string `type:"string"` + + // The product identifier. For example, prod-abcdzk7xy33qa. // // ProductId is a required field ProductId *string `min:"1" type:"string" required:"true"` + + // The identifier of the provisioning artifact. For example, pa-4abcdjnxjj6ne. + // + // ProvisioningArtifactId is a required field + ProvisioningArtifactId *string `min:"1" type:"string" required:"true"` + + // The self-service action identifier. For example, act-fs7abcd89wxyz. + // + // ServiceActionId is a required field + ServiceActionId *string `min:"1" type:"string" required:"true"` } // String returns the string representation -func (s DisassociateProductFromPortfolioInput) String() string { +func (s DisassociateServiceActionFromProvisioningArtifactInput) String() string { return awsutil.Prettify(s) } // GoString returns the string representation -func (s DisassociateProductFromPortfolioInput) GoString() string { +func (s DisassociateServiceActionFromProvisioningArtifactInput) GoString() string { return s.String() } // Validate inspects the fields of the type to determine if they are valid. -func (s *DisassociateProductFromPortfolioInput) Validate() error { - invalidParams := request.ErrInvalidParams{Context: "DisassociateProductFromPortfolioInput"} - if s.PortfolioId == nil { - invalidParams.Add(request.NewErrParamRequired("PortfolioId")) - } - if s.PortfolioId != nil && len(*s.PortfolioId) < 1 { - invalidParams.Add(request.NewErrParamMinLen("PortfolioId", 1)) - } +func (s *DisassociateServiceActionFromProvisioningArtifactInput) Validate() error { + invalidParams := request.ErrInvalidParams{Context: "DisassociateServiceActionFromProvisioningArtifactInput"} if s.ProductId == nil { invalidParams.Add(request.NewErrParamRequired("ProductId")) } if s.ProductId != nil && len(*s.ProductId) < 1 { invalidParams.Add(request.NewErrParamMinLen("ProductId", 1)) } + if s.ProvisioningArtifactId == nil { + invalidParams.Add(request.NewErrParamRequired("ProvisioningArtifactId")) + } + if s.ProvisioningArtifactId != nil && len(*s.ProvisioningArtifactId) < 1 { + invalidParams.Add(request.NewErrParamMinLen("ProvisioningArtifactId", 1)) + } + if s.ServiceActionId == nil { + invalidParams.Add(request.NewErrParamRequired("ServiceActionId")) + } + if s.ServiceActionId != nil && len(*s.ServiceActionId) < 1 { + invalidParams.Add(request.NewErrParamMinLen("ServiceActionId", 1)) + } if invalidParams.Len() > 0 { return invalidParams @@ -9374,34 +11213,40 @@ func (s *DisassociateProductFromPortfolioInput) Validate() error { } // SetAcceptLanguage sets the AcceptLanguage field's value. -func (s *DisassociateProductFromPortfolioInput) SetAcceptLanguage(v string) *DisassociateProductFromPortfolioInput { +func (s *DisassociateServiceActionFromProvisioningArtifactInput) SetAcceptLanguage(v string) *DisassociateServiceActionFromProvisioningArtifactInput { s.AcceptLanguage = &v return s } -// SetPortfolioId sets the PortfolioId field's value. -func (s *DisassociateProductFromPortfolioInput) SetPortfolioId(v string) *DisassociateProductFromPortfolioInput { - s.PortfolioId = &v +// SetProductId sets the ProductId field's value. +func (s *DisassociateServiceActionFromProvisioningArtifactInput) SetProductId(v string) *DisassociateServiceActionFromProvisioningArtifactInput { + s.ProductId = &v return s } -// SetProductId sets the ProductId field's value. -func (s *DisassociateProductFromPortfolioInput) SetProductId(v string) *DisassociateProductFromPortfolioInput { - s.ProductId = &v +// SetProvisioningArtifactId sets the ProvisioningArtifactId field's value. +func (s *DisassociateServiceActionFromProvisioningArtifactInput) SetProvisioningArtifactId(v string) *DisassociateServiceActionFromProvisioningArtifactInput { + s.ProvisioningArtifactId = &v return s } -type DisassociateProductFromPortfolioOutput struct { +// SetServiceActionId sets the ServiceActionId field's value. +func (s *DisassociateServiceActionFromProvisioningArtifactInput) SetServiceActionId(v string) *DisassociateServiceActionFromProvisioningArtifactInput { + s.ServiceActionId = &v + return s +} + +type DisassociateServiceActionFromProvisioningArtifactOutput struct { _ struct{} `type:"structure"` } // String returns the string representation -func (s DisassociateProductFromPortfolioOutput) String() string { +func (s DisassociateServiceActionFromProvisioningArtifactOutput) String() string { return awsutil.Prettify(s) } // GoString returns the string representation -func (s DisassociateProductFromPortfolioOutput) GoString() string { +func (s DisassociateServiceActionFromProvisioningArtifactOutput) GoString() string { return s.String() } @@ -9572,6 +11417,181 @@ func (s *ExecuteProvisionedProductPlanOutput) SetRecordDetail(v *RecordDetail) * return s } +type ExecuteProvisionedProductServiceActionInput struct { + _ struct{} `type:"structure"` + + // The language code. + // + // * en - English (default) + // + // * jp - Japanese + // + // * zh - Chinese + AcceptLanguage *string `type:"string"` + + // An idempotency token that uniquely identifies the execute request. + // + // ExecuteToken is a required field + ExecuteToken *string `min:"1" type:"string" required:"true" idempotencyToken:"true"` + + // The identifier of the provisioned product. + // + // ProvisionedProductId is a required field + ProvisionedProductId *string `min:"1" type:"string" required:"true"` + + // The self-service action identifier. For example, act-fs7abcd89wxyz. + // + // ServiceActionId is a required field + ServiceActionId *string `min:"1" type:"string" required:"true"` +} + +// String returns the string representation +func (s ExecuteProvisionedProductServiceActionInput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s ExecuteProvisionedProductServiceActionInput) GoString() string { + return s.String() +} + +// Validate inspects the fields of the type to determine if they are valid. +func (s *ExecuteProvisionedProductServiceActionInput) Validate() error { + invalidParams := request.ErrInvalidParams{Context: "ExecuteProvisionedProductServiceActionInput"} + if s.ExecuteToken == nil { + invalidParams.Add(request.NewErrParamRequired("ExecuteToken")) + } + if s.ExecuteToken != nil && len(*s.ExecuteToken) < 1 { + invalidParams.Add(request.NewErrParamMinLen("ExecuteToken", 1)) + } + if s.ProvisionedProductId == nil { + invalidParams.Add(request.NewErrParamRequired("ProvisionedProductId")) + } + if s.ProvisionedProductId != nil && len(*s.ProvisionedProductId) < 1 { + invalidParams.Add(request.NewErrParamMinLen("ProvisionedProductId", 1)) + } + if s.ServiceActionId == nil { + invalidParams.Add(request.NewErrParamRequired("ServiceActionId")) + } + if s.ServiceActionId != nil && len(*s.ServiceActionId) < 1 { + invalidParams.Add(request.NewErrParamMinLen("ServiceActionId", 1)) + } + + if invalidParams.Len() > 0 { + return invalidParams + } + return nil +} + +// SetAcceptLanguage sets the AcceptLanguage field's value. +func (s *ExecuteProvisionedProductServiceActionInput) SetAcceptLanguage(v string) *ExecuteProvisionedProductServiceActionInput { + s.AcceptLanguage = &v + return s +} + +// SetExecuteToken sets the ExecuteToken field's value. +func (s *ExecuteProvisionedProductServiceActionInput) SetExecuteToken(v string) *ExecuteProvisionedProductServiceActionInput { + s.ExecuteToken = &v + return s +} + +// SetProvisionedProductId sets the ProvisionedProductId field's value. +func (s *ExecuteProvisionedProductServiceActionInput) SetProvisionedProductId(v string) *ExecuteProvisionedProductServiceActionInput { + s.ProvisionedProductId = &v + return s +} + +// SetServiceActionId sets the ServiceActionId field's value. +func (s *ExecuteProvisionedProductServiceActionInput) SetServiceActionId(v string) *ExecuteProvisionedProductServiceActionInput { + s.ServiceActionId = &v + return s +} + +type ExecuteProvisionedProductServiceActionOutput struct { + _ struct{} `type:"structure"` + + // An object containing detailed information about the result of provisioning + // the product. + RecordDetail *RecordDetail `type:"structure"` +} + +// String returns the string representation +func (s ExecuteProvisionedProductServiceActionOutput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s ExecuteProvisionedProductServiceActionOutput) GoString() string { + return s.String() +} + +// SetRecordDetail sets the RecordDetail field's value. +func (s *ExecuteProvisionedProductServiceActionOutput) SetRecordDetail(v *RecordDetail) *ExecuteProvisionedProductServiceActionOutput { + s.RecordDetail = v + return s +} + +// An object containing information about the error, along with identifying +// information about the self-service action and its associations. +type FailedServiceActionAssociation struct { + _ struct{} `type:"structure"` + + // The error code. Valid values are listed below. + ErrorCode *string `type:"string" enum:"ServiceActionAssociationErrorCode"` + + // A text description of the error. + ErrorMessage *string `min:"1" type:"string"` + + // The product identifier. For example, prod-abcdzk7xy33qa. + ProductId *string `min:"1" type:"string"` + + // The identifier of the provisioning artifact. For example, pa-4abcdjnxjj6ne. + ProvisioningArtifactId *string `min:"1" type:"string"` + + // The self-service action identifier. For example, act-fs7abcd89wxyz. + ServiceActionId *string `min:"1" type:"string"` +} + +// String returns the string representation +func (s FailedServiceActionAssociation) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s FailedServiceActionAssociation) GoString() string { + return s.String() +} + +// SetErrorCode sets the ErrorCode field's value. +func (s *FailedServiceActionAssociation) SetErrorCode(v string) *FailedServiceActionAssociation { + s.ErrorCode = &v + return s +} + +// SetErrorMessage sets the ErrorMessage field's value. +func (s *FailedServiceActionAssociation) SetErrorMessage(v string) *FailedServiceActionAssociation { + s.ErrorMessage = &v + return s +} + +// SetProductId sets the ProductId field's value. +func (s *FailedServiceActionAssociation) SetProductId(v string) *FailedServiceActionAssociation { + s.ProductId = &v + return s +} + +// SetProvisioningArtifactId sets the ProvisioningArtifactId field's value. +func (s *FailedServiceActionAssociation) SetProvisioningArtifactId(v string) *FailedServiceActionAssociation { + s.ProvisioningArtifactId = &v + return s +} + +// SetServiceActionId sets the ServiceActionId field's value. +func (s *FailedServiceActionAssociation) SetServiceActionId(v string) *FailedServiceActionAssociation { + s.ServiceActionId = &v + return s +} + // Summary information about a product path for a user. type LaunchPathSummary struct { _ struct{} `type:"structure"` @@ -10275,63 +12295,175 @@ func (s *ListPrincipalsForPortfolioInput) Validate() error { } // SetAcceptLanguage sets the AcceptLanguage field's value. -func (s *ListPrincipalsForPortfolioInput) SetAcceptLanguage(v string) *ListPrincipalsForPortfolioInput { +func (s *ListPrincipalsForPortfolioInput) SetAcceptLanguage(v string) *ListPrincipalsForPortfolioInput { + s.AcceptLanguage = &v + return s +} + +// SetPageSize sets the PageSize field's value. +func (s *ListPrincipalsForPortfolioInput) SetPageSize(v int64) *ListPrincipalsForPortfolioInput { + s.PageSize = &v + return s +} + +// SetPageToken sets the PageToken field's value. +func (s *ListPrincipalsForPortfolioInput) SetPageToken(v string) *ListPrincipalsForPortfolioInput { + s.PageToken = &v + return s +} + +// SetPortfolioId sets the PortfolioId field's value. +func (s *ListPrincipalsForPortfolioInput) SetPortfolioId(v string) *ListPrincipalsForPortfolioInput { + s.PortfolioId = &v + return s +} + +type ListPrincipalsForPortfolioOutput struct { + _ struct{} `type:"structure"` + + // The page token to use to retrieve the next set of results. If there are no + // additional results, this value is null. + NextPageToken *string `type:"string"` + + // The IAM principals (users or roles) associated with the portfolio. + Principals []*Principal `type:"list"` +} + +// String returns the string representation +func (s ListPrincipalsForPortfolioOutput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s ListPrincipalsForPortfolioOutput) GoString() string { + return s.String() +} + +// SetNextPageToken sets the NextPageToken field's value. +func (s *ListPrincipalsForPortfolioOutput) SetNextPageToken(v string) *ListPrincipalsForPortfolioOutput { + s.NextPageToken = &v + return s +} + +// SetPrincipals sets the Principals field's value. +func (s *ListPrincipalsForPortfolioOutput) SetPrincipals(v []*Principal) *ListPrincipalsForPortfolioOutput { + s.Principals = v + return s +} + +type ListProvisionedProductPlansInput struct { + _ struct{} `type:"structure"` + + // The language code. + // + // * en - English (default) + // + // * jp - Japanese + // + // * zh - Chinese + AcceptLanguage *string `type:"string"` + + // The access level to use to obtain results. The default is User. + AccessLevelFilter *AccessLevelFilter `type:"structure"` + + // The maximum number of items to return with this call. + PageSize *int64 `type:"integer"` + + // The page token for the next set of results. To retrieve the first set of + // results, use null. + PageToken *string `type:"string"` + + // The product identifier. + ProvisionProductId *string `min:"1" type:"string"` +} + +// String returns the string representation +func (s ListProvisionedProductPlansInput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s ListProvisionedProductPlansInput) GoString() string { + return s.String() +} + +// Validate inspects the fields of the type to determine if they are valid. +func (s *ListProvisionedProductPlansInput) Validate() error { + invalidParams := request.ErrInvalidParams{Context: "ListProvisionedProductPlansInput"} + if s.ProvisionProductId != nil && len(*s.ProvisionProductId) < 1 { + invalidParams.Add(request.NewErrParamMinLen("ProvisionProductId", 1)) + } + + if invalidParams.Len() > 0 { + return invalidParams + } + return nil +} + +// SetAcceptLanguage sets the AcceptLanguage field's value. +func (s *ListProvisionedProductPlansInput) SetAcceptLanguage(v string) *ListProvisionedProductPlansInput { s.AcceptLanguage = &v return s } +// SetAccessLevelFilter sets the AccessLevelFilter field's value. +func (s *ListProvisionedProductPlansInput) SetAccessLevelFilter(v *AccessLevelFilter) *ListProvisionedProductPlansInput { + s.AccessLevelFilter = v + return s +} + // SetPageSize sets the PageSize field's value. -func (s *ListPrincipalsForPortfolioInput) SetPageSize(v int64) *ListPrincipalsForPortfolioInput { +func (s *ListProvisionedProductPlansInput) SetPageSize(v int64) *ListProvisionedProductPlansInput { s.PageSize = &v return s } // SetPageToken sets the PageToken field's value. -func (s *ListPrincipalsForPortfolioInput) SetPageToken(v string) *ListPrincipalsForPortfolioInput { +func (s *ListProvisionedProductPlansInput) SetPageToken(v string) *ListProvisionedProductPlansInput { s.PageToken = &v return s } -// SetPortfolioId sets the PortfolioId field's value. -func (s *ListPrincipalsForPortfolioInput) SetPortfolioId(v string) *ListPrincipalsForPortfolioInput { - s.PortfolioId = &v +// SetProvisionProductId sets the ProvisionProductId field's value. +func (s *ListProvisionedProductPlansInput) SetProvisionProductId(v string) *ListProvisionedProductPlansInput { + s.ProvisionProductId = &v return s } -type ListPrincipalsForPortfolioOutput struct { +type ListProvisionedProductPlansOutput struct { _ struct{} `type:"structure"` // The page token to use to retrieve the next set of results. If there are no // additional results, this value is null. NextPageToken *string `type:"string"` - // The IAM principals (users or roles) associated with the portfolio. - Principals []*Principal `type:"list"` + // Information about the plans. + ProvisionedProductPlans []*ProvisionedProductPlanSummary `type:"list"` } // String returns the string representation -func (s ListPrincipalsForPortfolioOutput) String() string { +func (s ListProvisionedProductPlansOutput) String() string { return awsutil.Prettify(s) } // GoString returns the string representation -func (s ListPrincipalsForPortfolioOutput) GoString() string { +func (s ListProvisionedProductPlansOutput) GoString() string { return s.String() } // SetNextPageToken sets the NextPageToken field's value. -func (s *ListPrincipalsForPortfolioOutput) SetNextPageToken(v string) *ListPrincipalsForPortfolioOutput { +func (s *ListProvisionedProductPlansOutput) SetNextPageToken(v string) *ListProvisionedProductPlansOutput { s.NextPageToken = &v return s } -// SetPrincipals sets the Principals field's value. -func (s *ListPrincipalsForPortfolioOutput) SetPrincipals(v []*Principal) *ListPrincipalsForPortfolioOutput { - s.Principals = v +// SetProvisionedProductPlans sets the ProvisionedProductPlans field's value. +func (s *ListProvisionedProductPlansOutput) SetProvisionedProductPlans(v []*ProvisionedProductPlanSummary) *ListProvisionedProductPlansOutput { + s.ProvisionedProductPlans = v return s } -type ListProvisionedProductPlansInput struct { +type ListProvisioningArtifactsForServiceActionInput struct { _ struct{} `type:"structure"` // The language code. @@ -10343,9 +12475,6 @@ type ListProvisionedProductPlansInput struct { // * zh - Chinese AcceptLanguage *string `type:"string"` - // The access level to use to obtain results. The default is User. - AccessLevelFilter *AccessLevelFilter `type:"structure"` - // The maximum number of items to return with this call. PageSize *int64 `type:"integer"` @@ -10353,25 +12482,30 @@ type ListProvisionedProductPlansInput struct { // results, use null. PageToken *string `type:"string"` - // The product identifier. - ProvisionProductId *string `min:"1" type:"string"` + // The self-service action identifier. For example, act-fs7abcd89wxyz. + // + // ServiceActionId is a required field + ServiceActionId *string `min:"1" type:"string" required:"true"` } // String returns the string representation -func (s ListProvisionedProductPlansInput) String() string { +func (s ListProvisioningArtifactsForServiceActionInput) String() string { return awsutil.Prettify(s) } // GoString returns the string representation -func (s ListProvisionedProductPlansInput) GoString() string { +func (s ListProvisioningArtifactsForServiceActionInput) GoString() string { return s.String() } // Validate inspects the fields of the type to determine if they are valid. -func (s *ListProvisionedProductPlansInput) Validate() error { - invalidParams := request.ErrInvalidParams{Context: "ListProvisionedProductPlansInput"} - if s.ProvisionProductId != nil && len(*s.ProvisionProductId) < 1 { - invalidParams.Add(request.NewErrParamMinLen("ProvisionProductId", 1)) +func (s *ListProvisioningArtifactsForServiceActionInput) Validate() error { + invalidParams := request.ErrInvalidParams{Context: "ListProvisioningArtifactsForServiceActionInput"} + if s.ServiceActionId == nil { + invalidParams.Add(request.NewErrParamRequired("ServiceActionId")) + } + if s.ServiceActionId != nil && len(*s.ServiceActionId) < 1 { + invalidParams.Add(request.NewErrParamMinLen("ServiceActionId", 1)) } if invalidParams.Len() > 0 { @@ -10381,65 +12515,60 @@ func (s *ListProvisionedProductPlansInput) Validate() error { } // SetAcceptLanguage sets the AcceptLanguage field's value. -func (s *ListProvisionedProductPlansInput) SetAcceptLanguage(v string) *ListProvisionedProductPlansInput { +func (s *ListProvisioningArtifactsForServiceActionInput) SetAcceptLanguage(v string) *ListProvisioningArtifactsForServiceActionInput { s.AcceptLanguage = &v return s } -// SetAccessLevelFilter sets the AccessLevelFilter field's value. -func (s *ListProvisionedProductPlansInput) SetAccessLevelFilter(v *AccessLevelFilter) *ListProvisionedProductPlansInput { - s.AccessLevelFilter = v - return s -} - // SetPageSize sets the PageSize field's value. -func (s *ListProvisionedProductPlansInput) SetPageSize(v int64) *ListProvisionedProductPlansInput { +func (s *ListProvisioningArtifactsForServiceActionInput) SetPageSize(v int64) *ListProvisioningArtifactsForServiceActionInput { s.PageSize = &v return s } // SetPageToken sets the PageToken field's value. -func (s *ListProvisionedProductPlansInput) SetPageToken(v string) *ListProvisionedProductPlansInput { +func (s *ListProvisioningArtifactsForServiceActionInput) SetPageToken(v string) *ListProvisioningArtifactsForServiceActionInput { s.PageToken = &v return s } -// SetProvisionProductId sets the ProvisionProductId field's value. -func (s *ListProvisionedProductPlansInput) SetProvisionProductId(v string) *ListProvisionedProductPlansInput { - s.ProvisionProductId = &v +// SetServiceActionId sets the ServiceActionId field's value. +func (s *ListProvisioningArtifactsForServiceActionInput) SetServiceActionId(v string) *ListProvisioningArtifactsForServiceActionInput { + s.ServiceActionId = &v return s } -type ListProvisionedProductPlansOutput struct { +type ListProvisioningArtifactsForServiceActionOutput struct { _ struct{} `type:"structure"` // The page token to use to retrieve the next set of results. If there are no // additional results, this value is null. NextPageToken *string `type:"string"` - // Information about the plans. - ProvisionedProductPlans []*ProvisionedProductPlanSummary `type:"list"` + // An array of objects with information about product views and provisioning + // artifacts. + ProvisioningArtifactViews []*ProvisioningArtifactView `type:"list"` } // String returns the string representation -func (s ListProvisionedProductPlansOutput) String() string { +func (s ListProvisioningArtifactsForServiceActionOutput) String() string { return awsutil.Prettify(s) } // GoString returns the string representation -func (s ListProvisionedProductPlansOutput) GoString() string { +func (s ListProvisioningArtifactsForServiceActionOutput) GoString() string { return s.String() } // SetNextPageToken sets the NextPageToken field's value. -func (s *ListProvisionedProductPlansOutput) SetNextPageToken(v string) *ListProvisionedProductPlansOutput { +func (s *ListProvisioningArtifactsForServiceActionOutput) SetNextPageToken(v string) *ListProvisioningArtifactsForServiceActionOutput { s.NextPageToken = &v return s } -// SetProvisionedProductPlans sets the ProvisionedProductPlans field's value. -func (s *ListProvisionedProductPlansOutput) SetProvisionedProductPlans(v []*ProvisionedProductPlanSummary) *ListProvisionedProductPlansOutput { - s.ProvisionedProductPlans = v +// SetProvisioningArtifactViews sets the ProvisioningArtifactViews field's value. +func (s *ListProvisioningArtifactsForServiceActionOutput) SetProvisioningArtifactViews(v []*ProvisioningArtifactView) *ListProvisioningArtifactsForServiceActionOutput { + s.ProvisioningArtifactViews = v return s } @@ -10754,24 +12883,232 @@ type ListResourcesForTagOptionOutput struct { } // String returns the string representation -func (s ListResourcesForTagOptionOutput) String() string { +func (s ListResourcesForTagOptionOutput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s ListResourcesForTagOptionOutput) GoString() string { + return s.String() +} + +// SetPageToken sets the PageToken field's value. +func (s *ListResourcesForTagOptionOutput) SetPageToken(v string) *ListResourcesForTagOptionOutput { + s.PageToken = &v + return s +} + +// SetResourceDetails sets the ResourceDetails field's value. +func (s *ListResourcesForTagOptionOutput) SetResourceDetails(v []*ResourceDetail) *ListResourcesForTagOptionOutput { + s.ResourceDetails = v + return s +} + +type ListServiceActionsForProvisioningArtifactInput struct { + _ struct{} `type:"structure"` + + // The language code. + // + // * en - English (default) + // + // * jp - Japanese + // + // * zh - Chinese + AcceptLanguage *string `type:"string"` + + // The maximum number of items to return with this call. + PageSize *int64 `type:"integer"` + + // The page token for the next set of results. To retrieve the first set of + // results, use null. + PageToken *string `type:"string"` + + // The product identifier. For example, prod-abcdzk7xy33qa. + // + // ProductId is a required field + ProductId *string `min:"1" type:"string" required:"true"` + + // The identifier of the provisioning artifact. For example, pa-4abcdjnxjj6ne. + // + // ProvisioningArtifactId is a required field + ProvisioningArtifactId *string `min:"1" type:"string" required:"true"` +} + +// String returns the string representation +func (s ListServiceActionsForProvisioningArtifactInput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s ListServiceActionsForProvisioningArtifactInput) GoString() string { + return s.String() +} + +// Validate inspects the fields of the type to determine if they are valid. +func (s *ListServiceActionsForProvisioningArtifactInput) Validate() error { + invalidParams := request.ErrInvalidParams{Context: "ListServiceActionsForProvisioningArtifactInput"} + if s.ProductId == nil { + invalidParams.Add(request.NewErrParamRequired("ProductId")) + } + if s.ProductId != nil && len(*s.ProductId) < 1 { + invalidParams.Add(request.NewErrParamMinLen("ProductId", 1)) + } + if s.ProvisioningArtifactId == nil { + invalidParams.Add(request.NewErrParamRequired("ProvisioningArtifactId")) + } + if s.ProvisioningArtifactId != nil && len(*s.ProvisioningArtifactId) < 1 { + invalidParams.Add(request.NewErrParamMinLen("ProvisioningArtifactId", 1)) + } + + if invalidParams.Len() > 0 { + return invalidParams + } + return nil +} + +// SetAcceptLanguage sets the AcceptLanguage field's value. +func (s *ListServiceActionsForProvisioningArtifactInput) SetAcceptLanguage(v string) *ListServiceActionsForProvisioningArtifactInput { + s.AcceptLanguage = &v + return s +} + +// SetPageSize sets the PageSize field's value. +func (s *ListServiceActionsForProvisioningArtifactInput) SetPageSize(v int64) *ListServiceActionsForProvisioningArtifactInput { + s.PageSize = &v + return s +} + +// SetPageToken sets the PageToken field's value. +func (s *ListServiceActionsForProvisioningArtifactInput) SetPageToken(v string) *ListServiceActionsForProvisioningArtifactInput { + s.PageToken = &v + return s +} + +// SetProductId sets the ProductId field's value. +func (s *ListServiceActionsForProvisioningArtifactInput) SetProductId(v string) *ListServiceActionsForProvisioningArtifactInput { + s.ProductId = &v + return s +} + +// SetProvisioningArtifactId sets the ProvisioningArtifactId field's value. +func (s *ListServiceActionsForProvisioningArtifactInput) SetProvisioningArtifactId(v string) *ListServiceActionsForProvisioningArtifactInput { + s.ProvisioningArtifactId = &v + return s +} + +type ListServiceActionsForProvisioningArtifactOutput struct { + _ struct{} `type:"structure"` + + // The page token to use to retrieve the next set of results. If there are no + // additional results, this value is null. + NextPageToken *string `type:"string"` + + // An object containing information about the self-service actions associated + // with the provisioning artifact. + ServiceActionSummaries []*ServiceActionSummary `type:"list"` +} + +// String returns the string representation +func (s ListServiceActionsForProvisioningArtifactOutput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s ListServiceActionsForProvisioningArtifactOutput) GoString() string { + return s.String() +} + +// SetNextPageToken sets the NextPageToken field's value. +func (s *ListServiceActionsForProvisioningArtifactOutput) SetNextPageToken(v string) *ListServiceActionsForProvisioningArtifactOutput { + s.NextPageToken = &v + return s +} + +// SetServiceActionSummaries sets the ServiceActionSummaries field's value. +func (s *ListServiceActionsForProvisioningArtifactOutput) SetServiceActionSummaries(v []*ServiceActionSummary) *ListServiceActionsForProvisioningArtifactOutput { + s.ServiceActionSummaries = v + return s +} + +type ListServiceActionsInput struct { + _ struct{} `type:"structure"` + + // The language code. + // + // * en - English (default) + // + // * jp - Japanese + // + // * zh - Chinese + AcceptLanguage *string `type:"string"` + + // The maximum number of items to return with this call. + PageSize *int64 `type:"integer"` + + // The page token for the next set of results. To retrieve the first set of + // results, use null. + PageToken *string `type:"string"` +} + +// String returns the string representation +func (s ListServiceActionsInput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s ListServiceActionsInput) GoString() string { + return s.String() +} + +// SetAcceptLanguage sets the AcceptLanguage field's value. +func (s *ListServiceActionsInput) SetAcceptLanguage(v string) *ListServiceActionsInput { + s.AcceptLanguage = &v + return s +} + +// SetPageSize sets the PageSize field's value. +func (s *ListServiceActionsInput) SetPageSize(v int64) *ListServiceActionsInput { + s.PageSize = &v + return s +} + +// SetPageToken sets the PageToken field's value. +func (s *ListServiceActionsInput) SetPageToken(v string) *ListServiceActionsInput { + s.PageToken = &v + return s +} + +type ListServiceActionsOutput struct { + _ struct{} `type:"structure"` + + // The page token to use to retrieve the next set of results. If there are no + // additional results, this value is null. + NextPageToken *string `type:"string"` + + // An object containing information about the service actions associated with + // the provisioning artifact. + ServiceActionSummaries []*ServiceActionSummary `type:"list"` +} + +// String returns the string representation +func (s ListServiceActionsOutput) String() string { return awsutil.Prettify(s) } // GoString returns the string representation -func (s ListResourcesForTagOptionOutput) GoString() string { +func (s ListServiceActionsOutput) GoString() string { return s.String() } -// SetPageToken sets the PageToken field's value. -func (s *ListResourcesForTagOptionOutput) SetPageToken(v string) *ListResourcesForTagOptionOutput { - s.PageToken = &v +// SetNextPageToken sets the NextPageToken field's value. +func (s *ListServiceActionsOutput) SetNextPageToken(v string) *ListServiceActionsOutput { + s.NextPageToken = &v return s } -// SetResourceDetails sets the ResourceDetails field's value. -func (s *ListResourcesForTagOptionOutput) SetResourceDetails(v []*ResourceDetail) *ListResourcesForTagOptionOutput { - s.ResourceDetails = v +// SetServiceActionSummaries sets the ServiceActionSummaries field's value. +func (s *ListServiceActionsOutput) SetServiceActionSummaries(v []*ServiceActionSummary) *ListServiceActionsOutput { + s.ServiceActionSummaries = v return s } @@ -11650,6 +13987,12 @@ type ProvisionedProductDetail struct { // The user-friendly name of the provisioned product. Name *string `min:"1" type:"string"` + // The product identifier. For example, prod-abcdzk7xy33qa. + ProductId *string `min:"1" type:"string"` + + // The identifier of the provisioning artifact. For example, pa-4abcdjnxjj6ne. + ProvisioningArtifactId *string `min:"1" type:"string"` + // The current status of the provisioned product. // // * AVAILABLE - Stable state, ready to perform any operation. The most recent @@ -11721,6 +14064,18 @@ func (s *ProvisionedProductDetail) SetName(v string) *ProvisionedProductDetail { return s } +// SetProductId sets the ProductId field's value. +func (s *ProvisionedProductDetail) SetProductId(v string) *ProvisionedProductDetail { + s.ProductId = &v + return s +} + +// SetProvisioningArtifactId sets the ProvisioningArtifactId field's value. +func (s *ProvisionedProductDetail) SetProvisioningArtifactId(v string) *ProvisionedProductDetail { + s.ProvisioningArtifactId = &v + return s +} + // SetStatus sets the Status field's value. func (s *ProvisionedProductDetail) SetStatus(v string) *ProvisionedProductDetail { s.Status = &v @@ -12304,6 +14659,41 @@ func (s *ProvisioningArtifactSummary) SetProvisioningArtifactMetadata(v map[stri return s } +// An object that contains summary information about a product view and a provisioning +// artifact. +type ProvisioningArtifactView struct { + _ struct{} `type:"structure"` + + // Summary information about a product view. + ProductViewSummary *ProductViewSummary `type:"structure"` + + // Information about a provisioning artifact. A provisioning artifact is also + // known as a product version. + ProvisioningArtifact *ProvisioningArtifact `type:"structure"` +} + +// String returns the string representation +func (s ProvisioningArtifactView) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s ProvisioningArtifactView) GoString() string { + return s.String() +} + +// SetProductViewSummary sets the ProductViewSummary field's value. +func (s *ProvisioningArtifactView) SetProductViewSummary(v *ProductViewSummary) *ProvisioningArtifactView { + s.ProductViewSummary = v + return s +} + +// SetProvisioningArtifact sets the ProvisioningArtifact field's value. +func (s *ProvisioningArtifactView) SetProvisioningArtifact(v *ProvisioningArtifact) *ProvisioningArtifactView { + s.ProvisioningArtifact = v + return s +} + // Information about a parameter used to provision a product. type ProvisioningParameter struct { _ struct{} `type:"structure"` @@ -13389,6 +15779,167 @@ func (s *SearchProvisionedProductsOutput) SetTotalResultsCount(v int64) *SearchP return s } +// A self-service action association consisting of the Action ID, the Product +// ID, and the Provisioning Artifact ID. +type ServiceActionAssociation struct { + _ struct{} `type:"structure"` + + // The product identifier. For example, prod-abcdzk7xy33qa. + // + // ProductId is a required field + ProductId *string `min:"1" type:"string" required:"true"` + + // The identifier of the provisioning artifact. For example, pa-4abcdjnxjj6ne. + // + // ProvisioningArtifactId is a required field + ProvisioningArtifactId *string `min:"1" type:"string" required:"true"` + + // The self-service action identifier. For example, act-fs7abcd89wxyz. + // + // ServiceActionId is a required field + ServiceActionId *string `min:"1" type:"string" required:"true"` +} + +// String returns the string representation +func (s ServiceActionAssociation) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s ServiceActionAssociation) GoString() string { + return s.String() +} + +// Validate inspects the fields of the type to determine if they are valid. +func (s *ServiceActionAssociation) Validate() error { + invalidParams := request.ErrInvalidParams{Context: "ServiceActionAssociation"} + if s.ProductId == nil { + invalidParams.Add(request.NewErrParamRequired("ProductId")) + } + if s.ProductId != nil && len(*s.ProductId) < 1 { + invalidParams.Add(request.NewErrParamMinLen("ProductId", 1)) + } + if s.ProvisioningArtifactId == nil { + invalidParams.Add(request.NewErrParamRequired("ProvisioningArtifactId")) + } + if s.ProvisioningArtifactId != nil && len(*s.ProvisioningArtifactId) < 1 { + invalidParams.Add(request.NewErrParamMinLen("ProvisioningArtifactId", 1)) + } + if s.ServiceActionId == nil { + invalidParams.Add(request.NewErrParamRequired("ServiceActionId")) + } + if s.ServiceActionId != nil && len(*s.ServiceActionId) < 1 { + invalidParams.Add(request.NewErrParamMinLen("ServiceActionId", 1)) + } + + if invalidParams.Len() > 0 { + return invalidParams + } + return nil +} + +// SetProductId sets the ProductId field's value. +func (s *ServiceActionAssociation) SetProductId(v string) *ServiceActionAssociation { + s.ProductId = &v + return s +} + +// SetProvisioningArtifactId sets the ProvisioningArtifactId field's value. +func (s *ServiceActionAssociation) SetProvisioningArtifactId(v string) *ServiceActionAssociation { + s.ProvisioningArtifactId = &v + return s +} + +// SetServiceActionId sets the ServiceActionId field's value. +func (s *ServiceActionAssociation) SetServiceActionId(v string) *ServiceActionAssociation { + s.ServiceActionId = &v + return s +} + +// An object containing detailed information about the self-service action. +type ServiceActionDetail struct { + _ struct{} `type:"structure"` + + // A map that defines the self-service action. + Definition map[string]*string `min:"1" type:"map"` + + // Summary information about the self-service action. + ServiceActionSummary *ServiceActionSummary `type:"structure"` +} + +// String returns the string representation +func (s ServiceActionDetail) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s ServiceActionDetail) GoString() string { + return s.String() +} + +// SetDefinition sets the Definition field's value. +func (s *ServiceActionDetail) SetDefinition(v map[string]*string) *ServiceActionDetail { + s.Definition = v + return s +} + +// SetServiceActionSummary sets the ServiceActionSummary field's value. +func (s *ServiceActionDetail) SetServiceActionSummary(v *ServiceActionSummary) *ServiceActionDetail { + s.ServiceActionSummary = v + return s +} + +// Detailed information about the self-service action. +type ServiceActionSummary struct { + _ struct{} `type:"structure"` + + // The self-service action definition type. For example, SSM_AUTOMATION. + DefinitionType *string `type:"string" enum:"ServiceActionDefinitionType"` + + // The self-service action description. + Description *string `type:"string"` + + // The self-service action identifier. + Id *string `min:"1" type:"string"` + + // The self-service action name. + Name *string `min:"1" type:"string"` +} + +// String returns the string representation +func (s ServiceActionSummary) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s ServiceActionSummary) GoString() string { + return s.String() +} + +// SetDefinitionType sets the DefinitionType field's value. +func (s *ServiceActionSummary) SetDefinitionType(v string) *ServiceActionSummary { + s.DefinitionType = &v + return s +} + +// SetDescription sets the Description field's value. +func (s *ServiceActionSummary) SetDescription(v string) *ServiceActionSummary { + s.Description = &v + return s +} + +// SetId sets the Id field's value. +func (s *ServiceActionSummary) SetId(v string) *ServiceActionSummary { + s.Id = &v + return s +} + +// SetName sets the Name field's value. +func (s *ServiceActionSummary) SetName(v string) *ServiceActionSummary { + s.Name = &v + return s +} + // Information about a tag. A tag is a key-value pair. Tags are propagated to // the resources created when provisioning a product. type Tag struct { @@ -14442,6 +16993,118 @@ func (s *UpdateProvisioningParameter) SetValue(v string) *UpdateProvisioningPara return s } +type UpdateServiceActionInput struct { + _ struct{} `type:"structure"` + + // The language code. + // + // * en - English (default) + // + // * jp - Japanese + // + // * zh - Chinese + AcceptLanguage *string `type:"string"` + + // A map that defines the self-service action. + Definition map[string]*string `min:"1" type:"map"` + + // The self-service action description. + Description *string `type:"string"` + + // The self-service action identifier. + // + // Id is a required field + Id *string `min:"1" type:"string" required:"true"` + + // The self-service action name. + Name *string `min:"1" type:"string"` +} + +// String returns the string representation +func (s UpdateServiceActionInput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s UpdateServiceActionInput) GoString() string { + return s.String() +} + +// Validate inspects the fields of the type to determine if they are valid. +func (s *UpdateServiceActionInput) Validate() error { + invalidParams := request.ErrInvalidParams{Context: "UpdateServiceActionInput"} + if s.Definition != nil && len(s.Definition) < 1 { + invalidParams.Add(request.NewErrParamMinLen("Definition", 1)) + } + if s.Id == nil { + invalidParams.Add(request.NewErrParamRequired("Id")) + } + if s.Id != nil && len(*s.Id) < 1 { + invalidParams.Add(request.NewErrParamMinLen("Id", 1)) + } + if s.Name != nil && len(*s.Name) < 1 { + invalidParams.Add(request.NewErrParamMinLen("Name", 1)) + } + + if invalidParams.Len() > 0 { + return invalidParams + } + return nil +} + +// SetAcceptLanguage sets the AcceptLanguage field's value. +func (s *UpdateServiceActionInput) SetAcceptLanguage(v string) *UpdateServiceActionInput { + s.AcceptLanguage = &v + return s +} + +// SetDefinition sets the Definition field's value. +func (s *UpdateServiceActionInput) SetDefinition(v map[string]*string) *UpdateServiceActionInput { + s.Definition = v + return s +} + +// SetDescription sets the Description field's value. +func (s *UpdateServiceActionInput) SetDescription(v string) *UpdateServiceActionInput { + s.Description = &v + return s +} + +// SetId sets the Id field's value. +func (s *UpdateServiceActionInput) SetId(v string) *UpdateServiceActionInput { + s.Id = &v + return s +} + +// SetName sets the Name field's value. +func (s *UpdateServiceActionInput) SetName(v string) *UpdateServiceActionInput { + s.Name = &v + return s +} + +type UpdateServiceActionOutput struct { + _ struct{} `type:"structure"` + + // Detailed information about the self-service action. + ServiceActionDetail *ServiceActionDetail `type:"structure"` +} + +// String returns the string representation +func (s UpdateServiceActionOutput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s UpdateServiceActionOutput) GoString() string { + return s.String() +} + +// SetServiceActionDetail sets the ServiceActionDetail field's value. +func (s *UpdateServiceActionOutput) SetServiceActionDetail(v *ServiceActionDetail) *UpdateServiceActionOutput { + s.ServiceActionDetail = v + return s +} + type UpdateTagOptionInput struct { _ struct{} `type:"structure"` @@ -14779,6 +17442,42 @@ const ( ResourceAttributeTags = "TAGS" ) +const ( + // ServiceActionAssociationErrorCodeDuplicateResource is a ServiceActionAssociationErrorCode enum value + ServiceActionAssociationErrorCodeDuplicateResource = "DUPLICATE_RESOURCE" + + // ServiceActionAssociationErrorCodeInternalFailure is a ServiceActionAssociationErrorCode enum value + ServiceActionAssociationErrorCodeInternalFailure = "INTERNAL_FAILURE" + + // ServiceActionAssociationErrorCodeLimitExceeded is a ServiceActionAssociationErrorCode enum value + ServiceActionAssociationErrorCodeLimitExceeded = "LIMIT_EXCEEDED" + + // ServiceActionAssociationErrorCodeResourceNotFound is a ServiceActionAssociationErrorCode enum value + ServiceActionAssociationErrorCodeResourceNotFound = "RESOURCE_NOT_FOUND" + + // ServiceActionAssociationErrorCodeThrottling is a ServiceActionAssociationErrorCode enum value + ServiceActionAssociationErrorCodeThrottling = "THROTTLING" +) + +const ( + // ServiceActionDefinitionKeyName is a ServiceActionDefinitionKey enum value + ServiceActionDefinitionKeyName = "Name" + + // ServiceActionDefinitionKeyVersion is a ServiceActionDefinitionKey enum value + ServiceActionDefinitionKeyVersion = "Version" + + // ServiceActionDefinitionKeyAssumeRole is a ServiceActionDefinitionKey enum value + ServiceActionDefinitionKeyAssumeRole = "AssumeRole" + + // ServiceActionDefinitionKeyParameters is a ServiceActionDefinitionKey enum value + ServiceActionDefinitionKeyParameters = "Parameters" +) + +const ( + // ServiceActionDefinitionTypeSsmAutomation is a ServiceActionDefinitionType enum value + ServiceActionDefinitionTypeSsmAutomation = "SSM_AUTOMATION" +) + const ( // SortOrderAscending is a SortOrder enum value SortOrderAscending = "ASCENDING" diff --git a/service/servicecatalog/servicecatalogiface/interface.go b/service/servicecatalog/servicecatalogiface/interface.go index 48c8ba186ce..8723b11be99 100644 --- a/service/servicecatalog/servicecatalogiface/interface.go +++ b/service/servicecatalog/servicecatalogiface/interface.go @@ -72,10 +72,22 @@ type ServiceCatalogAPI interface { AssociateProductWithPortfolioWithContext(aws.Context, *servicecatalog.AssociateProductWithPortfolioInput, ...request.Option) (*servicecatalog.AssociateProductWithPortfolioOutput, error) AssociateProductWithPortfolioRequest(*servicecatalog.AssociateProductWithPortfolioInput) (*request.Request, *servicecatalog.AssociateProductWithPortfolioOutput) + AssociateServiceActionWithProvisioningArtifact(*servicecatalog.AssociateServiceActionWithProvisioningArtifactInput) (*servicecatalog.AssociateServiceActionWithProvisioningArtifactOutput, error) + AssociateServiceActionWithProvisioningArtifactWithContext(aws.Context, *servicecatalog.AssociateServiceActionWithProvisioningArtifactInput, ...request.Option) (*servicecatalog.AssociateServiceActionWithProvisioningArtifactOutput, error) + AssociateServiceActionWithProvisioningArtifactRequest(*servicecatalog.AssociateServiceActionWithProvisioningArtifactInput) (*request.Request, *servicecatalog.AssociateServiceActionWithProvisioningArtifactOutput) + AssociateTagOptionWithResource(*servicecatalog.AssociateTagOptionWithResourceInput) (*servicecatalog.AssociateTagOptionWithResourceOutput, error) AssociateTagOptionWithResourceWithContext(aws.Context, *servicecatalog.AssociateTagOptionWithResourceInput, ...request.Option) (*servicecatalog.AssociateTagOptionWithResourceOutput, error) AssociateTagOptionWithResourceRequest(*servicecatalog.AssociateTagOptionWithResourceInput) (*request.Request, *servicecatalog.AssociateTagOptionWithResourceOutput) + BatchAssociateServiceActionWithProvisioningArtifact(*servicecatalog.BatchAssociateServiceActionWithProvisioningArtifactInput) (*servicecatalog.BatchAssociateServiceActionWithProvisioningArtifactOutput, error) + BatchAssociateServiceActionWithProvisioningArtifactWithContext(aws.Context, *servicecatalog.BatchAssociateServiceActionWithProvisioningArtifactInput, ...request.Option) (*servicecatalog.BatchAssociateServiceActionWithProvisioningArtifactOutput, error) + BatchAssociateServiceActionWithProvisioningArtifactRequest(*servicecatalog.BatchAssociateServiceActionWithProvisioningArtifactInput) (*request.Request, *servicecatalog.BatchAssociateServiceActionWithProvisioningArtifactOutput) + + BatchDisassociateServiceActionFromProvisioningArtifact(*servicecatalog.BatchDisassociateServiceActionFromProvisioningArtifactInput) (*servicecatalog.BatchDisassociateServiceActionFromProvisioningArtifactOutput, error) + BatchDisassociateServiceActionFromProvisioningArtifactWithContext(aws.Context, *servicecatalog.BatchDisassociateServiceActionFromProvisioningArtifactInput, ...request.Option) (*servicecatalog.BatchDisassociateServiceActionFromProvisioningArtifactOutput, error) + BatchDisassociateServiceActionFromProvisioningArtifactRequest(*servicecatalog.BatchDisassociateServiceActionFromProvisioningArtifactInput) (*request.Request, *servicecatalog.BatchDisassociateServiceActionFromProvisioningArtifactOutput) + CopyProduct(*servicecatalog.CopyProductInput) (*servicecatalog.CopyProductOutput, error) CopyProductWithContext(aws.Context, *servicecatalog.CopyProductInput, ...request.Option) (*servicecatalog.CopyProductOutput, error) CopyProductRequest(*servicecatalog.CopyProductInput) (*request.Request, *servicecatalog.CopyProductOutput) @@ -104,6 +116,10 @@ type ServiceCatalogAPI interface { CreateProvisioningArtifactWithContext(aws.Context, *servicecatalog.CreateProvisioningArtifactInput, ...request.Option) (*servicecatalog.CreateProvisioningArtifactOutput, error) CreateProvisioningArtifactRequest(*servicecatalog.CreateProvisioningArtifactInput) (*request.Request, *servicecatalog.CreateProvisioningArtifactOutput) + CreateServiceAction(*servicecatalog.CreateServiceActionInput) (*servicecatalog.CreateServiceActionOutput, error) + CreateServiceActionWithContext(aws.Context, *servicecatalog.CreateServiceActionInput, ...request.Option) (*servicecatalog.CreateServiceActionOutput, error) + CreateServiceActionRequest(*servicecatalog.CreateServiceActionInput) (*request.Request, *servicecatalog.CreateServiceActionOutput) + CreateTagOption(*servicecatalog.CreateTagOptionInput) (*servicecatalog.CreateTagOptionOutput, error) CreateTagOptionWithContext(aws.Context, *servicecatalog.CreateTagOptionInput, ...request.Option) (*servicecatalog.CreateTagOptionOutput, error) CreateTagOptionRequest(*servicecatalog.CreateTagOptionInput) (*request.Request, *servicecatalog.CreateTagOptionOutput) @@ -132,6 +148,10 @@ type ServiceCatalogAPI interface { DeleteProvisioningArtifactWithContext(aws.Context, *servicecatalog.DeleteProvisioningArtifactInput, ...request.Option) (*servicecatalog.DeleteProvisioningArtifactOutput, error) DeleteProvisioningArtifactRequest(*servicecatalog.DeleteProvisioningArtifactInput) (*request.Request, *servicecatalog.DeleteProvisioningArtifactOutput) + DeleteServiceAction(*servicecatalog.DeleteServiceActionInput) (*servicecatalog.DeleteServiceActionOutput, error) + DeleteServiceActionWithContext(aws.Context, *servicecatalog.DeleteServiceActionInput, ...request.Option) (*servicecatalog.DeleteServiceActionOutput, error) + DeleteServiceActionRequest(*servicecatalog.DeleteServiceActionInput) (*request.Request, *servicecatalog.DeleteServiceActionOutput) + DeleteTagOption(*servicecatalog.DeleteTagOptionInput) (*servicecatalog.DeleteTagOptionOutput, error) DeleteTagOptionWithContext(aws.Context, *servicecatalog.DeleteTagOptionInput, ...request.Option) (*servicecatalog.DeleteTagOptionOutput, error) DeleteTagOptionRequest(*servicecatalog.DeleteTagOptionInput) (*request.Request, *servicecatalog.DeleteTagOptionOutput) @@ -180,6 +200,10 @@ type ServiceCatalogAPI interface { DescribeRecordWithContext(aws.Context, *servicecatalog.DescribeRecordInput, ...request.Option) (*servicecatalog.DescribeRecordOutput, error) DescribeRecordRequest(*servicecatalog.DescribeRecordInput) (*request.Request, *servicecatalog.DescribeRecordOutput) + DescribeServiceAction(*servicecatalog.DescribeServiceActionInput) (*servicecatalog.DescribeServiceActionOutput, error) + DescribeServiceActionWithContext(aws.Context, *servicecatalog.DescribeServiceActionInput, ...request.Option) (*servicecatalog.DescribeServiceActionOutput, error) + DescribeServiceActionRequest(*servicecatalog.DescribeServiceActionInput) (*request.Request, *servicecatalog.DescribeServiceActionOutput) + DescribeTagOption(*servicecatalog.DescribeTagOptionInput) (*servicecatalog.DescribeTagOptionOutput, error) DescribeTagOptionWithContext(aws.Context, *servicecatalog.DescribeTagOptionInput, ...request.Option) (*servicecatalog.DescribeTagOptionOutput, error) DescribeTagOptionRequest(*servicecatalog.DescribeTagOptionInput) (*request.Request, *servicecatalog.DescribeTagOptionOutput) @@ -192,6 +216,10 @@ type ServiceCatalogAPI interface { DisassociateProductFromPortfolioWithContext(aws.Context, *servicecatalog.DisassociateProductFromPortfolioInput, ...request.Option) (*servicecatalog.DisassociateProductFromPortfolioOutput, error) DisassociateProductFromPortfolioRequest(*servicecatalog.DisassociateProductFromPortfolioInput) (*request.Request, *servicecatalog.DisassociateProductFromPortfolioOutput) + DisassociateServiceActionFromProvisioningArtifact(*servicecatalog.DisassociateServiceActionFromProvisioningArtifactInput) (*servicecatalog.DisassociateServiceActionFromProvisioningArtifactOutput, error) + DisassociateServiceActionFromProvisioningArtifactWithContext(aws.Context, *servicecatalog.DisassociateServiceActionFromProvisioningArtifactInput, ...request.Option) (*servicecatalog.DisassociateServiceActionFromProvisioningArtifactOutput, error) + DisassociateServiceActionFromProvisioningArtifactRequest(*servicecatalog.DisassociateServiceActionFromProvisioningArtifactInput) (*request.Request, *servicecatalog.DisassociateServiceActionFromProvisioningArtifactOutput) + DisassociateTagOptionFromResource(*servicecatalog.DisassociateTagOptionFromResourceInput) (*servicecatalog.DisassociateTagOptionFromResourceOutput, error) DisassociateTagOptionFromResourceWithContext(aws.Context, *servicecatalog.DisassociateTagOptionFromResourceInput, ...request.Option) (*servicecatalog.DisassociateTagOptionFromResourceOutput, error) DisassociateTagOptionFromResourceRequest(*servicecatalog.DisassociateTagOptionFromResourceInput) (*request.Request, *servicecatalog.DisassociateTagOptionFromResourceOutput) @@ -200,6 +228,10 @@ type ServiceCatalogAPI interface { ExecuteProvisionedProductPlanWithContext(aws.Context, *servicecatalog.ExecuteProvisionedProductPlanInput, ...request.Option) (*servicecatalog.ExecuteProvisionedProductPlanOutput, error) ExecuteProvisionedProductPlanRequest(*servicecatalog.ExecuteProvisionedProductPlanInput) (*request.Request, *servicecatalog.ExecuteProvisionedProductPlanOutput) + ExecuteProvisionedProductServiceAction(*servicecatalog.ExecuteProvisionedProductServiceActionInput) (*servicecatalog.ExecuteProvisionedProductServiceActionOutput, error) + ExecuteProvisionedProductServiceActionWithContext(aws.Context, *servicecatalog.ExecuteProvisionedProductServiceActionInput, ...request.Option) (*servicecatalog.ExecuteProvisionedProductServiceActionOutput, error) + ExecuteProvisionedProductServiceActionRequest(*servicecatalog.ExecuteProvisionedProductServiceActionInput) (*request.Request, *servicecatalog.ExecuteProvisionedProductServiceActionOutput) + ListAcceptedPortfolioShares(*servicecatalog.ListAcceptedPortfolioSharesInput) (*servicecatalog.ListAcceptedPortfolioSharesOutput, error) ListAcceptedPortfolioSharesWithContext(aws.Context, *servicecatalog.ListAcceptedPortfolioSharesInput, ...request.Option) (*servicecatalog.ListAcceptedPortfolioSharesOutput, error) ListAcceptedPortfolioSharesRequest(*servicecatalog.ListAcceptedPortfolioSharesInput) (*request.Request, *servicecatalog.ListAcceptedPortfolioSharesOutput) @@ -254,6 +286,13 @@ type ServiceCatalogAPI interface { ListProvisioningArtifactsWithContext(aws.Context, *servicecatalog.ListProvisioningArtifactsInput, ...request.Option) (*servicecatalog.ListProvisioningArtifactsOutput, error) ListProvisioningArtifactsRequest(*servicecatalog.ListProvisioningArtifactsInput) (*request.Request, *servicecatalog.ListProvisioningArtifactsOutput) + ListProvisioningArtifactsForServiceAction(*servicecatalog.ListProvisioningArtifactsForServiceActionInput) (*servicecatalog.ListProvisioningArtifactsForServiceActionOutput, error) + ListProvisioningArtifactsForServiceActionWithContext(aws.Context, *servicecatalog.ListProvisioningArtifactsForServiceActionInput, ...request.Option) (*servicecatalog.ListProvisioningArtifactsForServiceActionOutput, error) + ListProvisioningArtifactsForServiceActionRequest(*servicecatalog.ListProvisioningArtifactsForServiceActionInput) (*request.Request, *servicecatalog.ListProvisioningArtifactsForServiceActionOutput) + + ListProvisioningArtifactsForServiceActionPages(*servicecatalog.ListProvisioningArtifactsForServiceActionInput, func(*servicecatalog.ListProvisioningArtifactsForServiceActionOutput, bool) bool) error + ListProvisioningArtifactsForServiceActionPagesWithContext(aws.Context, *servicecatalog.ListProvisioningArtifactsForServiceActionInput, func(*servicecatalog.ListProvisioningArtifactsForServiceActionOutput, bool) bool, ...request.Option) error + ListRecordHistory(*servicecatalog.ListRecordHistoryInput) (*servicecatalog.ListRecordHistoryOutput, error) ListRecordHistoryWithContext(aws.Context, *servicecatalog.ListRecordHistoryInput, ...request.Option) (*servicecatalog.ListRecordHistoryOutput, error) ListRecordHistoryRequest(*servicecatalog.ListRecordHistoryInput) (*request.Request, *servicecatalog.ListRecordHistoryOutput) @@ -265,6 +304,20 @@ type ServiceCatalogAPI interface { ListResourcesForTagOptionPages(*servicecatalog.ListResourcesForTagOptionInput, func(*servicecatalog.ListResourcesForTagOptionOutput, bool) bool) error ListResourcesForTagOptionPagesWithContext(aws.Context, *servicecatalog.ListResourcesForTagOptionInput, func(*servicecatalog.ListResourcesForTagOptionOutput, bool) bool, ...request.Option) error + ListServiceActions(*servicecatalog.ListServiceActionsInput) (*servicecatalog.ListServiceActionsOutput, error) + ListServiceActionsWithContext(aws.Context, *servicecatalog.ListServiceActionsInput, ...request.Option) (*servicecatalog.ListServiceActionsOutput, error) + ListServiceActionsRequest(*servicecatalog.ListServiceActionsInput) (*request.Request, *servicecatalog.ListServiceActionsOutput) + + ListServiceActionsPages(*servicecatalog.ListServiceActionsInput, func(*servicecatalog.ListServiceActionsOutput, bool) bool) error + ListServiceActionsPagesWithContext(aws.Context, *servicecatalog.ListServiceActionsInput, func(*servicecatalog.ListServiceActionsOutput, bool) bool, ...request.Option) error + + ListServiceActionsForProvisioningArtifact(*servicecatalog.ListServiceActionsForProvisioningArtifactInput) (*servicecatalog.ListServiceActionsForProvisioningArtifactOutput, error) + ListServiceActionsForProvisioningArtifactWithContext(aws.Context, *servicecatalog.ListServiceActionsForProvisioningArtifactInput, ...request.Option) (*servicecatalog.ListServiceActionsForProvisioningArtifactOutput, error) + ListServiceActionsForProvisioningArtifactRequest(*servicecatalog.ListServiceActionsForProvisioningArtifactInput) (*request.Request, *servicecatalog.ListServiceActionsForProvisioningArtifactOutput) + + ListServiceActionsForProvisioningArtifactPages(*servicecatalog.ListServiceActionsForProvisioningArtifactInput, func(*servicecatalog.ListServiceActionsForProvisioningArtifactOutput, bool) bool) error + ListServiceActionsForProvisioningArtifactPagesWithContext(aws.Context, *servicecatalog.ListServiceActionsForProvisioningArtifactInput, func(*servicecatalog.ListServiceActionsForProvisioningArtifactOutput, bool) bool, ...request.Option) error + ListTagOptions(*servicecatalog.ListTagOptionsInput) (*servicecatalog.ListTagOptionsOutput, error) ListTagOptionsWithContext(aws.Context, *servicecatalog.ListTagOptionsInput, ...request.Option) (*servicecatalog.ListTagOptionsOutput, error) ListTagOptionsRequest(*servicecatalog.ListTagOptionsInput) (*request.Request, *servicecatalog.ListTagOptionsOutput) @@ -329,6 +382,10 @@ type ServiceCatalogAPI interface { UpdateProvisioningArtifactWithContext(aws.Context, *servicecatalog.UpdateProvisioningArtifactInput, ...request.Option) (*servicecatalog.UpdateProvisioningArtifactOutput, error) UpdateProvisioningArtifactRequest(*servicecatalog.UpdateProvisioningArtifactInput) (*request.Request, *servicecatalog.UpdateProvisioningArtifactOutput) + UpdateServiceAction(*servicecatalog.UpdateServiceActionInput) (*servicecatalog.UpdateServiceActionOutput, error) + UpdateServiceActionWithContext(aws.Context, *servicecatalog.UpdateServiceActionInput, ...request.Option) (*servicecatalog.UpdateServiceActionOutput, error) + UpdateServiceActionRequest(*servicecatalog.UpdateServiceActionInput) (*request.Request, *servicecatalog.UpdateServiceActionOutput) + UpdateTagOption(*servicecatalog.UpdateTagOptionInput) (*servicecatalog.UpdateTagOptionOutput, error) UpdateTagOptionWithContext(aws.Context, *servicecatalog.UpdateTagOptionInput, ...request.Option) (*servicecatalog.UpdateTagOptionOutput, error) UpdateTagOptionRequest(*servicecatalog.UpdateTagOptionInput) (*request.Request, *servicecatalog.UpdateTagOptionOutput) diff --git a/service/transcribeservice/api.go b/service/transcribeservice/api.go index d1786d553f5..3af1ea9d372 100644 --- a/service/transcribeservice/api.go +++ b/service/transcribeservice/api.go @@ -57,7 +57,10 @@ func (c *TranscribeService) CreateVocabularyRequest(input *CreateVocabularyInput // CreateVocabulary API operation for Amazon Transcribe Service. // // Creates a new custom vocabulary that you can use to change the way Amazon -// Transcribe handles transcription of an audio file. +// Transcribe handles transcription of an audio file. Note that vocabularies +// for en-AU, en-UK, and fr-CA languages that are in preview are not available. +// In the console, the vocabulary section will be greyed-out and SDK will return +// error message. // // 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 @@ -68,9 +71,9 @@ func (c *TranscribeService) CreateVocabularyRequest(input *CreateVocabularyInput // // Returned Error Codes: // * ErrCodeBadRequestException "BadRequestException" -// Your request didn't pass one or more validation tests. For example, a name -// already exists when creating a resource or a name may not exist when getting -// a transcription job or custom vocabulary. See the exception Message field +// Your request didn't pass one or more validation tests. For example, if the +// transcription you're trying to delete doesn't exist of if it is in a non-terminal +// state (for example, it's "in progress"). See the exception Message field // for more information. // // * ErrCodeLimitExceededException "LimitExceededException" @@ -111,6 +114,99 @@ func (c *TranscribeService) CreateVocabularyWithContext(ctx aws.Context, input * return out, req.Send() } +const opDeleteTranscriptionJob = "DeleteTranscriptionJob" + +// DeleteTranscriptionJobRequest generates a "aws/request.Request" representing the +// client's request for the DeleteTranscriptionJob operation. The "output" return +// value will be populated with the request's response once the request completes +// successfully. +// +// Use "Send" method on the returned Request to send the API call to the service. +// the "output" return value is not valid until after Send returns without error. +// +// See DeleteTranscriptionJob for more information on using the DeleteTranscriptionJob +// API call, and error handling. +// +// This method is useful when you want to inject custom logic or configuration +// into the SDK's request lifecycle. Such as custom headers, or retry logic. +// +// +// // Example sending a request using the DeleteTranscriptionJobRequest method. +// req, resp := client.DeleteTranscriptionJobRequest(params) +// +// err := req.Send() +// if err == nil { // resp is now filled +// fmt.Println(resp) +// } +// +// See also, https://docs.aws.amazon.com/goto/WebAPI/transcribe-2017-10-26/DeleteTranscriptionJob +func (c *TranscribeService) DeleteTranscriptionJobRequest(input *DeleteTranscriptionJobInput) (req *request.Request, output *DeleteTranscriptionJobOutput) { + op := &request.Operation{ + Name: opDeleteTranscriptionJob, + HTTPMethod: "POST", + HTTPPath: "/", + } + + if input == nil { + input = &DeleteTranscriptionJobInput{} + } + + output = &DeleteTranscriptionJobOutput{} + req = c.newRequest(op, input, output) + req.Handlers.Unmarshal.Remove(jsonrpc.UnmarshalHandler) + req.Handlers.Unmarshal.PushBackNamed(protocol.UnmarshalDiscardBodyHandler) + return +} + +// DeleteTranscriptionJob API operation for Amazon Transcribe Service. +// +// Deletes a previously submitted transcription job as well as any other generated +// results such as the transcription, models, and so on. +// +// 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 Transcribe Service's +// API operation DeleteTranscriptionJob for usage and error information. +// +// Returned Error Codes: +// * ErrCodeLimitExceededException "LimitExceededException" +// Either you have sent too many requests or your input file is too long. Wait +// before you resend your request, or use a smaller file and resend the request. +// +// * ErrCodeBadRequestException "BadRequestException" +// Your request didn't pass one or more validation tests. For example, if the +// transcription you're trying to delete doesn't exist of if it is in a non-terminal +// state (for example, it's "in progress"). See the exception Message field +// for more information. +// +// * ErrCodeInternalFailureException "InternalFailureException" +// There was an internal error. Check the error message and try your request +// again. +// +// See also, https://docs.aws.amazon.com/goto/WebAPI/transcribe-2017-10-26/DeleteTranscriptionJob +func (c *TranscribeService) DeleteTranscriptionJob(input *DeleteTranscriptionJobInput) (*DeleteTranscriptionJobOutput, error) { + req, out := c.DeleteTranscriptionJobRequest(input) + return out, req.Send() +} + +// DeleteTranscriptionJobWithContext is the same as DeleteTranscriptionJob with the addition of +// the ability to pass a context and additional request options. +// +// See DeleteTranscriptionJob 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 *TranscribeService) DeleteTranscriptionJobWithContext(ctx aws.Context, input *DeleteTranscriptionJobInput, opts ...request.Option) (*DeleteTranscriptionJobOutput, error) { + req, out := c.DeleteTranscriptionJobRequest(input) + req.SetContext(ctx) + req.ApplyOptions(opts...) + return out, req.Send() +} + const opDeleteVocabulary = "DeleteVocabulary" // DeleteVocabularyRequest generates a "aws/request.Request" representing the @@ -176,9 +272,9 @@ func (c *TranscribeService) DeleteVocabularyRequest(input *DeleteVocabularyInput // before you resend your request, or use a smaller file and resend the request. // // * ErrCodeBadRequestException "BadRequestException" -// Your request didn't pass one or more validation tests. For example, a name -// already exists when creating a resource or a name may not exist when getting -// a transcription job or custom vocabulary. See the exception Message field +// Your request didn't pass one or more validation tests. For example, if the +// transcription you're trying to delete doesn't exist of if it is in a non-terminal +// state (for example, it's "in progress"). See the exception Message field // for more information. // // * ErrCodeInternalFailureException "InternalFailureException" @@ -265,9 +361,9 @@ func (c *TranscribeService) GetTranscriptionJobRequest(input *GetTranscriptionJo // // Returned Error Codes: // * ErrCodeBadRequestException "BadRequestException" -// Your request didn't pass one or more validation tests. For example, a name -// already exists when creating a resource or a name may not exist when getting -// a transcription job or custom vocabulary. See the exception Message field +// Your request didn't pass one or more validation tests. For example, if the +// transcription you're trying to delete doesn't exist of if it is in a non-terminal +// state (for example, it's "in progress"). See the exception Message field // for more information. // // * ErrCodeLimitExceededException "LimitExceededException" @@ -348,7 +444,9 @@ func (c *TranscribeService) GetVocabularyRequest(input *GetVocabularyInput) (req // GetVocabulary API operation for Amazon Transcribe Service. // -// Gets information about a vocabulary. +// Gets information about a vocabulary. Note that vocabularies for en-AU, en-UK, +// and fr-CA languages that are in preview are not available. In the console, +// the vocabulary section will be greyed-out and SDK will return error message. // // 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 @@ -371,9 +469,9 @@ func (c *TranscribeService) GetVocabularyRequest(input *GetVocabularyInput) (req // again. // // * ErrCodeBadRequestException "BadRequestException" -// Your request didn't pass one or more validation tests. For example, a name -// already exists when creating a resource or a name may not exist when getting -// a transcription job or custom vocabulary. See the exception Message field +// Your request didn't pass one or more validation tests. For example, if the +// transcription you're trying to delete doesn't exist of if it is in a non-terminal +// state (for example, it's "in progress"). See the exception Message field // for more information. // // See also, https://docs.aws.amazon.com/goto/WebAPI/transcribe-2017-10-26/GetVocabulary @@ -459,9 +557,9 @@ func (c *TranscribeService) ListTranscriptionJobsRequest(input *ListTranscriptio // // Returned Error Codes: // * ErrCodeBadRequestException "BadRequestException" -// Your request didn't pass one or more validation tests. For example, a name -// already exists when creating a resource or a name may not exist when getting -// a transcription job or custom vocabulary. See the exception Message field +// Your request didn't pass one or more validation tests. For example, if the +// transcription you're trying to delete doesn't exist of if it is in a non-terminal +// state (for example, it's "in progress"). See the exception Message field // for more information. // // * ErrCodeLimitExceededException "LimitExceededException" @@ -606,9 +704,9 @@ func (c *TranscribeService) ListVocabulariesRequest(input *ListVocabulariesInput // // Returned Error Codes: // * ErrCodeBadRequestException "BadRequestException" -// Your request didn't pass one or more validation tests. For example, a name -// already exists when creating a resource or a name may not exist when getting -// a transcription job or custom vocabulary. See the exception Message field +// Your request didn't pass one or more validation tests. For example, if the +// transcription you're trying to delete doesn't exist of if it is in a non-terminal +// state (for example, it's "in progress"). See the exception Message field // for more information. // // * ErrCodeLimitExceededException "LimitExceededException" @@ -735,7 +833,9 @@ func (c *TranscribeService) StartTranscriptionJobRequest(input *StartTranscripti // StartTranscriptionJob API operation for Amazon Transcribe Service. // -// Starts an asynchronous job to transcribe speech to text. +// Starts an asynchronous job to transcribe speech to text. Note that en-AU, +// en-UK, and fr-CA languages are in preview and are only available to whitelisted +// customers. // // 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 @@ -746,9 +846,9 @@ func (c *TranscribeService) StartTranscriptionJobRequest(input *StartTranscripti // // Returned Error Codes: // * ErrCodeBadRequestException "BadRequestException" -// Your request didn't pass one or more validation tests. For example, a name -// already exists when creating a resource or a name may not exist when getting -// a transcription job or custom vocabulary. See the exception Message field +// Your request didn't pass one or more validation tests. For example, if the +// transcription you're trying to delete doesn't exist of if it is in a non-terminal +// state (for example, it's "in progress"). See the exception Message field // for more information. // // * ErrCodeLimitExceededException "LimitExceededException" @@ -835,7 +935,9 @@ func (c *TranscribeService) UpdateVocabularyRequest(input *UpdateVocabularyInput // // Updates an existing vocabulary with new values. The UpdateVocabulary operation // overwrites all of the existing information with the values that you provide -// in the request. +// in the request. Note that vocabularies for en-AU, en-UK, and fr-CA languages +// that are in preview are not available. In the console, the vocabulary section +// will be greyed-out and SDK will return error message. // // 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 @@ -846,9 +948,9 @@ func (c *TranscribeService) UpdateVocabularyRequest(input *UpdateVocabularyInput // // Returned Error Codes: // * ErrCodeBadRequestException "BadRequestException" -// Your request didn't pass one or more validation tests. For example, a name -// already exists when creating a resource or a name may not exist when getting -// a transcription job or custom vocabulary. See the exception Message field +// Your request didn't pass one or more validation tests. For example, if the +// transcription you're trying to delete doesn't exist of if it is in a non-terminal +// state (for example, it's "in progress"). See the exception Message field // for more information. // // * ErrCodeLimitExceededException "LimitExceededException" @@ -1024,6 +1126,61 @@ func (s *CreateVocabularyOutput) SetVocabularyState(v string) *CreateVocabularyO return s } +type DeleteTranscriptionJobInput struct { + _ struct{} `type:"structure"` + + // The name of the transcription job to be deleted. + // + // TranscriptionJobName is a required field + TranscriptionJobName *string `min:"1" type:"string" required:"true"` +} + +// String returns the string representation +func (s DeleteTranscriptionJobInput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s DeleteTranscriptionJobInput) GoString() string { + return s.String() +} + +// Validate inspects the fields of the type to determine if they are valid. +func (s *DeleteTranscriptionJobInput) Validate() error { + invalidParams := request.ErrInvalidParams{Context: "DeleteTranscriptionJobInput"} + if s.TranscriptionJobName == nil { + invalidParams.Add(request.NewErrParamRequired("TranscriptionJobName")) + } + if s.TranscriptionJobName != nil && len(*s.TranscriptionJobName) < 1 { + invalidParams.Add(request.NewErrParamMinLen("TranscriptionJobName", 1)) + } + + if invalidParams.Len() > 0 { + return invalidParams + } + return nil +} + +// SetTranscriptionJobName sets the TranscriptionJobName field's value. +func (s *DeleteTranscriptionJobInput) SetTranscriptionJobName(v string) *DeleteTranscriptionJobInput { + s.TranscriptionJobName = &v + return s +} + +type DeleteTranscriptionJobOutput struct { + _ struct{} `type:"structure"` +} + +// String returns the string representation +func (s DeleteTranscriptionJobOutput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s DeleteTranscriptionJobOutput) GoString() string { + return s.String() +} + type DeleteVocabularyInput struct { _ struct{} `type:"structure"` @@ -1808,7 +1965,8 @@ func (s *Transcript) SetTranscriptFileUri(v string) *Transcript { } // Describes an asynchronous transcription job that was created with the StartTranscriptionJob -// operation. +// operation. Note that en-AU, en-UK, and fr-CA languages are in preview and +// are only available to whitelisted customers. type TranscriptionJob struct { _ struct{} `type:"structure"` @@ -1926,7 +2084,9 @@ func (s *TranscriptionJob) SetTranscriptionJobStatus(v string) *TranscriptionJob return s } -// Provides a summary of information about a transcription job. +// Provides a summary of information about a transcription job. Note that en-AU, +// en-UK, and fr-CA languages are in preview and are only available to whitelisted +// customers. type TranscriptionJobSummary struct { _ struct{} `type:"structure"` @@ -2133,7 +2293,10 @@ func (s *UpdateVocabularyOutput) SetVocabularyState(v string) *UpdateVocabularyO return s } -// Provides information about a custom vocabulary. +// Provides information about a custom vocabulary. Note that vocabularies for +// en-AU, en-UK, and fr-CA languages that are in preview are not available. +// In the console, the vocabulary section will be greyed-out and SDK will return +// error message. type VocabularyInfo struct { _ struct{} `type:"structure"` @@ -2191,6 +2354,15 @@ const ( // LanguageCodeEsUs is a LanguageCode enum value LanguageCodeEsUs = "es-US" + + // LanguageCodeEnAu is a LanguageCode enum value + LanguageCodeEnAu = "en-AU" + + // LanguageCodeFrCa is a LanguageCode enum value + LanguageCodeFrCa = "fr-CA" + + // LanguageCodeEnUk is a LanguageCode enum value + LanguageCodeEnUk = "en-UK" ) const ( diff --git a/service/transcribeservice/errors.go b/service/transcribeservice/errors.go index c656e360950..27e99b99655 100644 --- a/service/transcribeservice/errors.go +++ b/service/transcribeservice/errors.go @@ -7,9 +7,9 @@ const ( // ErrCodeBadRequestException for service response error code // "BadRequestException". // - // Your request didn't pass one or more validation tests. For example, a name - // already exists when creating a resource or a name may not exist when getting - // a transcription job or custom vocabulary. See the exception Message field + // Your request didn't pass one or more validation tests. For example, if the + // transcription you're trying to delete doesn't exist of if it is in a non-terminal + // state (for example, it's "in progress"). See the exception Message field // for more information. ErrCodeBadRequestException = "BadRequestException" diff --git a/service/transcribeservice/transcribeserviceiface/interface.go b/service/transcribeservice/transcribeserviceiface/interface.go index 320acba838f..1680394d011 100644 --- a/service/transcribeservice/transcribeserviceiface/interface.go +++ b/service/transcribeservice/transcribeserviceiface/interface.go @@ -64,6 +64,10 @@ type TranscribeServiceAPI interface { CreateVocabularyWithContext(aws.Context, *transcribeservice.CreateVocabularyInput, ...request.Option) (*transcribeservice.CreateVocabularyOutput, error) CreateVocabularyRequest(*transcribeservice.CreateVocabularyInput) (*request.Request, *transcribeservice.CreateVocabularyOutput) + DeleteTranscriptionJob(*transcribeservice.DeleteTranscriptionJobInput) (*transcribeservice.DeleteTranscriptionJobOutput, error) + DeleteTranscriptionJobWithContext(aws.Context, *transcribeservice.DeleteTranscriptionJobInput, ...request.Option) (*transcribeservice.DeleteTranscriptionJobOutput, error) + DeleteTranscriptionJobRequest(*transcribeservice.DeleteTranscriptionJobInput) (*request.Request, *transcribeservice.DeleteTranscriptionJobOutput) + DeleteVocabulary(*transcribeservice.DeleteVocabularyInput) (*transcribeservice.DeleteVocabularyOutput, error) DeleteVocabularyWithContext(aws.Context, *transcribeservice.DeleteVocabularyInput, ...request.Option) (*transcribeservice.DeleteVocabularyOutput, error) DeleteVocabularyRequest(*transcribeservice.DeleteVocabularyInput) (*request.Request, *transcribeservice.DeleteVocabularyOutput)