mirrors/external-dns
1
0
Fork 0
mirror of https://github.com/kubernetes-sigs/external-dns.git synced 2025-08-06 17:46:57 +02:00
Code Issues Packages Projects Releases Wiki Activity

experiment: use testify in test code (#186)

Browse Source 
* ref(source): use testify with mocks in test code

* fix: re-introduce NewMockSource for convenience

* fix: avoid circular dependency

* ref: increase usage of testify

* chore: vendor testify as a dependency

* fix(*): cleanup testify expectations
This commit is contained in:
Martin Linkhorst 2017-05-31 10:24:11 +02:00 committed by GitHub
parent f06fb65917
commit 406afacbf7
187 changed files with 27882 additions and 3458 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

22
controller/controller_test.go
View File

@ -21,10 +21,13 @@ import (
"testing"
"github.com/kubernetes-incubator/external-dns/endpoint"
"github.com/kubernetes-incubator/external-dns/internal/testutils"
"github.com/kubernetes-incubator/external-dns/plan"
"github.com/kubernetes-incubator/external-dns/provider"
"github.com/kubernetes-incubator/external-dns/registry"
"github.com/kubernetes-incubator/external-dns/source"
"github.com/stretchr/testify/assert"
"github.com/stretchr/testify/require"
)
// mockProvider returns mock endpoints and validates changes.
@ -84,8 +87,8 @@ func newMockProvider(endpoints []*endpoint.Endpoint, changes *plan.Changes) prov
// TestRunOnce tests that RunOnce correctly orchestrates the different components.
func TestRunOnce(t *testing.T) {
// Fake some desired endpoints coming from our source.
source := source.NewMockSource(
[]*endpoint.Endpoint{
source := new(testutils.MockSource)
source.On("Endpoints").Return([]*endpoint.Endpoint{
{
DNSName: "create-record",
Target: "1.2.3.4",
@ -94,8 +97,7 @@ func TestRunOnce(t *testing.T) {
DNSName: "update-record",
Target: "8.8.4.4",
},
},
)
}, nil)
// Fake some existing records in our DNS provider and validate some desired changes.
provider := newMockProvider(
@ -125,7 +127,8 @@ func TestRunOnce(t *testing.T) {
},
)
r, _ := registry.NewNoopRegistry(provider)
r, err := registry.NewNoopRegistry(provider)
require.NoError(t, err)
// Run our controller once to trigger the validation.
ctrl := &Controller{
@ -134,9 +137,8 @@ func TestRunOnce(t *testing.T) {
Policy: &plan.SyncPolicy{},
}
err := ctrl.RunOnce()
assert.NoError(t, ctrl.RunOnce())
if err != nil {
t.Fatal(err)
}
// Validate that the mock source was called.
source.AssertExpectations(t)
}

7
endpoint/endpoint_test.go
View File

@ -17,8 +17,9 @@ limitations under the License.
package endpoint
import (
"reflect"
"testing"
"github.com/stretchr/testify/assert"
)
func TestNewEndpoint(t *testing.T) {
@ -43,7 +44,5 @@ func TestMergeLabels(t *testing.T) {
"baz": "qux",
}
e.MergeLabels(map[string]string{"baz": "baz", "new": "fox"})
if !reflect.DeepEqual(e.Labels, map[string]string{"foo": "bar", "baz": "qux", "new": "fox"}) {
t.Error("invalid merge result")
}
assert.Equal(t, map[string]string{"foo": "bar", "baz": "qux", "new": "fox"}, e.Labels)
}

20
glide.lock generated
View File

@ -1,5 +1,5 @@
hash: 9acd732aa42d366638309eb85248ff41cdef27870c09a060502d9fec5ed84e8f
updated: 2017-05-15T11:29:00.450041553+02:00
hash: c00aa897138844c5db59c71eabfeb24df7b9632db00ef8f038027d4b022a428b
updated: 2017-05-23T16:20:11.952490108+02:00
imports:
- name: bitbucket.org/ww/goautoneg
version: 75cd24fc2f2c2a2088577d12123ddee5f54e0675
@ -17,7 +17,7 @@ imports:
- name: github.com/alecthomas/units
version: 2efee857e7cfd4f3d0138cc3cbb1b4966962b93a
- name: github.com/aws/aws-sdk-go
version: cea091b5b8fe6fcecf0eb6ec8f1a2570ff4ee6a7
version: 48385c808742c8f5f3d3a466d172a52b961ecd7c
subpackages:
- aws
- aws/awserr
@ -97,7 +97,7 @@ imports:
- name: github.com/kubernetes/repo-infra
version: 4667983ff6a1c7dff07191106392ad4bcad60c29
- name: github.com/linki/instrumented_http
version: 74fdeadb7e945ec3cc9dcbefed6a6b148ef00d18
version: 0a1a371dd29c69916c8a13be23849354332674c7
- name: github.com/mailru/easyjson
version: d5b7844b561a7bc640052f1b935f7b800330d7e0
subpackages:
@ -108,6 +108,10 @@ imports:
version: fc2b8d3a73c4867e51861bbdd5ae3c1f0869dd6a
subpackages:
- pbutil
- name: github.com/pmezard/go-difflib
version: d8ed2627bdf02c080bf22230dbb337003b7aba2d
subpackages:
- difflib
- name: github.com/prometheus/client_golang
version: c5b7fccd204277076155f10851dad72b76a49317
subpackages:
@ -132,6 +136,14 @@ imports:
version: ba1b36c82c5e05c4f912a88eab0dcd91a171688f
- name: github.com/spf13/pflag
version: 9ff6c6923cfffbcd502984b8e0c80539a94968b7
- name: github.com/stretchr/objx
version: cbeaeb16a013161a98496fad62933b1d21786672
- name: github.com/stretchr/testify
version: 69483b4bd14f5845b5a1e55bca19e954e827f1d0
subpackages:
- assert
- mock
- require
- name: github.com/ugorji/go
version: ded73eae5db7e7a0ef6f55aace87a2873c5d2b74
subpackages:

6
glide.yaml
View File

@ -14,6 +14,12 @@ import:
version: ~0.8.0
subpackages:
- prometheus/promhttp
- package: github.com/stretchr/testify
version: ~1.1.4
subpackages:
- assert
- mock
- require
- package: golang.org/x/net
subpackages:
- context

28
source/mock_source.go → internal/testutils/mock_source.go
View File

@ -14,21 +14,27 @@ See the License for the specific language governing permissions and
limitations under the License.
*/
package source
package testutils
import "github.com/kubernetes-incubator/external-dns/endpoint"
import (
"github.com/stretchr/testify/mock"
// mockSource returns mock endpoints.
type mockSource struct {
store []*endpoint.Endpoint
}
"github.com/kubernetes-incubator/external-dns/endpoint"
)
// NewMockSource creates a new mockSource returning the given endpoints.
func NewMockSource(endpoints []*endpoint.Endpoint) Source {
return &mockSource{store: endpoints}
// MockSource returns mock endpoints.
type MockSource struct {
mock.Mock
}
// Endpoints returns the desired mock endpoints.
func (s *mockSource) Endpoints() ([]*endpoint.Endpoint, error) {
return s.store, nil
func (m *MockSource) Endpoints() ([]*endpoint.Endpoint, error) {
args := m.Called()
endpoints := args.Get(0)
if endpoints == nil {
return nil, args.Error(1)
}
return endpoints.([]*endpoint.Endpoint), args.Error(1)
}

31
pkg/apis/externaldns/types_test.go
View File

@ -18,9 +18,11 @@ package externaldns
import (
"os"
"reflect"
"testing"
"time"
"github.com/stretchr/testify/assert"
"github.com/stretchr/testify/require"
)
var (
@ -141,38 +143,23 @@ func TestParseFlags(t *testing.T) {
} {
t.Run(ti.title, func(t *testing.T) {
originalEnv := setEnv(t, ti.envVars)
defer func() {
restoreEnv(t, originalEnv)
}()
defer func() { restoreEnv(t, originalEnv) }()
cfg := NewConfig()
if err := cfg.ParseFlags(ti.args); err != nil {
t.Error(err)
}
validateConfig(t, cfg, ti.expected)
require.NoError(t, cfg.ParseFlags(ti.args))
assert.Equal(t, ti.expected, cfg)
})
}
}
// helper functions
func validateConfig(t *testing.T, got, expected *Config) {
if !reflect.DeepEqual(got, expected) {
t.Errorf("config is wrong")
}
}
func setEnv(t *testing.T, env map[string]string) map[string]string {
originalEnv := map[string]string{}
for k, v := range env {
originalEnv[k] = os.Getenv(k)
if err := os.Setenv(k, v); err != nil {
t.Fatal(err)
}
require.NoError(t, os.Setenv(k, v))
}
return originalEnv
@ -180,8 +167,6 @@ func setEnv(t *testing.T, env map[string]string) map[string]string {
func restoreEnv(t *testing.T, originalEnv map[string]string) {
for k, v := range originalEnv {
if err := os.Setenv(k, v); err != nil {
t.Fatal(err)
}
require.NoError(t, os.Setenv(k, v))
}
}

31
pkg/apis/externaldns/validation/validation_test.go
View File

@ -20,45 +20,36 @@ import (
"testing"
"github.com/kubernetes-incubator/external-dns/pkg/apis/externaldns"
"github.com/stretchr/testify/assert"
"github.com/stretchr/testify/require"
)
func TestValidateFlags(t *testing.T) {
cfg := newValidConfig(t)
if err := ValidateConfig(cfg); err != nil {
t.Errorf("valid config should be valid: %s", err)
}
assert.NoError(t, ValidateConfig(cfg))
cfg = newValidConfig(t)
cfg.LogFormat = "test"
if err := ValidateConfig(cfg); err == nil {
t.Errorf("unsupported log format should fail: %s", cfg.LogFormat)
}
assert.Error(t, ValidateConfig(cfg))
cfg = newValidConfig(t)
cfg.LogFormat = ""
if err := ValidateConfig(cfg); err == nil {
t.Errorf("unsupported log format should fail: %s", cfg.LogFormat)
}
assert.Error(t, ValidateConfig(cfg))
for _, format := range []string{"text", "json"} {
cfg = newValidConfig(t)
cfg.LogFormat = format
if err := ValidateConfig(cfg); err != nil {
t.Errorf("supported log format: %s should not fail", format)
}
assert.NoError(t, ValidateConfig(cfg))
}
cfg = newValidConfig(t)
cfg.Sources = []string{}
if err := ValidateConfig(cfg); err == nil {
t.Error("missing at least one source should fail")
}
assert.Error(t, ValidateConfig(cfg))
cfg = newValidConfig(t)
cfg.Provider = ""
if err := ValidateConfig(cfg); err == nil {
t.Error("missing provider should fail")
}
assert.Error(t, ValidateConfig(cfg))
}
func newValidConfig(t *testing.T) *externaldns.Config {
@ -68,9 +59,7 @@ func newValidConfig(t *testing.T) *externaldns.Config {
cfg.Sources = []string{"test-source"}
cfg.Provider = "test-provider"
if err := ValidateConfig(cfg); err != nil {
t.Fatalf("newValidConfig should return valid config")
}
require.NoError(t, ValidateConfig(cfg))
return cfg
}

153
provider/aws_test.go
View File

@ -19,16 +19,17 @@ package provider
import (
"fmt"
"net"
"reflect"
"testing"
"github.com/aws/aws-sdk-go/aws"
"github.com/aws/aws-sdk-go/aws/awserr"
"github.com/aws/aws-sdk-go/service/route53"
"github.com/kubernetes-incubator/external-dns/endpoint"
"github.com/kubernetes-incubator/external-dns/internal/testutils"
"github.com/kubernetes-incubator/external-dns/plan"
"github.com/stretchr/testify/assert"
"github.com/stretchr/testify/require"
)
// Compile time check for interface conformance
@ -147,9 +148,7 @@ func TestAWSZones(t *testing.T) {
provider := newAWSProvider(t, "ext-dns-test-2.teapot.zalan.do.", false, []*endpoint.Endpoint{})
zones, err := provider.Zones()
if err != nil {
t.Fatal(err)
}
require.NoError(t, err)
validateAWSZones(t, zones, map[string]*route53.HostedZone{
"/hostedzone/zone-1.ext-dns-test-2.teapot.zalan.do.": {
@ -175,9 +174,7 @@ func TestAWSRecords(t *testing.T) {
})
records, err := provider.Records()
if err != nil {
t.Fatal(err)
}
require.NoError(t, err)
validateEndpoints(t, records, []*endpoint.Endpoint{
endpoint.NewEndpoint("list-test.zone-1.ext-dns-test-2.teapot.zalan.do", "1.2.3.4", "A"),
@ -195,14 +192,10 @@ func TestAWSCreateRecords(t *testing.T) {
endpoint.NewEndpoint("create-test-cname.zone-1.ext-dns-test-2.teapot.zalan.do", "foo.elb.amazonaws.com", ""),
}
if err := provider.CreateRecords(records); err != nil {
t.Fatal(err)
}
require.NoError(t, provider.CreateRecords(records))
records, err := provider.Records()
if err != nil {
t.Fatal(err)
}
require.NoError(t, err)
validateEndpoints(t, records, []*endpoint.Endpoint{
endpoint.NewEndpoint("create-test.zone-1.ext-dns-test-2.teapot.zalan.do", "1.2.3.4", "A"),
@ -229,14 +222,10 @@ func TestAWSUpdateRecords(t *testing.T) {
endpoint.NewEndpoint("update-test-cname.zone-1.ext-dns-test-2.teapot.zalan.do", "bar.elb.amazonaws.com", "CNAME"),
}
if err := provider.UpdateRecords(updatedRecords, currentRecords); err != nil {
t.Fatal(err)
}
require.NoError(t, provider.UpdateRecords(updatedRecords, currentRecords))
records, err := provider.Records()
if err != nil {
t.Fatal(err)
}
require.NoError(t, err)
validateEndpoints(t, records, []*endpoint.Endpoint{
endpoint.NewEndpoint("update-test.zone-1.ext-dns-test-2.teapot.zalan.do", "1.2.3.4", "A"),
@ -256,14 +245,10 @@ func TestAWSDeleteRecords(t *testing.T) {
provider := newAWSProvider(t, "ext-dns-test-2.teapot.zalan.do.", false, originalEndpoints)
if err := provider.DeleteRecords(originalEndpoints); err != nil {
t.Fatal(err)
}
require.NoError(t, provider.DeleteRecords(originalEndpoints))
records, err := provider.Records()
if err != nil {
t.Fatal(err)
}
require.NoError(t, err)
validateEndpoints(t, records, []*endpoint.Endpoint{})
}
@ -314,14 +299,10 @@ func TestAWSApplyChanges(t *testing.T) {
Delete: deleteRecords,
}
if err := provider.ApplyChanges(changes); err != nil {
t.Fatal(err)
}
require.NoError(t, provider.ApplyChanges(changes))
records, err := provider.Records()
if err != nil {
t.Fatal(err)
}
require.NoError(t, err)
validateEndpoints(t, records, []*endpoint.Endpoint{
endpoint.NewEndpoint("create-test.zone-1.ext-dns-test-2.teapot.zalan.do", "8.8.8.8", "A"),
@ -383,14 +364,10 @@ func TestAWSApplyChangesDryRun(t *testing.T) {
Delete: deleteRecords,
}
if err := provider.ApplyChanges(changes); err != nil {
t.Fatal(err)
}
require.NoError(t, provider.ApplyChanges(changes))
records, err := provider.Records()
if err != nil {
t.Fatal(err)
}
require.NoError(t, err)
validateEndpoints(t, records, originalEndpoints)
}
@ -439,10 +416,7 @@ func TestAWSChangesByZones(t *testing.T) {
}
changesByZone := changesByZone(zones, changes)
if len(changesByZone) != 2 {
t.Fatalf("expected %d change(s), got %d", 2, len(changesByZone))
}
require.Len(t, changesByZone, 2)
validateAWSChangeRecords(t, changesByZone["foo-example-org"], []*route53.Change{
{
@ -476,15 +450,11 @@ func TestAWSChangesByZones(t *testing.T) {
}
func validateEndpoints(t *testing.T, endpoints []*endpoint.Endpoint, expected []*endpoint.Endpoint) {
if !testutils.SameEndpoints(endpoints, expected) {
t.Errorf("expected and actual endpoints don't match")
}
assert.True(t, testutils.SameEndpoints(endpoints, expected), "expected and actual endpoints don't match")
}
func validateAWSZones(t *testing.T, zones map[string]*route53.HostedZone, expected map[string]*route53.HostedZone) {
if len(zones) != len(expected) {
t.Fatalf("expected %d zone(s), got %d", len(expected), len(zones))
}
require.Len(t, zones, len(expected))
for i, zone := range zones {
validateAWSZone(t, zone, expected[i])
@ -492,19 +462,12 @@ func validateAWSZones(t *testing.T, zones map[string]*route53.HostedZone, expect
}
func validateAWSZone(t *testing.T, zone *route53.HostedZone, expected *route53.HostedZone) {
if aws.StringValue(zone.Id) != aws.StringValue(expected.Id) {
t.Errorf("expected %s, got %s", aws.StringValue(expected.Id), aws.StringValue(zone.Id))
}
if aws.StringValue(zone.Name) != aws.StringValue(expected.Name) {
t.Errorf("expected %s, got %s", aws.StringValue(expected.Name), aws.StringValue(zone.Name))
}
assert.Equal(t, aws.StringValue(expected.Id), aws.StringValue(zone.Id))
assert.Equal(t, aws.StringValue(expected.Name), aws.StringValue(zone.Name))
}
func validateAWSChangeRecords(t *testing.T, records []*route53.Change, expected []*route53.Change) {
if len(records) != len(expected) {
t.Fatalf("expected %d change(s), got %d", len(expected), len(records))
}
require.Len(t, records, len(expected))
for i := range records {
validateAWSChangeRecord(t, records[i], expected[i])
@ -512,13 +475,8 @@ func validateAWSChangeRecords(t *testing.T, records []*route53.Change, expected
}
func validateAWSChangeRecord(t *testing.T, record *route53.Change, expected *route53.Change) {
if aws.StringValue(record.Action) != aws.StringValue(expected.Action) {
t.Errorf("expected %s, got %s", aws.StringValue(expected.Action), aws.StringValue(record.Action))
}
if aws.StringValue(record.ResourceRecordSet.Name) != aws.StringValue(expected.ResourceRecordSet.Name) {
t.Errorf("expected %s, got %s", aws.StringValue(expected.ResourceRecordSet.Name), aws.StringValue(record.ResourceRecordSet.Name))
}
assert.Equal(t, aws.StringValue(expected.Action), aws.StringValue(record.Action))
assert.Equal(t, aws.StringValue(expected.ResourceRecordSet.Name), aws.StringValue(record.ResourceRecordSet.Name))
}
func TestAWSCreateRecordsWithCNAME(t *testing.T) {
@ -528,9 +486,7 @@ func TestAWSCreateRecordsWithCNAME(t *testing.T) {
{DNSName: "create-test.zone-1.ext-dns-test-2.teapot.zalan.do", Target: "foo.example.org"},
}
if err := provider.CreateRecords(records); err != nil {
t.Fatal(err)
}
require.NoError(t, provider.CreateRecords(records))
recordSets := listAWSRecords(t, provider.client, "/hostedzone/zone-1.ext-dns-test-2.teapot.zalan.do.")
@ -555,9 +511,7 @@ func TestAWSCreateRecordsWithALIAS(t *testing.T) {
{DNSName: "create-test.zone-1.ext-dns-test-2.teapot.zalan.do", Target: "foo.eu-central-1.elb.amazonaws.com"},
}
if err := provider.CreateRecords(records); err != nil {
t.Fatal(err)
}
require.NoError(t, provider.CreateRecords(records))
recordSets := listAWSRecords(t, provider.client, "/hostedzone/zone-1.ext-dns-test-2.teapot.zalan.do.")
@ -591,12 +545,7 @@ func TestAWSisLoadBalancer(t *testing.T) {
Target: tc.target,
RecordType: tc.recordType,
}
isLB := isAWSLoadBalancer(ep)
if isLB != tc.expected {
t.Errorf("expected %t, got %t", tc.expected, isLB)
}
assert.Equal(t, tc.expected, isAWSLoadBalancer(ep))
}
}
@ -622,10 +571,7 @@ func TestAWSCanonicalHostedZone(t *testing.T) {
{"foo.example.org", ""},
} {
zone := canonicalHostedZone(tc.hostname)
if zone != tc.expected {
t.Errorf("expected %v, got %v", tc.expected, zone)
}
assert.Equal(t, tc.expected, zone)
}
}
@ -644,10 +590,7 @@ func TestAWSSuitableZone(t *testing.T) {
{"foo.kubernetes.io.", nil},
} {
suitableZone := suitableZone(tc.hostname, zones)
if suitableZone != tc.expected {
t.Errorf("expected %s, got %s", tc.expected, suitableZone)
}
assert.Equal(t, tc.expected, suitableZone)
}
}
@ -658,9 +601,7 @@ func createAWSZone(t *testing.T, provider *AWSProvider, zone *route53.HostedZone
}
if _, err := provider.client.CreateHostedZone(params); err != nil {
if err, ok := err.(awserr.Error); !ok || err.Code() != route53.ErrCodeHostedZoneAlreadyExists {
t.Fatal(err)
}
require.EqualError(t, err, route53.ErrCodeHostedZoneAlreadyExists)
}
}
@ -670,27 +611,21 @@ func setupAWSRecords(t *testing.T, provider *AWSProvider, endpoints []*endpoint.
clearAWSRecords(t, provider, "/hostedzone/zone-3.ext-dns-test-2.teapot.zalan.do.")
records, err := provider.Records()
if err != nil {
t.Fatal(err)
}
require.NoError(t, err)
validateEndpoints(t, records, []*endpoint.Endpoint{})
if err = provider.CreateRecords(endpoints); err != nil {
t.Fatal(err)
}
require.NoError(t, provider.CreateRecords(endpoints))
records, err = provider.Records()
if err != nil {
t.Fatal(err)
}
require.NoError(t, err)
validateEndpoints(t, records, endpoints)
}
func listAWSRecords(t *testing.T, client Route53API, zone string) []*route53.ResourceRecordSet {
recordSets := []*route53.ResourceRecordSet{}
if err := client.ListResourceRecordSetsPages(&route53.ListResourceRecordSetsInput{
require.NoError(t, client.ListResourceRecordSetsPages(&route53.ListResourceRecordSetsInput{
HostedZoneId: aws.String(zone),
}, func(resp *route53.ListResourceRecordSetsOutput, _ bool) bool {
for _, recordSet := range resp.ResourceRecordSets {
@ -700,9 +635,8 @@ func listAWSRecords(t *testing.T, client Route53API, zone string) []*route53.Res
}
}
return true
}); err != nil {
t.Fatal(err)
}
}))
return recordSets
}
@ -718,14 +652,13 @@ func clearAWSRecords(t *testing.T, provider *AWSProvider, zone string) {
}
if len(changes) != 0 {
if _, err := provider.client.ChangeResourceRecordSets(&route53.ChangeResourceRecordSetsInput{
_, err := provider.client.ChangeResourceRecordSets(&route53.ChangeResourceRecordSetsInput{
HostedZoneId: aws.String(zone),
ChangeBatch: &route53.ChangeBatch{
Changes: changes,
},
}); err != nil {
t.Fatal(err)
}
})
require.NoError(t, err)
}
}
@ -761,13 +694,5 @@ func newAWSProvider(t *testing.T, domainFilter string, dryRun bool, records []*e
}
func validateRecords(t *testing.T, records []*route53.ResourceRecordSet, expected []*route53.ResourceRecordSet) {
if len(records) != len(expected) {
t.Errorf("expected %d records, got %d", len(expected), len(records))
}
for i := range records {
if !reflect.DeepEqual(records[i], expected[i]) {
t.Errorf("record is wrong")
}
}
assert.Equal(t, expected, records)
}

119
provider/google_test.go
View File

@ -29,6 +29,9 @@ import (
"google.golang.org/api/dns/v1"
"google.golang.org/api/googleapi"
"github.com/stretchr/testify/assert"
"github.com/stretchr/testify/require"
)
var (
@ -192,9 +195,7 @@ func TestGoogleZones(t *testing.T) {
provider := newGoogleProvider(t, "ext-dns-test-2.gcp.zalan.do.", false, []*endpoint.Endpoint{})
zones, err := provider.Zones()
if err != nil {
t.Fatal(err)
}
require.NoError(t, err)
validateZones(t, zones, map[string]*dns.ManagedZone{
"zone-1-ext-dns-test-2-gcp-zalan-do": {Name: "zone-1-ext-dns-test-2-gcp-zalan-do", DnsName: "zone-1.ext-dns-test-2.gcp.zalan.do."},
@ -213,9 +214,7 @@ func TestGoogleRecords(t *testing.T) {
provider := newGoogleProvider(t, "ext-dns-test-2.gcp.zalan.do.", false, originalEndpoints)
records, err := provider.Records()
if err != nil {
t.Fatal(err)
}
require.NoError(t, err)
validateEndpoints(t, records, originalEndpoints)
}
@ -229,14 +228,10 @@ func TestGoogleCreateRecords(t *testing.T) {
endpoint.NewEndpoint("create-test-cname.zone-1.ext-dns-test-2.gcp.zalan.do", "foo.elb.amazonaws.com", ""),
}
if err := provider.CreateRecords(records); err != nil {
t.Fatal(err)
}
require.NoError(t, provider.CreateRecords(records))
records, err := provider.Records()
if err != nil {
t.Fatal(err)
}
require.NoError(t, err)
validateEndpoints(t, records, []*endpoint.Endpoint{
endpoint.NewEndpoint("create-test.zone-1.ext-dns-test-2.gcp.zalan.do", "1.2.3.4", "A"),
@ -263,14 +258,10 @@ func TestGoogleUpdateRecords(t *testing.T) {
endpoint.NewEndpoint("update-test-cname.zone-1.ext-dns-test-2.gcp.zalan.do", "bar.elb.amazonaws.com", "CNAME"),
}
if err := provider.UpdateRecords(updatedRecords, currentRecords); err != nil {
t.Fatal(err)
}
require.NoError(t, provider.UpdateRecords(updatedRecords, currentRecords))
records, err := provider.Records()
if err != nil {
t.Fatal(err)
}
require.NoError(t, err)
validateEndpoints(t, records, []*endpoint.Endpoint{
endpoint.NewEndpoint("update-test.zone-1.ext-dns-test-2.gcp.zalan.do", "1.2.3.4", "A"),
@ -288,14 +279,10 @@ func TestGoogleDeleteRecords(t *testing.T) {
provider := newGoogleProvider(t, "ext-dns-test-2.gcp.zalan.do.", false, originalEndpoints)
if err := provider.DeleteRecords(originalEndpoints); err != nil {
t.Fatal(err)
}
require.NoError(t, provider.DeleteRecords(originalEndpoints))
records, err := provider.Records()
if err != nil {
t.Fatal(err)
}
require.NoError(t, err)
validateEndpoints(t, records, []*endpoint.Endpoint{})
}
@ -340,14 +327,10 @@ func TestGoogleApplyChanges(t *testing.T) {
Delete: deleteRecords,
}
if err := provider.ApplyChanges(changes); err != nil {
t.Fatal(err)
}
require.NoError(t, provider.ApplyChanges(changes))
records, err := provider.Records()
if err != nil {
t.Fatal(err)
}
require.NoError(t, err)
validateEndpoints(t, records, []*endpoint.Endpoint{
endpoint.NewEndpoint("create-test.zone-1.ext-dns-test-2.gcp.zalan.do", "8.8.8.8", "A"),
@ -401,24 +384,17 @@ func TestGoogleApplyChangesDryRun(t *testing.T) {
Delete: deleteRecords,
}
if err := provider.ApplyChanges(changes); err != nil {
t.Fatal(err)
}
require.NoError(t, provider.ApplyChanges(changes))
records, err := provider.Records()
if err != nil {
t.Fatal(err)
}
require.NoError(t, err)
validateEndpoints(t, records, originalEndpoints)
}
func TestGoogleApplyChangesEmpty(t *testing.T) {
provider := newGoogleProvider(t, "ext-dns-test-2.gcp.zalan.do.", false, []*endpoint.Endpoint{})
if err := provider.ApplyChanges(&plan.Changes{}); err != nil {
t.Error(err)
}
assert.NoError(t, provider.ApplyChanges(&plan.Changes{}))
}
func TestSeparateChanges(t *testing.T) {
@ -449,10 +425,7 @@ func TestSeparateChanges(t *testing.T) {
}
changes := separateChange(zones, change)
if len(changes) != 2 {
t.Fatalf("expected %d change(s), got %d", 2, len(changes))
}
require.Len(t, changes, 2)
validateChange(t, changes["foo-example-org"], &dns.Change{
Additions: []*dns.ResourceRecordSet{
@ -488,17 +461,12 @@ func TestGoogleSuitableZone(t *testing.T) {
{"foo.kubernetes.io.", nil},
} {
suitableZone := suitableManagedZone(tc.hostname, zones)
if suitableZone != tc.expected {
t.Errorf("expected %v, got %v", tc.expected, suitableZone)
}
assert.Equal(t, suitableZone, tc.expected)
}
}
func validateZones(t *testing.T, zones map[string]*dns.ManagedZone, expected map[string]*dns.ManagedZone) {
if len(zones) != len(expected) {
t.Fatalf("expected %d zone(s), got %d", len(expected), len(zones))
}
require.Len(t, zones, len(expected))
for i, zone := range zones {
validateZone(t, zone, expected[i])
@ -506,13 +474,8 @@ func validateZones(t *testing.T, zones map[string]*dns.ManagedZone, expected map
}
func validateZone(t *testing.T, zone *dns.ManagedZone, expected *dns.ManagedZone) {
if zone.Name != expected.Name {
t.Errorf("expected %s, got %s", expected.Name, zone.Name)
}
if zone.DnsName != expected.DnsName {
t.Errorf("expected %s, got %s", expected.DnsName, zone.DnsName)
}
assert.Equal(t, expected.Name, zone.Name)
assert.Equal(t, expected.DnsName, zone.DnsName)
}
func validateChange(t *testing.T, change *dns.Change, expected *dns.Change) {
@ -521,9 +484,7 @@ func validateChange(t *testing.T, change *dns.Change, expected *dns.Change) {
}
func validateChangeRecords(t *testing.T, records []*dns.ResourceRecordSet, expected []*dns.ResourceRecordSet) {
if len(records) != len(expected) {
t.Fatalf("expected %d change(s), got %d", len(expected), len(records))
}
require.Len(t, records, len(expected))
for i := range records {
validateChangeRecord(t, records[i], expected[i])
@ -531,13 +492,8 @@ func validateChangeRecords(t *testing.T, records []*dns.ResourceRecordSet, expec
}
func validateChangeRecord(t *testing.T, record *dns.ResourceRecordSet, expected *dns.ResourceRecordSet) {
if record.Name != expected.Name {
t.Errorf("expected %s, got %s", expected.Name, record.Name)
}
if record.Ttl != expected.Ttl {
t.Errorf("expected %d, got %d", expected.Ttl, record.Ttl)
}
assert.Equal(t, expected.Name, record.Name)
assert.Equal(t, expected.Ttl, record.Ttl)
}
func newGoogleProvider(t *testing.T, domainFilter string, dryRun bool, records []*endpoint.Endpoint) *googleProvider {
@ -577,7 +533,7 @@ func createZone(t *testing.T, provider *googleProvider, zone *dns.ManagedZone) {
if _, err := provider.managedZonesClient.Create("zalando-external-dns-test", zone).Do(); err != nil {
if err, ok := err.(*googleapi.Error); !ok || err.Code != http.StatusConflict {
t.Fatal(err)
require.NoError(t, err)
}
}
}
@ -587,27 +543,21 @@ func setupGoogleRecords(t *testing.T, provider *googleProvider, endpoints []*end
clearGoogleRecords(t, provider, "zone-2-ext-dns-test-2-gcp-zalan-do")
records, err := provider.Records()
if err != nil {
t.Fatal(err)
}
require.NoError(t, err)
validateEndpoints(t, records, []*endpoint.Endpoint{})
if err = provider.CreateRecords(endpoints); err != nil {
t.Fatal(err)
}
require.NoError(t, provider.CreateRecords(endpoints))
records, err = provider.Records()
if err != nil {
t.Fatal(err)
}
require.NoError(t, err)
validateEndpoints(t, records, endpoints)
}
func clearGoogleRecords(t *testing.T, provider *googleProvider, zone string) {
recordSets := []*dns.ResourceRecordSet{}
if err := provider.resourceRecordSetsClient.List(provider.project, zone).Pages(context.TODO(), func(resp *dns.ResourceRecordSetsListResponse) error {
require.NoError(t, provider.resourceRecordSetsClient.List(provider.project, zone).Pages(context.TODO(), func(resp *dns.ResourceRecordSetsListResponse) error {
for _, r := range resp.Rrsets {
switch r.Type {
case "A", "CNAME":
@ -615,15 +565,12 @@ func clearGoogleRecords(t *testing.T, provider *googleProvider, zone string) {
}
}
return nil
}); err != nil {
t.Fatal(err)
}
}))
if len(recordSets) != 0 {
if _, err := provider.changesClient.Create(provider.project, zone, &dns.Change{
_, err := provider.changesClient.Create(provider.project, zone, &dns.Change{
Deletions: recordSets,
}).Do(); err != nil {
t.Fatal(err)
}
}).Do()
require.NoError(t, err)
}
}

72
provider/inmemory_test.go
View File

@ -17,12 +17,14 @@ limitations under the License.
package provider
import (
"reflect"
"testing"
"github.com/kubernetes-incubator/external-dns/endpoint"
"github.com/kubernetes-incubator/external-dns/internal/testutils"
"github.com/kubernetes-incubator/external-dns/plan"
"github.com/stretchr/testify/assert"
"github.com/stretchr/testify/require"
)
var (
@ -113,14 +115,11 @@ func testInMemoryFindByType(t *testing.T) {
t.Run(ti.title, func(t *testing.T) {
c := newInMemoryClient()
record := c.findByType(ti.findType, ti.records)
if ti.expectedEmpty && record != nil {
t.Errorf("should return nil")
}
if !ti.expectedEmpty && record == nil {
t.Errorf("should not return nil")
}
if !ti.expectedEmpty && record != nil && !reflect.DeepEqual(*record, *ti.expected) {
t.Errorf("wrong record found")
if ti.expectedEmpty {
assert.Nil(t, record)
} else {
require.NotNil(t, record)
assert.Equal(t, *ti.expected, *record)
}
})
}
@ -210,17 +209,12 @@ func testInMemoryRecords(t *testing.T) {
f := filter{domain: ti.zone}
im.filter = &f
records, err := im.Records()
if ti.expectError && records != nil {
t.Errorf("wrong zone should not return records")
}
if ti.expectError && err != ErrZoneNotFound {
t.Errorf("expected error")
}
if !ti.expectError && err != nil {
t.Errorf("unexpected error")
}
if !ti.expectError && !testutils.SameEndpoints(ti.expected, records) {
t.Errorf("endpoints returned wrong set")
if ti.expectError {
assert.Nil(t, records)
assert.EqualError(t, err, ErrZoneNotFound.Error())
} else {
require.NoError(t, err)
assert.True(t, testutils.SameEndpoints(ti.expected, records))
}
})
}
@ -533,11 +527,10 @@ func testInMemoryValidateChangeBatch(t *testing.T) {
Delete: convertToInMemoryRecord(ti.changes.Delete),
}
err := c.validateChangeBatch(ti.zone, ichanges)
if ti.expectError && err != ti.errorType {
t.Errorf("returns wrong type of error: %v, expected: %v", err, ti.errorType)
}
if !ti.expectError && err != nil {
t.Error(err)
if ti.expectError {
assert.EqualError(t, err, ti.errorType.Error())
} else {
assert.NoError(t, err)
}
})
}
@ -741,16 +734,11 @@ func testInMemoryApplyChanges(t *testing.T) {
im.client = c
err := im.ApplyChanges(ti.changes)
if ti.expectError && err == nil {
t.Errorf("should return an error")
}
if !ti.expectError && err != nil {
t.Error(err)
}
if !ti.expectError {
if !reflect.DeepEqual(c.zones, ti.expectedZonesState) {
t.Errorf("invalid update")
}
if ti.expectError {
assert.Error(t, err)
} else {
require.NoError(t, err)
assert.Equal(t, ti.expectedZonesState, c.zones)
}
})
}
@ -758,17 +746,13 @@ func testInMemoryApplyChanges(t *testing.T) {
func testNewInMemoryProvider(t *testing.T) {
cfg := NewInMemoryProvider()
if cfg.client == nil {
t.Error("nil map")
}
assert.NotNil(t, cfg.client)
}
func testInMemoryCreateZone(t *testing.T) {
im := NewInMemoryProvider()
if err := im.CreateZone("zone"); err != nil {
t.Error(err)
}
if err := im.CreateZone("zone"); err != ErrZoneAlreadyExists {
t.Errorf("should fail with zone already exists")
}
err := im.CreateZone("zone")
assert.NoError(t, err)
err = im.CreateZone("zone")
assert.EqualError(t, err, ErrZoneAlreadyExists.Error())
}

34
registry/noop_test.go
View File

@ -23,6 +23,9 @@ import (
"github.com/kubernetes-incubator/external-dns/internal/testutils"
"github.com/kubernetes-incubator/external-dns/plan"
"github.com/kubernetes-incubator/external-dns/provider"
"github.com/stretchr/testify/assert"
"github.com/stretchr/testify/require"
)
var _ Registry = &NoopRegistry{}
@ -36,12 +39,8 @@ func TestNoopRegistry(t *testing.T) {
func testNoopInit(t *testing.T) {
p := provider.NewInMemoryProvider()
r, err := NewNoopRegistry(p)
if err != nil {
t.Fatal(err)
}
if r.provider != p {
t.Error("noop registry incorrectly initialized")
}
require.NoError(t, err)
assert.Equal(t, p, r.provider)
}
func testNoopRecords(t *testing.T) {
@ -61,12 +60,8 @@ func testNoopRecords(t *testing.T) {
r, _ := NewNoopRegistry(p)
eps, err := r.Records()
if err != nil {
t.Error(err)
}
if !testutils.SameEndpoints(eps, providerRecords) {
t.Error("incorrect result is returned")
}
require.NoError(t, err)
assert.True(t, testutils.SameEndpoints(eps, providerRecords))
}
func testNoopApplyChanges(t *testing.T) {
@ -106,12 +101,10 @@ func testNoopApplyChanges(t *testing.T) {
},
},
})
if err != provider.ErrRecordAlreadyExists {
t.Error("should return record already exists")
}
assert.EqualError(t, err, provider.ErrRecordAlreadyExists.Error())
//correct changes
err = r.ApplyChanges(&plan.Changes{
require.NoError(t, r.ApplyChanges(&plan.Changes{
Create: []*endpoint.Endpoint{
{
DNSName: "new-record.org",
@ -130,12 +123,7 @@ func testNoopApplyChanges(t *testing.T) {
Target: "old-lb.com",
},
},
})
if err != nil {
t.Fatal(err)
}
}))
res, _ := p.Records()
if !testutils.SameEndpoints(res, expectedUpdate) {
t.Error("incorrectly updated dns provider")
}
assert.True(t, testutils.SameEndpoints(res, expectedUpdate))
}

56
registry/txt_test.go
View File

@ -23,6 +23,9 @@ import (
"github.com/kubernetes-incubator/external-dns/internal/testutils"
"github.com/kubernetes-incubator/external-dns/plan"
"github.com/kubernetes-incubator/external-dns/provider"
"github.com/stretchr/testify/assert"
"github.com/stretchr/testify/require"
)
const (
@ -38,28 +41,21 @@ func TestTXTRegistry(t *testing.T) {
func testTXTRegistryNew(t *testing.T) {
p := provider.NewInMemoryProvider()
_, err := NewTXTRegistry(p, "txt", "")
if err == nil {
t.Fatal("owner should be specified")
}
require.Error(t, err)
r, err := NewTXTRegistry(p, "txt", "owner")
if err != nil {
t.Fatal(err)
}
if _, ok := r.mapper.(prefixNameMapper); !ok {
t.Error("incorrectly initialized txt registry instance")
}
if r.ownerID != "owner" || r.provider != p {
t.Error("incorrectly initialized txt registry instance")
}
require.NoError(t, err)
_, ok := r.mapper.(prefixNameMapper)
require.True(t, ok)
assert.Equal(t, "owner", r.ownerID)
assert.Equal(t, p, r.provider)
r, err = NewTXTRegistry(p, "", "owner")
if err != nil {
t.Fatal(err)
}
if _, ok := r.mapper.(prefixNameMapper); !ok {
t.Error("Incorrect type of prefix name mapper")
}
require.NoError(t, err)
_, ok = r.mapper.(prefixNameMapper)
assert.True(t, ok)
}
func testTXTRegistryRecords(t *testing.T) {
@ -136,9 +132,7 @@ func testTXTRegistryRecordsPrefixed(t *testing.T) {
r, _ := NewTXTRegistry(p, "txt.", "owner")
records, _ := r.Records()
if !testutils.SameEndpoints(records, expectedRecords) {
t.Error("incorrect result returned from txt registry")
}
assert.True(t, testutils.SameEndpoints(records, expectedRecords))
}
func testTXTRegistryRecordsNoPrefix(t *testing.T) {
@ -211,9 +205,7 @@ func testTXTRegistryRecordsNoPrefix(t *testing.T) {
r, _ := NewTXTRegistry(p, "", "owner")
records, _ := r.Records()
if !testutils.SameEndpoints(records, expectedRecords) {
t.Error("incorrect result returned from txt registry")
}
assert.True(t, testutils.SameEndpoints(records, expectedRecords))
}
func testTXTRegistryApplyChanges(t *testing.T) {
@ -282,14 +274,10 @@ func testTXTRegistryApplyChangesWithPrefix(t *testing.T) {
"UpdateOld": got.UpdateOld,
"Delete": got.Delete,
}
if !testutils.SamePlanChanges(mGot, mExpected) {
t.Error("incorrect plan changes are passed to provider")
}
assert.True(t, testutils.SamePlanChanges(mGot, mExpected))
}
err := r.ApplyChanges(changes)
if err != nil {
t.Fatal(err)
}
require.NoError(t, err)
}
func testTXTRegistryApplyChangesNoPrefix(t *testing.T) {
@ -349,14 +337,10 @@ func testTXTRegistryApplyChangesNoPrefix(t *testing.T) {
"UpdateOld": got.UpdateOld,
"Delete": got.Delete,
}
if !testutils.SamePlanChanges(mGot, mExpected) {
t.Error("incorrect plan changes are passed to provider")
}
assert.True(t, testutils.SamePlanChanges(mGot, mExpected))
}
err := r.ApplyChanges(changes)
if err != nil {
t.Fatal(err)
}
require.NoError(t, err)
}
/**

9
source/dedup_source_test.go
View File

@ -20,6 +20,7 @@ import (
"testing"
"github.com/kubernetes-incubator/external-dns/endpoint"
"github.com/kubernetes-incubator/external-dns/internal/testutils"
)
// Validates that dedupSource is a Source
@ -90,8 +91,11 @@ func testDedupEndpoints(t *testing.T) {
},
} {
t.Run(tc.title, func(t *testing.T) {
mockSource := new(testutils.MockSource)
mockSource.On("Endpoints").Return(tc.endpoints, nil)
// Create our object under test and get the endpoints.
source := NewDedupSource(NewMockSource(tc.endpoints))
source := NewDedupSource(mockSource)
endpoints, err := source.Endpoints()
if err != nil {
@ -100,6 +104,9 @@ func testDedupEndpoints(t *testing.T) {
// Validate returned endpoints against desired endpoints.
validateEndpoints(t, endpoints, tc.expected)
// Validate that the mock source was called.
mockSource.AssertExpectations(t)
})
}
}

22
source/ingress_test.go
View File

@ -25,6 +25,9 @@ import (
"k8s.io/client-go/pkg/apis/extensions/v1beta1"
"github.com/kubernetes-incubator/external-dns/endpoint"
"github.com/stretchr/testify/assert"
"github.com/stretchr/testify/require"
)
// Validates that ingressSource is a Source
@ -58,11 +61,10 @@ func TestNewIngressSource(t *testing.T) {
} {
t.Run(ti.title, func(t *testing.T) {
_, err := NewIngressSource(fake.NewSimpleClientset(), "", ti.fqdntemplate)
if ti.expectError && err == nil {
t.Error("invalid template should return err")
}
if !ti.expectError && err != nil {
t.Error(err)
if ti.expectError {
assert.Error(t, err)
} else {
assert.NoError(t, err)
}
})
}
@ -343,17 +345,13 @@ func testIngressEndpoints(t *testing.T) {
ingressSource, _ := NewIngressSource(fakeClient, ti.targetNamespace, ti.fqdntemplate)
for _, ingress := range ingresses {
_, err := fakeClient.Extensions().Ingresses(ingress.Namespace).Create(ingress)
if err != nil {
t.Errorf("fake kubernetes ingress creation should not fail. Ingress %v. Error: %v", *ingress, err)
}
require.NoError(t, err)
}
res, err := ingressSource.Endpoints()
if err != nil {
t.Errorf("ingress endpoints should not fail on valid fake client call")
}
validateEndpoints(t, res, ti.expected)
require.NoError(t, err)
validateEndpoints(t, res, ti.expected)
})
}
}

62
source/mock_source_test.go
View File

@ -1,62 +0,0 @@
/*
Copyright 2017 The Kubernetes Authors.
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
*/
package source
import (
"testing"
"github.com/kubernetes-incubator/external-dns/endpoint"
)
// Validates that mockSource is a Source
var _ Source = &mockSource{}
func TestMockSource(t *testing.T) {
t.Run("Endpoints", testMockSourceEndpoints)
}
// testMockSourceEndpoints tests that endpoints are returned as given.
func testMockSourceEndpoints(t *testing.T) {
for _, tc := range []struct {
title string
givenAndExpected []*endpoint.Endpoint
}{
{
"no endpoints given return no endpoints",
[]*endpoint.Endpoint{},
},
{
"single endpoint given returns single endpoint",
[]*endpoint.Endpoint{
{DNSName: "foo", Target: "8.8.8.8"},
},
},
} {
t.Run(tc.title, func(t *testing.T) {
// Create our object under test and get the endpoints.
source := NewMockSource(tc.givenAndExpected)
endpoints, err := source.Endpoints()
if err != nil {
t.Fatal(err)
}
// Validate returned endpoints against desired endpoints.
validateEndpoints(t, endpoints, tc.givenAndExpected)
})
}
}

53
source/multi_source_test.go
View File

@ -17,16 +17,25 @@ limitations under the License.
package source
import (
"errors"
"testing"
"github.com/kubernetes-incubator/external-dns/endpoint"
"github.com/kubernetes-incubator/external-dns/internal/testutils"
"github.com/stretchr/testify/assert"
"github.com/stretchr/testify/require"
)
// Validates that multiSource is a Source
var _ Source = &multiSource{}
func TestMultiSource(t *testing.T) {
t.Run("Interface", testMultiSourceImplementsSource)
t.Run("Endpoints", testMultiSourceEndpoints)
t.Run("EndpointsWithError", testMultiSourceEndpointsWithError)
}
// testMultiSourceImplementsSource tests that multiSource is a valid Source.
func testMultiSourceImplementsSource(t *testing.T) {
assert.Implements(t, (*Source)(nil), new(multiSource))
}
// testMultiSourceEndpoints tests merged endpoints from children are returned.
@ -61,23 +70,51 @@ func testMultiSourceEndpoints(t *testing.T) {
},
} {
t.Run(tc.title, func(t *testing.T) {
// Prepare the nested mock sources
// Prepare the nested mock sources.
sources := make([]Source, 0, len(tc.nestedEndpoints))
// Populate the nested mock sources.
for _, endpoints := range tc.nestedEndpoints {
sources = append(sources, NewMockSource(endpoints))
src := new(testutils.MockSource)
src.On("Endpoints").Return(endpoints, nil)
sources = append(sources, src)
}
// Create our object under test and get the endpoints.
source := NewMultiSource(sources)
// Get endpoints from the source.
endpoints, err := source.Endpoints()
if err != nil {
t.Fatal(err)
}
require.NoError(t, err)
// Validate returned endpoints against desired endpoints.
validateEndpoints(t, endpoints, tc.expected)
// Validate that the nested sources were called.
for _, src := range sources {
src.(*testutils.MockSource).AssertExpectations(t)
}
})
}
}
// testMultiSourceEndpointsWithError tests that an error by a nested source is bubbled up.
func testMultiSourceEndpointsWithError(t *testing.T) {
// Create the expected error.
errSomeError := errors.New("some error")
// Create a mocked source returning that error.
src := new(testutils.MockSource)
src.On("Endpoints").Return(nil, errSomeError)
// Create our object under test and get the endpoints.
source := NewMultiSource([]Source{src})
// Get endpoints from our source.
_, err := source.Endpoints()
assert.EqualError(t, err, "some error")
// Validate that the nested source was called.
src.AssertExpectations(t)
}

62
source/service_test.go
View File

@ -25,16 +25,24 @@ import (
"k8s.io/client-go/pkg/api/v1"
"github.com/kubernetes-incubator/external-dns/endpoint"
"github.com/stretchr/testify/assert"
"github.com/stretchr/testify/require"
)
// Validates that serviceSource is a Source
var _ Source = &serviceSource{}
func TestService(t *testing.T) {
t.Run("Endpoints", testServiceEndpoints)
func TestServiceSource(t *testing.T) {
t.Run("Interface", testServiceSourceImplementsSource)
t.Run("NewServiceSource", testServiceSourceNewServiceSource)
t.Run("Endpoints", testServiceSourceEndpoints)
}
func TestNewServiceSource(t *testing.T) {
// testServiceSourceImplementsSource tests that serviceSource is a valid Source.
func testServiceSourceImplementsSource(t *testing.T) {
assert.Implements(t, (*Source)(nil), new(serviceSource))
}
// testServiceSourceNewServiceSource tests that NewServiceSource doesn't return an error.
func testServiceSourceNewServiceSource(t *testing.T) {
for _, ti := range []struct {
title string
fqdntemplate string
@ -57,18 +65,18 @@ func TestNewServiceSource(t *testing.T) {
} {
t.Run(ti.title, func(t *testing.T) {
_, err := NewServiceSource(fake.NewSimpleClientset(), "", ti.fqdntemplate, "")
if ti.expectError && err == nil {
t.Error("invalid template should return err")
}
if !ti.expectError && err != nil {
t.Error(err)
if ti.expectError {
assert.Error(t, err)
} else {
assert.NoError(t, err)
}
})
}
}
// testServiceEndpoints tests that various services generate the correct endpoints.
func testServiceEndpoints(t *testing.T) {
// testServiceSourceEndpoints tests that various services generate the correct endpoints.
func testServiceSourceEndpoints(t *testing.T) {
for _, tc := range []struct {
title string
targetNamespace string
@ -390,20 +398,17 @@ func testServiceEndpoints(t *testing.T) {
}
_, err := kubernetes.CoreV1().Services(service.Namespace).Create(service)
if err != nil {
t.Fatal(err)
}
require.NoError(t, err)
// Create our object under test and get the endpoints.
client, _ := NewServiceSource(kubernetes, tc.targetNamespace, tc.fqdntemplate, tc.compatibility)
client, err := NewServiceSource(kubernetes, tc.targetNamespace, tc.fqdntemplate, tc.compatibility)
require.NoError(t, err)
endpoints, err := client.Endpoints()
if !tc.expectError && err != nil {
t.Fatal(err)
}
if tc.expectError && err == nil {
t.Fatal("expected error")
if tc.expectError {
require.Error(t, err)
} else {
require.NoError(t, err)
}
// Validate returned endpoints against desired endpoints.
@ -434,16 +439,13 @@ func BenchmarkServiceEndpoints(b *testing.B) {
}
_, err := kubernetes.CoreV1().Services(service.Namespace).Create(service)
if err != nil {
b.Fatal(err)
}
require.NoError(b, err)
client, _ := NewServiceSource(kubernetes, v1.NamespaceAll, "", "")
client, err := NewServiceSource(kubernetes, v1.NamespaceAll, "", "")
require.NoError(b, err)
for i := 0; i < b.N; i++ {
_, err := client.Endpoints()
if err != nil {
b.Fatal(err)
}
require.NoError(b, err)
}
}

44
source/store_test.go
View File

@ -16,7 +16,14 @@ limitations under the License.
package source
import "testing"
import (
"testing"
"github.com/kubernetes-incubator/external-dns/internal/testutils"
"github.com/stretchr/testify/assert"
"github.com/stretchr/testify/require"
)
func TestStore(t *testing.T) {
t.Run("RegisterAndLookup", testRegisterAndLookup)
@ -32,7 +39,7 @@ func testRegisterAndLookup(t *testing.T) {
{
"registered source is found by name",
map[string]Source{
"foo": NewMockSource(nil),
"foo": &testutils.MockSource{},
},
},
} {
@ -42,9 +49,7 @@ func testRegisterAndLookup(t *testing.T) {
}
for k, v := range tc.givenAndExpected {
if Lookup(k) != v {
t.Errorf("expected %#v, got %#v", v, Lookup(k))
}
assert.Equal(t, v, Lookup(k))
}
})
}
@ -61,8 +66,8 @@ func testLookupMultiple(t *testing.T) {
{
"multiple registered sources are found by names",
map[string]Source{
"foo": NewMockSource(nil),
"bar": NewMockSource(nil),
"foo": &testutils.MockSource{},
"bar": &testutils.MockSource{},
},
[]string{"foo", "bar"},
false,
@ -70,10 +75,10 @@ func testLookupMultiple(t *testing.T) {
{
"multiple registered sources, one source not registered",
map[string]Source{
"foo": NewMockSource(nil),
"bar": NewMockSource(nil),
"foo": &testutils.MockSource{},
"bar": &testutils.MockSource{},
},
[]string{"foo", "baz"},
[]string{"foo", "bar", "baz"},
true,
},
} {
@ -83,20 +88,13 @@ func testLookupMultiple(t *testing.T) {
}
lookup, err := LookupMultiple(tc.names)
if !tc.expectError && err != nil {
t.Fatal(err)
}
if tc.expectError {
if err == nil {
t.Fatal("look up should fail if source not registered")
}
t.Skip()
}
for i, name := range tc.names {
if lookup[i] != tc.registered[name] {
t.Errorf("expected %#v, got %#v", tc.registered[name], lookup[i])
require.Error(t, err)
} else {
require.NoError(t, err)
require.Len(t, lookup, len(tc.registered))
for _, source := range tc.registered {
assert.Contains(t, lookup, source)
}
}
})

65
vendor/github.com/aws/aws-sdk-go/CHANGELOG.md generated vendored
View File

@ -1,3 +1,68 @@
Release v1.8.27 (2017-05-22)
===
### Service Client Updates
* `aws/endpoints`: Updated Regions and Endpoints metadata.
* `service/resourcegroupstaggingapi`: Updates service API, documentation, and paginators
* You can now specify the number of resources returned per page in GetResources operation, as an optional parameter, to easily manage the list of resources returned by your queries.
### SDK Bugs
* `aws/request`: Add support for PUT temporary redirects (307) [#1283](https://github.com/aws/aws-sdk-go/issues/1283)
* Adds support for Go 1.8's GetBody function allowing the SDK's http request using PUT and POST methods to be redirected with temporary redirects with 307 status code.
* Fixes: [#1267](https://github.com/aws/aws-sdk-go/issues/1267)
* `aws/request`: Add handling for retrying temporary errors during unmarshal [#1289](https://github.com/aws/aws-sdk-go/issues/1289)
* Adds support for retrying temporary errors that occur during unmarshaling of a request's response body.
* Fixes: [#1275](https://github.com/aws/aws-sdk-go/issues/1275)
Release v1.8.26 (2017-05-18)
===
### Service Client Updates
* `service/athena`: Adds new service
* This release adds support for Amazon Athena. Amazon Athena is an interactive query service that makes it easy to analyze data in Amazon S3 using standard SQL. Athena is serverless, so there is no infrastructure to manage, and you pay only for the queries that you run.
* `service/lightsail`: Updates service API, documentation, and paginators
* This release adds new APIs that make it easier to set network port configurations on Lightsail instances. Developers can now make a single request to both open and close public ports on an instance using the PutInstancePublicPorts operation.
### SDK Bugs
* `aws/request`: Fix logging from reporting wrong retry request errors #1281
* Fixes the SDK's retry request logging to report the the actual error that occurred, not a stubbed Unknown error message.
* Fixes the SDK's response logger to not output the response log multiple times per retry.
Release v1.8.25 (2017-05-17)
===
### Service Client Updates
* `service/autoscaling`: Updates service documentation, paginators, and examples
* Various Auto Scaling documentation updates
* `service/cloudwatchevents`: Updates service documentation
* Various CloudWatch Events documentation updates.
* `service/cloudwatchlogs`: Updates service documentation and paginators
* Various CloudWatch Logs documentation updates.
* `service/polly`: Updates service API
* Amazon Polly adds new German voice "Vicki"
Release v1.8.24 (2017-05-16)
===
### Service Client Updates
* `service/codedeploy`: Updates service API and documentation
* This release introduces the previousRevision field in the responses to the GetDeployment and BatchGetDeployments actions. previousRevision provides information about the application revision that was deployed to the deployment group before the most recent successful deployment. Also, the fileExistsBehavior parameter has been added for CreateDeployment action requests. In the past, if the AWS CodeDeploy agent detected files in a target location that weren't part of the application revision from the most recent successful deployment, it would fail the current deployment by default. This new parameter provides options for how the agent handles these files: fail the deployment, retain the content, or overwrite the content.
* `service/gamelift`: Updates service API and documentation
* Allow developers to specify how metrics are grouped in CloudWatch for their GameLift fleets. Developers can also specify how many concurrent game sessions activate on a per-instance basis.
* `service/inspector`: Updates service API, documentation, paginators, and examples
* Adds ability to produce an assessment report that includes detailed and comprehensive results of a specified assessment run.
* `service/kms`: Updates service documentation
* Update documentation for KMS.
Release v1.8.23 (2017-05-15)
===
### Service Client Updates
* `service/ssm`: Updates service API and documentation
* UpdateAssociation API now supports updating document name and targets of an association. GetAutomationExecution API can return FailureDetails as an optional field to the StepExecution Object, which contains failure type, failure stage as well as other failure related information for a failed step.
### SDK Enhancements
* `aws/session`: SDK should be able to load multiple custom shared config files. [#1258](https://github.com/aws/aws-sdk-go/issues/1258)
* This change adds a `SharedConfigFiles` field to the `session.Options` type that allows you to specify the files, and their order, the SDK will use for loading shared configuration and credentials from when the `Session` is created. Use the `NewSessionWithOptions` Session constructor to specify these options. You'll also most likely want to enable support for the shared configuration file's additional attributes by setting `session.Option`'s `SharedConfigState` to `session.SharedConfigEnabled`.
Release v1.8.22 (2017-05-11)
===

1
vendor/github.com/aws/aws-sdk-go/Makefile generated vendored
View File

@ -153,6 +153,7 @@ get-deps-tests:
go get github.com/stretchr/testify
go get github.com/smartystreets/goconvey
go get golang.org/x/net/html
go get golang.org/x/net/http2
get-deps-verify:
@echo "go get SDK verification utilities"

10
vendor/github.com/aws/aws-sdk-go/aws/client/logger.go generated vendored
View File

@ -97,6 +97,12 @@ func logResponse(r *request.Request) {
}
}
r.Handlers.Unmarshal.PushBack(handlerFn)
r.Handlers.UnmarshalError.PushBack(handlerFn)
const handlerName = "awsdk.client.LogResponse.ResponseBody"
r.Handlers.Unmarshal.SetBackNamed(request.NamedHandler{
Name: handlerName, Fn: handlerFn,
})
r.Handlers.UnmarshalError.SetBackNamed(request.NamedHandler{
Name: handlerName, Fn: handlerFn,
})
}

16
vendor/github.com/aws/aws-sdk-go/aws/corehandlers/handlers.go generated vendored
View File

@ -106,6 +106,22 @@ var SendHandler = request.NamedHandler{
sender = sendWithoutFollowRedirects
}
if request.NoBody == r.HTTPRequest.Body {
// Strip off the request body if the NoBody reader was used as a
// place holder for a request body. This prevents the SDK from
// making requests with a request body when it would be invalid
// to do so.
//
// Use a shallow copy of the http.Request to ensure the race condition
// of transport on Body will not trigger
reqOrig, reqCopy := r.HTTPRequest, *r.HTTPRequest
reqCopy.Body = nil
r.HTTPRequest = &reqCopy
defer func() {
r.HTTPRequest = reqOrig
}()
}
var err error
r.HTTPResponse, err = sender(r)
if err != nil {

64
vendor/github.com/aws/aws-sdk-go/aws/corehandlers/handlers_1_8_test.go generated vendored Normal file
View File

@ -0,0 +1,64 @@
// +build go1.8
package corehandlers_test
import (
"crypto/tls"
"net/http"
"testing"
"github.com/aws/aws-sdk-go/aws"
"github.com/aws/aws-sdk-go/aws/credentials"
"github.com/aws/aws-sdk-go/aws/request"
"github.com/aws/aws-sdk-go/aws/session"
"github.com/aws/aws-sdk-go/awstesting"
"github.com/aws/aws-sdk-go/service/s3"
"golang.org/x/net/http2"
)
func TestSendHandler_HEADNoBody(t *testing.T) {
TLSBundleCertFile, TLSBundleKeyFile, TLSBundleCAFile, err := awstesting.CreateTLSBundleFiles()
if err != nil {
panic(err)
}
defer awstesting.CleanupTLSBundleFiles(TLSBundleCertFile, TLSBundleKeyFile, TLSBundleCAFile)
endpoint, err := awstesting.CreateTLSServer(TLSBundleCertFile, TLSBundleKeyFile, nil)
if err != nil {
t.Fatalf("expect no error, got %v", err)
}
transport := http.DefaultTransport.(*http.Transport)
// test server's certificate is self-signed certificate
transport.TLSClientConfig = &tls.Config{InsecureSkipVerify: true}
http2.ConfigureTransport(transport)
sess, err := session.NewSessionWithOptions(session.Options{
Config: aws.Config{
HTTPClient: &http.Client{},
Endpoint: aws.String(endpoint),
Region: aws.String("mock-region"),
Credentials: credentials.AnonymousCredentials,
S3ForcePathStyle: aws.Bool(true),
},
})
svc := s3.New(sess)
req, _ := svc.HeadObjectRequest(&s3.HeadObjectInput{
Bucket: aws.String("bucketname"),
Key: aws.String("keyname"),
})
if e, a := request.NoBody, req.HTTPRequest.Body; e != a {
t.Fatalf("expect %T request body, got %T", e, a)
}
err = req.Send()
if err != nil {
t.Fatalf("expect no error, got %v", err)
}
if e, a := http.StatusOK, req.HTTPResponse.StatusCode; e != a {
t.Errorf("expect %d status code, got %d", e, a)
}
}

51
vendor/github.com/aws/aws-sdk-go/aws/endpoints/defaults.go generated vendored
View File

@ -639,11 +639,15 @@ var awsPartition = partition{
Endpoints: endpoints{
"ap-northeast-1": endpoint{},
"ap-northeast-2": endpoint{},
"ap-southeast-1": endpoint{},
"ap-southeast-2": endpoint{},
"ca-central-1": endpoint{},
"eu-central-1": endpoint{},
"eu-west-1": endpoint{},
"eu-west-2": endpoint{},
"us-east-1": endpoint{},
"us-east-2": endpoint{},
"us-west-2": endpoint{},
},
},
@ -1075,7 +1079,12 @@ var awsPartition = partition{
"lightsail": service{
Endpoints: endpoints{
"eu-central-1": endpoint{},
"eu-west-1": endpoint{},
"eu-west-2": endpoint{},
"us-east-1": endpoint{},
"us-east-2": endpoint{},
"us-west-2": endpoint{},
},
},
"logs": service{
@ -1531,7 +1540,7 @@ var awsPartition = partition{
},
"streams.dynamodb": service{
Defaults: endpoint{
Protocols: []string{"http", "http", "https", "https"},
Protocols: []string{"http", "https"},
CredentialScope: credentialScope{
Service: "dynamodb",
},
@ -1586,9 +1595,33 @@ var awsPartition = partition{
"eu-west-2": endpoint{},
"sa-east-1": endpoint{},
"us-east-1": endpoint{},
"us-east-1-fips": endpoint{
Hostname: "sts-fips.us-east-1.amazonaws.com",
CredentialScope: credentialScope{
Region: "us-east-1",
},
},
"us-east-2": endpoint{},
"us-east-2-fips": endpoint{
Hostname: "sts-fips.us-east-2.amazonaws.com",
CredentialScope: credentialScope{
Region: "us-east-2",
},
},
"us-west-1": endpoint{},
"us-west-1-fips": endpoint{
Hostname: "sts-fips.us-west-1.amazonaws.com",
CredentialScope: credentialScope{
Region: "us-west-1",
},
},
"us-west-2": endpoint{},
"us-west-2-fips": endpoint{
Hostname: "sts-fips.us-west-2.amazonaws.com",
CredentialScope: credentialScope{
Region: "us-west-2",
},
},
},
},
"support": service{
@ -1688,8 +1721,10 @@ var awsPartition = partition{
"ap-south-1": endpoint{},
"ap-southeast-1": endpoint{},
"ap-southeast-2": endpoint{},
"ca-central-1": endpoint{},
"eu-central-1": endpoint{},
"eu-west-1": endpoint{},
"eu-west-2": endpoint{},
"sa-east-1": endpoint{},
"us-east-1": endpoint{},
"us-east-2": endpoint{},
@ -1912,7 +1947,7 @@ var awscnPartition = partition{
},
"streams.dynamodb": service{
Defaults: endpoint{
Protocols: []string{"http", "http", "https", "https"},
Protocols: []string{"http", "https"},
CredentialScope: credentialScope{
Service: "dynamodb",
},
@ -2051,6 +2086,12 @@ var awsusgovPartition = partition{
},
},
},
"events": service{
Endpoints: endpoints{
"us-gov-west-1": endpoint{},
},
},
"glacier": service{
Endpoints: endpoints{
@ -2084,6 +2125,12 @@ var awsusgovPartition = partition{
"us-gov-west-1": endpoint{},
},
},
"lambda": service{
Endpoints: endpoints{
"us-gov-west-1": endpoint{},
},
},
"logs": service{
Endpoints: endpoints{

31
vendor/github.com/aws/aws-sdk-go/aws/request/handlers.go generated vendored
View File

@ -158,6 +158,37 @@ func (l *HandlerList) RemoveByName(name string) {
}
}
// SwapNamed will swap out any existing handlers with the same name as the
// passed in NamedHandler returning true if handlers were swapped. False is
// returned otherwise.
func (l *HandlerList) SwapNamed(n NamedHandler) (swapped bool) {
for i := 0; i < len(l.list); i++ {
if l.list[i].Name == n.Name {
l.list[i].Fn = n.Fn
swapped = true
}
}
return swapped
}
// SetBackNamed will replace the named handler if it exists in the handler list.
// If the handler does not exist the handler will be added to the end of the list.
func (l *HandlerList) SetBackNamed(n NamedHandler) {
if !l.SwapNamed(n) {
l.PushBackNamed(n)
}
}
// SetFrontNamed will replace the named handler if it exists in the handler list.
// If the handler does not exist the handler will be added to the beginning of
// the list.
func (l *HandlerList) SetFrontNamed(n NamedHandler) {
if !l.SwapNamed(n) {
l.PushFrontNamed(n)
}
}
// Run executes all handlers in the list with a given request object.
func (l *HandlerList) Run(r *Request) {
for i, h := range l.list {

127
vendor/github.com/aws/aws-sdk-go/aws/request/handlers_test.go generated vendored
View File

@ -1,10 +1,9 @@
package request_test
import (
"reflect"
"testing"
"github.com/stretchr/testify/assert"
"github.com/aws/aws-sdk-go/aws"
"github.com/aws/aws-sdk-go/aws/request"
"github.com/aws/aws-sdk-go/awstesting/unit"
@ -20,8 +19,12 @@ func TestHandlerList(t *testing.T) {
r.Data = s
})
l.Run(r)
assert.Equal(t, "a", s)
assert.Equal(t, "a", r.Data)
if e, a := "a", s; e != a {
t.Errorf("expect %q update got %q", e, a)
}
if e, a := "a", r.Data.(string); e != a {
t.Errorf("expect %q data update got %q", e, a)
}
}
func TestMultipleHandlers(t *testing.T) {
@ -43,9 +46,110 @@ func TestNamedHandlers(t *testing.T) {
l.PushBackNamed(named)
l.PushBackNamed(named2)
l.PushBack(func(r *request.Request) {})
assert.Equal(t, 4, l.Len())
if e, a := 4, l.Len(); e != a {
t.Errorf("expect %d list length, got %d", e, a)
}
l.Remove(named)
assert.Equal(t, 2, l.Len())
if e, a := 2, l.Len(); e != a {
t.Errorf("expect %d list length, got %d", e, a)
}
}
func TestSwapHandlers(t *testing.T) {
firstHandlerCalled := 0
swappedOutHandlerCalled := 0
swappedInHandlerCalled := 0
l := request.HandlerList{}
named := request.NamedHandler{Name: "Name", Fn: func(r *request.Request) {
firstHandlerCalled++
}}
named2 := request.NamedHandler{Name: "SwapOutName", Fn: func(r *request.Request) {
swappedOutHandlerCalled++
}}
l.PushBackNamed(named)
l.PushBackNamed(named2)
l.PushBackNamed(named)
l.SwapNamed(request.NamedHandler{Name: "SwapOutName", Fn: func(r *request.Request) {
swappedInHandlerCalled++
}})
l.Run(&request.Request{})
if e, a := 2, firstHandlerCalled; e != a {
t.Errorf("expect first handler to be called %d, was called %d times", e, a)
}
if n := swappedOutHandlerCalled; n != 0 {
t.Errorf("expect swapped out handler to not be called, was called %d times", n)
}
if e, a := 1, swappedInHandlerCalled; e != a {
t.Errorf("expect swapped in handler to be called %d, was called %d times", e, a)
}
}
func TestSetBackNamed_Exists(t *testing.T) {
firstHandlerCalled := 0
swappedOutHandlerCalled := 0
swappedInHandlerCalled := 0
l := request.HandlerList{}
named := request.NamedHandler{Name: "Name", Fn: func(r *request.Request) {
firstHandlerCalled++
}}
named2 := request.NamedHandler{Name: "SwapOutName", Fn: func(r *request.Request) {
swappedOutHandlerCalled++
}}
l.PushBackNamed(named)
l.PushBackNamed(named2)
l.SetBackNamed(request.NamedHandler{Name: "SwapOutName", Fn: func(r *request.Request) {
swappedInHandlerCalled++
}})
l.Run(&request.Request{})
if e, a := 1, firstHandlerCalled; e != a {
t.Errorf("expect first handler to be called %d, was called %d times", e, a)
}
if n := swappedOutHandlerCalled; n != 0 {
t.Errorf("expect swapped out handler to not be called, was called %d times", n)
}
if e, a := 1, swappedInHandlerCalled; e != a {
t.Errorf("expect swapped in handler to be called %d, was called %d times", e, a)
}
}
func TestSetBackNamed_NotExists(t *testing.T) {
firstHandlerCalled := 0
secondHandlerCalled := 0
swappedInHandlerCalled := 0
l := request.HandlerList{}
named := request.NamedHandler{Name: "Name", Fn: func(r *request.Request) {
firstHandlerCalled++
}}
named2 := request.NamedHandler{Name: "OtherName", Fn: func(r *request.Request) {
secondHandlerCalled++
}}
l.PushBackNamed(named)
l.PushBackNamed(named2)
l.SetBackNamed(request.NamedHandler{Name: "SwapOutName", Fn: func(r *request.Request) {
swappedInHandlerCalled++
}})
l.Run(&request.Request{})
if e, a := 1, firstHandlerCalled; e != a {
t.Errorf("expect first handler to be called %d, was called %d times", e, a)
}
if e, a := 1, secondHandlerCalled; e != a {
t.Errorf("expect second handler to be called %d, was called %d times", e, a)
}
if e, a := 1, swappedInHandlerCalled; e != a {
t.Errorf("expect swapped in handler to be called %d, was called %d times", e, a)
}
}
func TestLoggedHandlers(t *testing.T) {
@ -63,7 +167,10 @@ func TestLoggedHandlers(t *testing.T) {
l.PushBackNamed(named2)
l.Run(&request.Request{Config: cfg})
assert.Equal(t, expectedHandlers, loggedHandlers)
if !reflect.DeepEqual(expectedHandlers, loggedHandlers) {
t.Errorf("expect handlers executed %v to match logged handlers, %v",
expectedHandlers, loggedHandlers)
}
}
func TestStopHandlers(t *testing.T) {
@ -81,11 +188,13 @@ func TestStopHandlers(t *testing.T) {
called++
}})
l.PushBackNamed(request.NamedHandler{Name: "name3", Fn: func(r *request.Request) {
assert.Fail(t, "third handler should not be called")
t.Fatalf("third handler should not be called")
}})
l.Run(&request.Request{})
assert.Equal(t, 2, called, "Expect only two handlers to be called")
if e, a := 2, called; e != a {
t.Errorf("expect %d handlers called, got %d", e, a)
}
}
func BenchmarkNewRequest(b *testing.B) {

28
vendor/github.com/aws/aws-sdk-go/aws/request/request.go generated vendored
View File

@ -338,10 +338,7 @@ func (r *Request) Sign() error {
return r.Error
}
// ResetBody rewinds the request body backto its starting position, and
// set's the HTTP Request body reference. When the body is read prior
// to being sent in the HTTP request it will need to be rewound.
func (r *Request) ResetBody() {
func (r *Request) getNextRequestBody() (io.ReadCloser, error) {
if r.safeBody != nil {
r.safeBody.Close()
}
@ -363,14 +360,14 @@ func (r *Request) ResetBody() {
// Related golang/go#18257
l, err := computeBodyLength(r.Body)
if err != nil {
r.Error = awserr.New(ErrCodeSerialization, "failed to compute request body size", err)
return
return nil, awserr.New(ErrCodeSerialization, "failed to compute request body size", err)
}
var body io.ReadCloser
if l == 0 {
r.HTTPRequest.Body = noBodyReader
body = NoBody
} else if l > 0 {
r.HTTPRequest.Body = r.safeBody
body = r.safeBody
} else {
// Hack to prevent sending bodies for methods where the body
// should be ignored by the server. Sending bodies on these
@ -382,11 +379,13 @@ func (r *Request) ResetBody() {
// a io.Reader that was not also an io.Seeker.
switch r.Operation.HTTPMethod {
case "GET", "HEAD", "DELETE":
r.HTTPRequest.Body = noBodyReader
body = NoBody
default:
r.HTTPRequest.Body = r.safeBody
body = r.safeBody
}
}
return body, nil
}
// Attempts to compute the length of the body of the reader using the
@ -488,7 +487,7 @@ func (r *Request) Send() error {
r.Handlers.Retry.Run(r)
r.Handlers.AfterRetry.Run(r)
if r.Error != nil {
debugLogReqError(r, "Send Request", false, r.Error)
debugLogReqError(r, "Send Request", false, err)
return r.Error
}
debugLogReqError(r, "Send Request", true, err)
@ -497,12 +496,13 @@ func (r *Request) Send() error {
r.Handlers.UnmarshalMeta.Run(r)
r.Handlers.ValidateResponse.Run(r)
if r.Error != nil {
err := r.Error
r.Handlers.UnmarshalError.Run(r)
err := r.Error
r.Handlers.Retry.Run(r)
r.Handlers.AfterRetry.Run(r)
if r.Error != nil {
debugLogReqError(r, "Validate Response", false, r.Error)
debugLogReqError(r, "Validate Response", false, err)
return r.Error
}
debugLogReqError(r, "Validate Response", true, err)
@ -515,7 +515,7 @@ func (r *Request) Send() error {
r.Handlers.Retry.Run(r)
r.Handlers.AfterRetry.Run(r)
if r.Error != nil {
debugLogReqError(r, "Unmarshal Response", false, r.Error)
debugLogReqError(r, "Unmarshal Response", false, err)
return r.Error
}
debugLogReqError(r, "Unmarshal Response", true, err)

22
vendor/github.com/aws/aws-sdk-go/aws/request/request_1_7.go generated vendored
View File

@ -16,6 +16,24 @@ func (noBody) Read([]byte) (int, error) { return 0, io.EOF }
func (noBody) Close() error { return nil }
func (noBody) WriteTo(io.Writer) (int64, error) { return 0, nil }
// Is an empty reader that will trigger the Go HTTP client to not include
// NoBody is an empty reader that will trigger the Go HTTP client to not include
// and body in the HTTP request.
var noBodyReader = noBody{}
var NoBody = noBody{}
// ResetBody rewinds the request body back to its starting position, and
// set's the HTTP Request body reference. When the body is read prior
// to being sent in the HTTP request it will need to be rewound.
//
// ResetBody will automatically be called by the SDK's build handler, but if
// the request is being used directly ResetBody must be called before the request
// is Sent. SetStringBody, SetBufferBody, and SetReaderBody will automatically
// call ResetBody.
func (r *Request) ResetBody() {
body, err := r.getNextRequestBody()
if err != nil {
r.Error = err
return
}
r.HTTPRequest.Body = body
}

30
vendor/github.com/aws/aws-sdk-go/aws/request/request_1_8.go generated vendored
View File

@ -2,8 +2,32 @@
package request
import "net/http"
import (
"net/http"
)
// Is a http.NoBody reader instructing Go HTTP client to not include
// NoBody is a http.NoBody reader instructing Go HTTP client to not include
// and body in the HTTP request.
var noBodyReader = http.NoBody
var NoBody = http.NoBody
// ResetBody rewinds the request body back to its starting position, and
// set's the HTTP Request body reference. When the body is read prior
// to being sent in the HTTP request it will need to be rewound.
//
// ResetBody will automatically be called by the SDK's build handler, but if
// the request is being used directly ResetBody must be called before the request
// is Sent. SetStringBody, SetBufferBody, and SetReaderBody will automatically
// call ResetBody.
//
// Will also set the Go 1.8's http.Request.GetBody member to allow retrying
// PUT/POST redirects.
func (r *Request) ResetBody() {
body, err := r.getNextRequestBody()
if err != nil {
r.Error = err
return
}
r.HTTPRequest.Body = body
r.HTTPRequest.GetBody = r.getNextRequestBody
}

64
vendor/github.com/aws/aws-sdk-go/aws/request/request_1_8_test.go generated vendored
View File

@ -1,15 +1,23 @@
// +build go1.8
package request
package request_test
import (
"bytes"
"io"
"net/http"
"net/http/httptest"
"strings"
"testing"
"github.com/aws/aws-sdk-go/aws"
"github.com/aws/aws-sdk-go/aws/request"
"github.com/aws/aws-sdk-go/awstesting"
"github.com/aws/aws-sdk-go/awstesting/unit"
)
func TestResetBody_WithEmptyBody(t *testing.T) {
r := Request{
r := request.Request{
HTTPRequest: &http.Request{},
}
@ -23,3 +31,55 @@ func TestResetBody_WithEmptyBody(t *testing.T) {
r.HTTPRequest.Body)
}
}
func TestRequest_FollowPUTRedirects(t *testing.T) {
const bodySize = 1024
redirectHit := 0
endpointHit := 0
server := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
switch r.URL.Path {
case "/redirect-me":
u := *r.URL
u.Path = "/endpoint"
w.Header().Set("Location", u.String())
w.WriteHeader(307)
redirectHit++
case "/endpoint":
b := bytes.Buffer{}
io.Copy(&b, r.Body)
r.Body.Close()
if e, a := bodySize, b.Len(); e != a {
t.Fatalf("expect %d body size, got %d", e, a)
}
endpointHit++
default:
t.Fatalf("unexpected endpoint used, %q", r.URL.String())
}
}))
svc := awstesting.NewClient(&aws.Config{
Region: unit.Session.Config.Region,
DisableSSL: aws.Bool(true),
Endpoint: aws.String(server.URL),
})
req := svc.NewRequest(&request.Operation{
Name: "Operation",
HTTPMethod: "PUT",
HTTPPath: "/redirect-me",
}, &struct{}{}, &struct{}{})
req.SetReaderBody(bytes.NewReader(make([]byte, bodySize)))
err := req.Send()
if err != nil {
t.Errorf("expect no error, got %v", err)
}
if e, a := 1, redirectHit; e != a {
t.Errorf("expect %d redirect hits, got %d", e, a)
}
if e, a := 1, endpointHit; e != a {
t.Errorf("expect %d endpoint hits, got %d", e, a)
}
}

2
vendor/github.com/aws/aws-sdk-go/aws/request/request_resetbody_test.go generated vendored
View File

@ -50,7 +50,7 @@ func TestResetBody_ExcludeUnseekableBodyByMethod(t *testing.T) {
r.SetReaderBody(reader)
if a, e := r.HTTPRequest.Body == noBodyReader, c.IsNoBody; a != e {
if a, e := r.HTTPRequest.Body == NoBody, c.IsNoBody; a != e {
t.Errorf("%d, expect body to be set to noBody(%t), but was %t", i, e, a)
}
}

80
vendor/github.com/aws/aws-sdk-go/aws/request/request_test.go generated vendored
View File

@ -760,3 +760,83 @@ func (reader *errReader) Read(b []byte) (int, error) {
func (reader *errReader) Close() error {
return nil
}
func TestIsNoBodyReader(t *testing.T) {
cases := []struct {
reader io.ReadCloser
expect bool
}{
{ioutil.NopCloser(bytes.NewReader([]byte("abc"))), false},
{ioutil.NopCloser(bytes.NewReader(nil)), false},
{nil, false},
{request.NoBody, true},
}
for i, c := range cases {
if e, a := c.expect, request.NoBody == c.reader; e != a {
t.Errorf("%d, expect %t match, but was %t", i, e, a)
}
}
}
func TestRequest_TemporaryRetry(t *testing.T) {
done := make(chan struct{})
server := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
w.Header().Set("Content-Length", "1024")
w.WriteHeader(http.StatusOK)
w.Write(make([]byte, 100))
f := w.(http.Flusher)
f.Flush()
<-done
}))
client := &http.Client{
Timeout: 100 * time.Millisecond,
}
svc := awstesting.NewClient(&aws.Config{
Region: unit.Session.Config.Region,
MaxRetries: aws.Int(1),
HTTPClient: client,
DisableSSL: aws.Bool(true),
Endpoint: aws.String(server.URL),
})
req := svc.NewRequest(&request.Operation{
Name: "name", HTTPMethod: "GET", HTTPPath: "/path",
}, &struct{}{}, &struct{}{})
req.Handlers.Unmarshal.PushBack(func(r *request.Request) {
defer req.HTTPResponse.Body.Close()
_, err := io.Copy(ioutil.Discard, req.HTTPResponse.Body)
r.Error = awserr.New(request.ErrCodeSerialization, "error", err)
})
err := req.Send()
if err == nil {
t.Errorf("expect error, got none")
}
close(done)
aerr := err.(awserr.Error)
if e, a := request.ErrCodeSerialization, aerr.Code(); e != a {
t.Errorf("expect %q error code, got %q", e, a)
}
if e, a := 1, req.RetryCount; e != a {
t.Errorf("expect %d retries, got %d", e, a)
}
type temporary interface {
Temporary() bool
}
terr := aerr.OrigErr().(temporary)
if !terr.Temporary() {
t.Errorf("expect temporary error, was not")
}
}

9
vendor/github.com/aws/aws-sdk-go/aws/request/retryer.go generated vendored
View File

@ -38,7 +38,6 @@ var throttleCodes = map[string]struct{}{
"ThrottlingException": {},
"RequestLimitExceeded": {},
"RequestThrottled": {},
"LimitExceededException": {}, // Deleting 10+ DynamoDb tables at once
"TooManyRequestsException": {}, // Lambda functions
"PriorRequestNotComplete": {}, // Route53
}
@ -75,6 +74,10 @@ var validParentCodes = map[string]struct{}{
ErrCodeRead: struct{}{},
}
type temporaryError interface {
Temporary() bool
}
func isNestedErrorRetryable(parentErr awserr.Error) bool {
if parentErr == nil {
return false
@ -93,6 +96,10 @@ func isNestedErrorRetryable(parentErr awserr.Error) bool {
return isCodeRetryable(aerr.Code())
}
if t, ok := err.(temporaryError); ok {
return t.Temporary()
}
return isErrConnectionReset(err)
}

52
vendor/github.com/aws/aws-sdk-go/aws/request/retryer_test.go generated vendored
View File

@ -1,10 +1,10 @@
package request
import (
"errors"
"fmt"
"testing"
"github.com/stretchr/testify/assert"
"github.com/aws/aws-sdk-go/aws/awserr"
)
@ -12,5 +12,51 @@ func TestRequestThrottling(t *testing.T) {
req := Request{}
req.Error = awserr.New("Throttling", "", nil)
assert.True(t, req.IsErrorThrottle())
if e, a := true, req.IsErrorThrottle(); e != a {
t.Errorf("expect %t to be throttled, was %t", e, a)
}
}
type mockTempError bool
func (e mockTempError) Error() string {
return fmt.Sprintf("mock temporary error: %t", e.Temporary())
}
func (e mockTempError) Temporary() bool {
return bool(e)
}
func TestIsErrorRetryable(t *testing.T) {
cases := []struct {
Err error
IsTemp bool
}{
{
Err: awserr.New(ErrCodeSerialization, "temporary error", mockTempError(true)),
IsTemp: true,
},
{
Err: awserr.New(ErrCodeSerialization, "temporary error", mockTempError(false)),
IsTemp: false,
},
{
Err: awserr.New(ErrCodeSerialization, "some error", errors.New("blah")),
IsTemp: false,
},
{
Err: awserr.New("SomeError", "some error", nil),
IsTemp: false,
},
{
Err: awserr.New("RequestError", "some error", nil),
IsTemp: true,
},
}
for i, c := range cases {
retryable := IsErrorRetryable(c.Err)
if e, a := c.IsTemp, retryable; e != a {
t.Errorf("%d, expect %t temporary error, got %t", i, e, a)
}
}
}

300
vendor/github.com/aws/aws-sdk-go/aws/session/custom_ca_bundle_test.go generated vendored
View File

@ -2,90 +2,76 @@ package session
import (
"bytes"
"crypto/tls"
"io/ioutil"
"fmt"
"net"
"net/http"
"net/http/httptest"
"os"
"strings"
"testing"
"time"
"github.com/aws/aws-sdk-go/aws"
"github.com/aws/aws-sdk-go/aws/awserr"
"github.com/aws/aws-sdk-go/aws/credentials"
"github.com/stretchr/testify/assert"
"github.com/aws/aws-sdk-go/awstesting"
)
func createTLSServer(cert, key []byte, done <-chan struct{}) (*httptest.Server, error) {
c, err := tls.X509KeyPair(cert, key)
var TLSBundleCertFile string
var TLSBundleKeyFile string
var TLSBundleCAFile string
func TestMain(m *testing.M) {
var err error
TLSBundleCertFile, TLSBundleKeyFile, TLSBundleCAFile, err = awstesting.CreateTLSBundleFiles()
if err != nil {
return nil, err
panic(err)
}
s := httptest.NewUnstartedServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
w.WriteHeader(http.StatusOK)
}))
s.TLS = &tls.Config{
Certificates: []tls.Certificate{c},
}
s.TLS.BuildNameToCertificate()
s.StartTLS()
fmt.Println("TestMain", TLSBundleCertFile, TLSBundleKeyFile)
go func() {
<-done
s.Close()
}()
code := m.Run()
return s, nil
}
func setupTestCAFile(b []byte) (string, error) {
bundleFile, err := ioutil.TempFile(os.TempDir(), "aws-sdk-go-session-test")
err = awstesting.CleanupTLSBundleFiles(TLSBundleCertFile, TLSBundleKeyFile, TLSBundleCAFile)
if err != nil {
return "", err
panic(err)
}
_, err = bundleFile.Write(b)
if err != nil {
return "", err
}
defer bundleFile.Close()
return bundleFile.Name(), nil
os.Exit(code)
}
func TestNewSession_WithCustomCABundle_Env(t *testing.T) {
oldEnv := initSessionTestEnv()
defer popEnv(oldEnv)
done := make(chan struct{})
server, err := createTLSServer(testTLSBundleCert, testTLSBundleKey, done)
assert.NoError(t, err)
endpoint, err := awstesting.CreateTLSServer(TLSBundleCertFile, TLSBundleKeyFile, nil)
if err != nil {
t.Fatalf("expect no error, got %v", err)
}
// Write bundle to file
caFilename, err := setupTestCAFile(testTLSBundleCA)
defer func() {
os.Remove(caFilename)
}()
assert.NoError(t, err)
os.Setenv("AWS_CA_BUNDLE", caFilename)
os.Setenv("AWS_CA_BUNDLE", TLSBundleCAFile)
s, err := NewSession(&aws.Config{
HTTPClient: &http.Client{},
Endpoint: aws.String(server.URL),
Endpoint: aws.String(endpoint),
Region: aws.String("mock-region"),
Credentials: credentials.AnonymousCredentials,
})
assert.NoError(t, err)
assert.NotNil(t, s)
if err != nil {
t.Fatalf("expect no error, got %v", err)
}
if s == nil {
t.Fatalf("expect session to be created, got none")
}
req, _ := http.NewRequest("GET", *s.Config.Endpoint, nil)
resp, err := s.Config.HTTPClient.Do(req)
assert.NoError(t, err)
assert.Equal(t, http.StatusOK, resp.StatusCode)
if err != nil {
t.Fatalf("expect no error, got %v", err)
}
if e, a := http.StatusOK, resp.StatusCode; e != a {
t.Errorf("expect %d status code, got %d", e, a)
}
}
func TestNewSession_WithCustomCABundle_EnvNotExists(t *testing.T) {
@ -95,65 +81,87 @@ func TestNewSession_WithCustomCABundle_EnvNotExists(t *testing.T) {
os.Setenv("AWS_CA_BUNDLE", "file-not-exists")
s, err := NewSession()
assert.Error(t, err)
assert.Equal(t, "LoadCustomCABundleError", err.(awserr.Error).Code())
assert.Nil(t, s)
if err == nil {
t.Fatalf("expect error, got none")
}
if e, a := "LoadCustomCABundleError", err.(awserr.Error).Code(); e != a {
t.Errorf("expect %s error code, got %s", e, a)
}
if s != nil {
t.Errorf("expect nil session, got %v", s)
}
}
func TestNewSession_WithCustomCABundle_Option(t *testing.T) {
oldEnv := initSessionTestEnv()
defer popEnv(oldEnv)
done := make(chan struct{})
server, err := createTLSServer(testTLSBundleCert, testTLSBundleKey, done)
assert.NoError(t, err)
endpoint, err := awstesting.CreateTLSServer(TLSBundleCertFile, TLSBundleKeyFile, nil)
if err != nil {
t.Fatalf("expect no error, got %v", err)
}
s, err := NewSessionWithOptions(Options{
Config: aws.Config{
HTTPClient: &http.Client{},
Endpoint: aws.String(server.URL),
Endpoint: aws.String(endpoint),
Region: aws.String("mock-region"),
Credentials: credentials.AnonymousCredentials,
},
CustomCABundle: bytes.NewReader(testTLSBundleCA),
CustomCABundle: bytes.NewReader(awstesting.TLSBundleCA),
})
assert.NoError(t, err)
assert.NotNil(t, s)
if err != nil {
t.Fatalf("expect no error, got %v", err)
}
if s == nil {
t.Fatalf("expect session to be created, got none")
}
req, _ := http.NewRequest("GET", *s.Config.Endpoint, nil)
resp, err := s.Config.HTTPClient.Do(req)
assert.NoError(t, err)
assert.Equal(t, http.StatusOK, resp.StatusCode)
if err != nil {
t.Fatalf("expect no error, got %v", err)
}
if e, a := http.StatusOK, resp.StatusCode; e != a {
t.Errorf("expect %d status code, got %d", e, a)
}
}
func TestNewSession_WithCustomCABundle_OptionPriority(t *testing.T) {
oldEnv := initSessionTestEnv()
defer popEnv(oldEnv)
done := make(chan struct{})
server, err := createTLSServer(testTLSBundleCert, testTLSBundleKey, done)
assert.NoError(t, err)
endpoint, err := awstesting.CreateTLSServer(TLSBundleCertFile, TLSBundleKeyFile, nil)
if err != nil {
t.Fatalf("expect no error, got %v", err)
}
os.Setenv("AWS_CA_BUNDLE", "file-not-exists")
s, err := NewSessionWithOptions(Options{
Config: aws.Config{
HTTPClient: &http.Client{},
Endpoint: aws.String(server.URL),
Endpoint: aws.String(endpoint),
Region: aws.String("mock-region"),
Credentials: credentials.AnonymousCredentials,
},
CustomCABundle: bytes.NewReader(testTLSBundleCA),
CustomCABundle: bytes.NewReader(awstesting.TLSBundleCA),
})
assert.NoError(t, err)
assert.NotNil(t, s)
if err != nil {
t.Fatalf("expect no error, got %v", err)
}
if s == nil {
t.Fatalf("expect session to be created, got none")
}
req, _ := http.NewRequest("GET", *s.Config.Endpoint, nil)
resp, err := s.Config.HTTPClient.Do(req)
assert.NoError(t, err)
assert.Equal(t, http.StatusOK, resp.StatusCode)
if err != nil {
t.Fatalf("expect no error, got %v", err)
}
if e, a := http.StatusOK, resp.StatusCode; e != a {
t.Errorf("expect %d status code, got %d", e, a)
}
}
type mockRoundTripper struct{}
@ -172,25 +180,35 @@ func TestNewSession_WithCustomCABundle_UnsupportedTransport(t *testing.T) {
Transport: &mockRoundTripper{},
},
},
CustomCABundle: bytes.NewReader(testTLSBundleCA),
CustomCABundle: bytes.NewReader(awstesting.TLSBundleCA),
})
assert.Error(t, err)
assert.Equal(t, "LoadCustomCABundleError", err.(awserr.Error).Code())
assert.Contains(t, err.(awserr.Error).Message(), "transport unsupported type")
assert.Nil(t, s)
if err == nil {
t.Fatalf("expect error, got none")
}
if e, a := "LoadCustomCABundleError", err.(awserr.Error).Code(); e != a {
t.Errorf("expect %s error code, got %s", e, a)
}
if s != nil {
t.Errorf("expect nil session, got %v", s)
}
aerrMsg := err.(awserr.Error).Message()
if e, a := "transport unsupported type", aerrMsg; !strings.Contains(a, e) {
t.Errorf("expect %s to be in %s", e, a)
}
}
func TestNewSession_WithCustomCABundle_TransportSet(t *testing.T) {
oldEnv := initSessionTestEnv()
defer popEnv(oldEnv)
done := make(chan struct{})
server, err := createTLSServer(testTLSBundleCert, testTLSBundleKey, done)
assert.NoError(t, err)
endpoint, err := awstesting.CreateTLSServer(TLSBundleCertFile, TLSBundleKeyFile, nil)
if err != nil {
t.Fatalf("expect no error, got %v", err)
}
s, err := NewSessionWithOptions(Options{
Config: aws.Config{
Endpoint: aws.String(server.URL),
Endpoint: aws.String(endpoint),
Region: aws.String("mock-region"),
Credentials: credentials.AnonymousCredentials,
HTTPClient: &http.Client{
@ -205,115 +223,21 @@ func TestNewSession_WithCustomCABundle_TransportSet(t *testing.T) {
},
},
},
CustomCABundle: bytes.NewReader(testTLSBundleCA),
CustomCABundle: bytes.NewReader(awstesting.TLSBundleCA),
})
assert.NoError(t, err)
assert.NotNil(t, s)
if err != nil {
t.Fatalf("expect no error, got %v", err)
}
if s == nil {
t.Fatalf("expect session to be created, got none")
}
req, _ := http.NewRequest("GET", *s.Config.Endpoint, nil)
resp, err := s.Config.HTTPClient.Do(req)
assert.NoError(t, err)
assert.Equal(t, http.StatusOK, resp.StatusCode)
if err != nil {
t.Fatalf("expect no error, got %v", err)
}
if e, a := http.StatusOK, resp.StatusCode; e != a {
t.Errorf("expect %d status code, got %d", e, a)
}
}
/* Cert generation steps
# Create the CA key
openssl genrsa -des3 -out ca.key 1024
# Create the CA Cert
openssl req -new -sha256 -x509 -days 3650 \
-subj "/C=GO/ST=Gopher/O=Testing ROOT CA" \
-key ca.key -out ca.crt
# Create config
cat > csr_details.txt <<-EOF
[req]
default_bits = 1024
prompt = no
default_md = sha256
req_extensions = SAN
distinguished_name = dn
[ dn ]
C=GO
ST=Gopher
O=Testing Certificate
OU=Testing IP
[SAN]
subjectAltName = IP:127.0.0.1
EOF
# Create certificate signing request
openssl req -new -sha256 -nodes -newkey rsa:1024 \
-config <( cat csr_details.txt ) \
-keyout ia.key -out ia.csr
# Create a signed certificate
openssl x509 -req -days 3650 \
-CAcreateserial \
-extfile <( cat csr_details.txt ) \
-extensions SAN \
-CA ca.crt -CAkey ca.key -in ia.csr -out ia.crt
# Verify
openssl req -noout -text -in ia.csr
openssl x509 -noout -text -in ia.crt
*/
var (
// ca.crt
testTLSBundleCA = []byte(`-----BEGIN CERTIFICATE-----
MIICiTCCAfKgAwIBAgIJAJ5X1olt05XjMA0GCSqGSIb3DQEBCwUAMDgxCzAJBgNV
BAYTAkdPMQ8wDQYDVQQIEwZHb3BoZXIxGDAWBgNVBAoTD1Rlc3RpbmcgUk9PVCBD
QTAeFw0xNzAzMDkwMDAyMDZaFw0yNzAzMDcwMDAyMDZaMDgxCzAJBgNVBAYTAkdP
MQ8wDQYDVQQIEwZHb3BoZXIxGDAWBgNVBAoTD1Rlc3RpbmcgUk9PVCBDQTCBnzAN
BgkqhkiG9w0BAQEFAAOBjQAwgYkCgYEAw/8DN+t9XQR60jx42rsQ2WE2Dx85rb3n
GQxnKZZLNddsT8rDyxJNP18aFalbRbFlyln5fxWxZIblu9Xkm/HRhOpbSimSqo1y
uDx21NVZ1YsOvXpHby71jx3gPrrhSc/t/zikhi++6D/C6m1CiIGuiJ0GBiJxtrub
UBMXT0QtI2ECAwEAAaOBmjCBlzAdBgNVHQ4EFgQU8XG3X/YHBA6T04kdEkq6+4GV
YykwaAYDVR0jBGEwX4AU8XG3X/YHBA6T04kdEkq6+4GVYymhPKQ6MDgxCzAJBgNV
BAYTAkdPMQ8wDQYDVQQIEwZHb3BoZXIxGDAWBgNVBAoTD1Rlc3RpbmcgUk9PVCBD
QYIJAJ5X1olt05XjMAwGA1UdEwQFMAMBAf8wDQYJKoZIhvcNAQELBQADgYEAeILv
z49+uxmPcfOZzonuOloRcpdvyjiXblYxbzz6ch8GsE7Q886FTZbvwbgLhzdwSVgG
G8WHkodDUsymVepdqAamS3f8PdCUk8xIk9mop8LgaB9Ns0/TssxDvMr3sOD2Grb3
xyWymTWMcj6uCiEBKtnUp4rPiefcvCRYZ17/hLE=
-----END CERTIFICATE-----
`)
// ai.crt
testTLSBundleCert = []byte(`-----BEGIN CERTIFICATE-----
MIICGjCCAYOgAwIBAgIJAIIu+NOoxxM0MA0GCSqGSIb3DQEBBQUAMDgxCzAJBgNV
BAYTAkdPMQ8wDQYDVQQIEwZHb3BoZXIxGDAWBgNVBAoTD1Rlc3RpbmcgUk9PVCBD
QTAeFw0xNzAzMDkwMDAzMTRaFw0yNzAzMDcwMDAzMTRaMFExCzAJBgNVBAYTAkdP
MQ8wDQYDVQQIDAZHb3BoZXIxHDAaBgNVBAoME1Rlc3RpbmcgQ2VydGlmaWNhdGUx
EzARBgNVBAsMClRlc3RpbmcgSVAwgZ8wDQYJKoZIhvcNAQEBBQADgY0AMIGJAoGB
AN1hWHeioo/nASvbrjwCQzXCiWiEzGkw353NxsAB54/NqDL3LXNATtiSJu8kJBrm
Ah12IFLtWLGXjGjjYlHbQWnOR6awveeXnQZukJyRWh7m/Qlt9Ho0CgZE1U+832ac
5GWVldNxW1Lz4I+W9/ehzqe8I80RS6eLEKfUFXGiW+9RAgMBAAGjEzARMA8GA1Ud
EQQIMAaHBH8AAAEwDQYJKoZIhvcNAQEFBQADgYEAdF4WQHfVdPCbgv9sxgJjcR1H
Hgw9rZ47gO1IiIhzglnLXQ6QuemRiHeYFg4kjcYBk1DJguxzDTGnUwhUXOibAB+S
zssmrkdYYvn9aUhjc3XK3tjAoDpsPpeBeTBamuUKDHoH/dNRXxerZ8vu6uPR3Pgs
5v/KCV6IAEcvNyOXMPo=
-----END CERTIFICATE-----
`)
// ai.key
testTLSBundleKey = []byte(`-----BEGIN RSA PRIVATE KEY-----
MIICXAIBAAKBgQDdYVh3oqKP5wEr2648AkM1wolohMxpMN+dzcbAAeePzagy9y1z
QE7YkibvJCQa5gIddiBS7Vixl4xo42JR20FpzkemsL3nl50GbpCckVoe5v0JbfR6
NAoGRNVPvN9mnORllZXTcVtS8+CPlvf3oc6nvCPNEUunixCn1BVxolvvUQIDAQAB
AoGBAMISrcirddGrlLZLLrKC1ULS2T0cdkqdQtwHYn4+7S5+/z42vMx1iumHLsSk
rVY7X41OWkX4trFxhvEIrc/O48bo2zw78P7flTxHy14uxXnllU8cLThE29SlUU7j
AVBNxJZMsXMlS/DowwD4CjFe+x4Pu9wZcReF2Z9ntzMpySABAkEA+iWoJCPE2JpS
y78q3HYYgpNY3gF3JqQ0SI/zTNkb3YyEIUffEYq0Y9pK13HjKtdsSuX4osTIhQkS
+UgRp6tCAQJBAOKPYTfQ2FX8ijgUpHZRuEAVaxASAS0UATiLgzXxLvOh/VC2at5x
wjOX6sD65pPz/0D8Qj52Cq6Q1TQ+377SDVECQAIy0od+yPweXxvrUjUd1JlRMjbB
TIrKZqs8mKbUQapw0bh5KTy+O1elU4MRPS3jNtBxtP25PQnuSnxmZcFTgAECQFzg
DiiFcsn9FuRagfkHExMiNJuH5feGxeFaP9WzI144v9GAllrOI6Bm3JNzx2ZLlg4b
20Qju8lIEj6yr6JYFaECQHM1VSojGRKpOl9Ox/R4yYSA9RV5Gyn00/aJNxVYyPD5
i3acL2joQm2kLD/LO8paJ4+iQdRXCOMMIpjxSNjGQjQ=
-----END RSA PRIVATE KEY-----
`)
)

13
vendor/github.com/aws/aws-sdk-go/aws/session/session.go generated vendored
View File

@ -155,6 +155,10 @@ type Options struct {
// and enable or disable the shared config functionality.
SharedConfigState SharedConfigState
// Ordered list of files the session will load configuration from.
// It will override environment variable AWS_SHARED_CREDENTIALS_FILE, AWS_CONFIG_FILE.
SharedConfigFiles []string
// When the SDK's shared config is configured to assume a role with MFA
// this option is required in order to provide the mechanism that will
// retrieve the MFA token. There is no default value for this field. If
@ -304,14 +308,19 @@ func newSession(opts Options, envCfg envConfig, cfgs ...*aws.Config) (*Session,
userCfg := &aws.Config{}
userCfg.MergeIn(cfgs...)
// Order config files will be loaded in with later files overwriting
// Ordered config files will be loaded in with later files overwriting
// previous config file values.
cfgFiles := []string{envCfg.SharedConfigFile, envCfg.SharedCredentialsFile}
var cfgFiles []string
if opts.SharedConfigFiles != nil {
cfgFiles = opts.SharedConfigFiles
} else {
cfgFiles = []string{envCfg.SharedConfigFile, envCfg.SharedCredentialsFile}
if !envCfg.EnableSharedConfig {
// The shared config file (~/.aws/config) is only loaded if instructed
// to load via the envConfig.EnableSharedConfig (AWS_SDK_LOAD_CONFIG).
cfgFiles = cfgFiles[1:]
}
}
// Load additional config from file(s)
sharedCfg, err := loadSharedConfig(envCfg.Profile, cfgFiles)

23
vendor/github.com/aws/aws-sdk-go/aws/session/session_test.go generated vendored
View File

@ -178,6 +178,29 @@ func TestNewSessionWithOptions_OverrideSharedConfigDisable(t *testing.T) {
assert.Contains(t, creds.ProviderName, "SharedConfigCredentials")
}
func TestNewSessionWithOptions_OverrideSharedConfigFiles(t *testing.T) {
oldEnv := initSessionTestEnv()
defer popEnv(oldEnv)
os.Setenv("AWS_SDK_LOAD_CONFIG", "1")
os.Setenv("AWS_SHARED_CREDENTIALS_FILE", testConfigFilename)
os.Setenv("AWS_PROFILE", "config_file_load_order")
s, err := NewSessionWithOptions(Options{
SharedConfigFiles: []string{testConfigOtherFilename},
})
assert.NoError(t, err)
assert.Equal(t, "shared_config_other_region", *s.Config.Region)
creds, err := s.Config.Credentials.Get()
assert.NoError(t, err)
assert.Equal(t, "shared_config_other_akid", creds.AccessKeyID)
assert.Equal(t, "shared_config_other_secret", creds.SecretAccessKey)
assert.Empty(t, creds.SessionToken)
assert.Contains(t, creds.ProviderName, "SharedConfigCredentials")
}
func TestNewSessionWithOptions_Overrides(t *testing.T) {
cases := []struct {
InEnvs map[string]string

2
vendor/github.com/aws/aws-sdk-go/aws/version.go generated vendored
View File

@ -5,4 +5,4 @@ package aws
const SDKName = "aws-sdk-go"
// SDKVersion is the version of this SDK
const SDKVersion = "1.8.22"
const SDKVersion = "1.8.27"

191
vendor/github.com/aws/aws-sdk-go/awstesting/custom_ca_bundle.go generated vendored Normal file
View File

@ -0,0 +1,191 @@
package awstesting
import (
"io/ioutil"
"net"
"net/http"
"os"
"time"
)
func availableLocalAddr(ip string) (string, error) {
l, err := net.Listen("tcp", ip+":0")
if err != nil {
return "", err
}
defer l.Close()
return l.Addr().String(), nil
}
// CreateTLSServer will create the TLS server on an open port using the
// certificate and key. The address will be returned that the server is running on.
func CreateTLSServer(cert, key string, mux *http.ServeMux) (string, error) {
addr, err := availableLocalAddr("127.0.0.1")
if err != nil {
return "", err
}
if mux == nil {
mux = http.NewServeMux()
mux.HandleFunc("/", func(w http.ResponseWriter, r *http.Request) {})
}
go func() {
if err := http.ListenAndServeTLS(addr, cert, key, mux); err != nil {
panic(err)
}
}()
time.Sleep(1 * time.Second)
return "https://" + addr, nil
}
// CreateTLSBundleFiles returns the temporary filenames for the certificate
// key, and CA PEM content. These files should be deleted when no longer
// needed. CleanupTLSBundleFiles can be used for this cleanup.
func CreateTLSBundleFiles() (cert, key, ca string, err error) {
cert, err = createTmpFile(TLSBundleCert)
if err != nil {
return "", "", "", err
}
key, err = createTmpFile(TLSBundleKey)
if err != nil {
return "", "", "", err
}
ca, err = createTmpFile(TLSBundleCA)
if err != nil {
return "", "", "", err
}
return cert, key, ca, nil
}
// CleanupTLSBundleFiles takes variadic list of files to be deleted.
func CleanupTLSBundleFiles(files ...string) error {
for _, file := range files {
if err := os.Remove(file); err != nil {
return err
}
}
return nil
}
func createTmpFile(b []byte) (string, error) {
bundleFile, err := ioutil.TempFile(os.TempDir(), "aws-sdk-go-session-test")
if err != nil {
return "", err
}
_, err = bundleFile.Write(b)
if err != nil {
return "", err
}
defer bundleFile.Close()
return bundleFile.Name(), nil
}
/* Cert generation steps
# Create the CA key
openssl genrsa -des3 -out ca.key 1024
# Create the CA Cert
openssl req -new -sha256 -x509 -days 3650 \
-subj "/C=GO/ST=Gopher/O=Testing ROOT CA" \
-key ca.key -out ca.crt
# Create config
cat > csr_details.txt <<-EOF
[req]
default_bits = 1024
prompt = no
default_md = sha256
req_extensions = SAN
distinguished_name = dn
[ dn ]
C=GO
ST=Gopher
O=Testing Certificate
OU=Testing IP
[SAN]
subjectAltName = IP:127.0.0.1
EOF
# Create certificate signing request
openssl req -new -sha256 -nodes -newkey rsa:1024 \
-config <( cat csr_details.txt ) \
-keyout ia.key -out ia.csr
# Create a signed certificate
openssl x509 -req -days 3650 \
-CAcreateserial \
-extfile <( cat csr_details.txt ) \
-extensions SAN \
-CA ca.crt -CAkey ca.key -in ia.csr -out ia.crt
# Verify
openssl req -noout -text -in ia.csr
openssl x509 -noout -text -in ia.crt
*/
var (
// TLSBundleCA ca.crt
TLSBundleCA = []byte(`-----BEGIN CERTIFICATE-----
MIICiTCCAfKgAwIBAgIJAJ5X1olt05XjMA0GCSqGSIb3DQEBCwUAMDgxCzAJBgNV
BAYTAkdPMQ8wDQYDVQQIEwZHb3BoZXIxGDAWBgNVBAoTD1Rlc3RpbmcgUk9PVCBD
QTAeFw0xNzAzMDkwMDAyMDZaFw0yNzAzMDcwMDAyMDZaMDgxCzAJBgNVBAYTAkdP
MQ8wDQYDVQQIEwZHb3BoZXIxGDAWBgNVBAoTD1Rlc3RpbmcgUk9PVCBDQTCBnzAN
BgkqhkiG9w0BAQEFAAOBjQAwgYkCgYEAw/8DN+t9XQR60jx42rsQ2WE2Dx85rb3n
GQxnKZZLNddsT8rDyxJNP18aFalbRbFlyln5fxWxZIblu9Xkm/HRhOpbSimSqo1y
uDx21NVZ1YsOvXpHby71jx3gPrrhSc/t/zikhi++6D/C6m1CiIGuiJ0GBiJxtrub
UBMXT0QtI2ECAwEAAaOBmjCBlzAdBgNVHQ4EFgQU8XG3X/YHBA6T04kdEkq6+4GV
YykwaAYDVR0jBGEwX4AU8XG3X/YHBA6T04kdEkq6+4GVYymhPKQ6MDgxCzAJBgNV
BAYTAkdPMQ8wDQYDVQQIEwZHb3BoZXIxGDAWBgNVBAoTD1Rlc3RpbmcgUk9PVCBD
QYIJAJ5X1olt05XjMAwGA1UdEwQFMAMBAf8wDQYJKoZIhvcNAQELBQADgYEAeILv
z49+uxmPcfOZzonuOloRcpdvyjiXblYxbzz6ch8GsE7Q886FTZbvwbgLhzdwSVgG
G8WHkodDUsymVepdqAamS3f8PdCUk8xIk9mop8LgaB9Ns0/TssxDvMr3sOD2Grb3
xyWymTWMcj6uCiEBKtnUp4rPiefcvCRYZ17/hLE=
-----END CERTIFICATE-----
`)
// TLSBundleCert ai.crt
TLSBundleCert = []byte(`-----BEGIN CERTIFICATE-----
MIICGjCCAYOgAwIBAgIJAIIu+NOoxxM0MA0GCSqGSIb3DQEBBQUAMDgxCzAJBgNV
BAYTAkdPMQ8wDQYDVQQIEwZHb3BoZXIxGDAWBgNVBAoTD1Rlc3RpbmcgUk9PVCBD
QTAeFw0xNzAzMDkwMDAzMTRaFw0yNzAzMDcwMDAzMTRaMFExCzAJBgNVBAYTAkdP
MQ8wDQYDVQQIDAZHb3BoZXIxHDAaBgNVBAoME1Rlc3RpbmcgQ2VydGlmaWNhdGUx
EzARBgNVBAsMClRlc3RpbmcgSVAwgZ8wDQYJKoZIhvcNAQEBBQADgY0AMIGJAoGB
AN1hWHeioo/nASvbrjwCQzXCiWiEzGkw353NxsAB54/NqDL3LXNATtiSJu8kJBrm
Ah12IFLtWLGXjGjjYlHbQWnOR6awveeXnQZukJyRWh7m/Qlt9Ho0CgZE1U+832ac
5GWVldNxW1Lz4I+W9/ehzqe8I80RS6eLEKfUFXGiW+9RAgMBAAGjEzARMA8GA1Ud
EQQIMAaHBH8AAAEwDQYJKoZIhvcNAQEFBQADgYEAdF4WQHfVdPCbgv9sxgJjcR1H
Hgw9rZ47gO1IiIhzglnLXQ6QuemRiHeYFg4kjcYBk1DJguxzDTGnUwhUXOibAB+S
zssmrkdYYvn9aUhjc3XK3tjAoDpsPpeBeTBamuUKDHoH/dNRXxerZ8vu6uPR3Pgs
5v/KCV6IAEcvNyOXMPo=
-----END CERTIFICATE-----
`)
// TLSBundleKey ai.key
TLSBundleKey = []byte(`-----BEGIN RSA PRIVATE KEY-----
MIICXAIBAAKBgQDdYVh3oqKP5wEr2648AkM1wolohMxpMN+dzcbAAeePzagy9y1z
QE7YkibvJCQa5gIddiBS7Vixl4xo42JR20FpzkemsL3nl50GbpCckVoe5v0JbfR6
NAoGRNVPvN9mnORllZXTcVtS8+CPlvf3oc6nvCPNEUunixCn1BVxolvvUQIDAQAB
AoGBAMISrcirddGrlLZLLrKC1ULS2T0cdkqdQtwHYn4+7S5+/z42vMx1iumHLsSk
rVY7X41OWkX4trFxhvEIrc/O48bo2zw78P7flTxHy14uxXnllU8cLThE29SlUU7j
AVBNxJZMsXMlS/DowwD4CjFe+x4Pu9wZcReF2Z9ntzMpySABAkEA+iWoJCPE2JpS
y78q3HYYgpNY3gF3JqQ0SI/zTNkb3YyEIUffEYq0Y9pK13HjKtdsSuX4osTIhQkS
+UgRp6tCAQJBAOKPYTfQ2FX8ijgUpHZRuEAVaxASAS0UATiLgzXxLvOh/VC2at5x
wjOX6sD65pPz/0D8Qj52Cq6Q1TQ+377SDVECQAIy0od+yPweXxvrUjUd1JlRMjbB
TIrKZqs8mKbUQapw0bh5KTy+O1elU4MRPS3jNtBxtP25PQnuSnxmZcFTgAECQFzg
DiiFcsn9FuRagfkHExMiNJuH5feGxeFaP9WzI144v9GAllrOI6Bm3JNzx2ZLlg4b
20Qju8lIEj6yr6JYFaECQHM1VSojGRKpOl9Ox/R4yYSA9RV5Gyn00/aJNxVYyPD5
i3acL2joQm2kLD/LO8paJ4+iQdRXCOMMIpjxSNjGQjQ=
-----END RSA PRIVATE KEY-----
`)
)

15
vendor/github.com/aws/aws-sdk-go/example/service/rds/rdsutils/authentication/README.md generated vendored Normal file
View File

@ -0,0 +1,15 @@
# Example
This is an example using the AWS SDK for Go to create an Amazon RDS DB token using the
rdsutils package.
# Usage
```sh
go run -tags example iam_authetnication.go <region> <db user> <db name> <endpoint to database> <iam arn>
```
Output:
```
Successfully opened connection to database
```

47
vendor/github.com/aws/aws-sdk-go/example/service/rds/rdsutils/authentication/iam_authentication.go generated vendored Normal file
View File

@ -0,0 +1,47 @@
// +build example,skip
package main
import (
"database/sql"
"fmt"
"log"
"os"
"github.com/go-sql-driver/mysql"
"github.com/aws/aws-sdk-go/aws"
"github.com/aws/aws-sdk-go/aws/credentials/stscreds"
"github.com/aws/aws-sdk-go/aws/session"
"github.com/aws/aws-sdk-go/service/rds/rdsutils"
)
// Usage ./iam_authentication <region> <db user> <db name> <endpoint to database> <iam arn>
func main() {
if len(os.Args) < 5 {
log.Println("USAGE ERROR: go run concatenateObjects.go <region> <endpoint to database> <iam arn>")
os.Exit(1)
}
awsRegion := os.Args[1]
dbUser := os.Args[2]
dbName := os.Args[3]
dbEndpoint := os.Args[4]
awsCreds := stscreds.NewCredentials(session.New(&aws.Config{Region: &awsRegion}), os.Args[5])
authToken, err := rdsutils.BuildAuthToken(dbEndpoint, awsRegion, dbUser, awsCreds)
// Create the MySQL DNS string for the DB connection
// user:password@protocol(endpoint)/dbname?<params>
dnsStr := fmt.Sprintf("%s:%s@tcp(%s)/%s?tls=true",
dbUser, authToken, dbEndpoint, dbName,
)
driver := mysql.MySQLDriver{}
_ = driver
// Use db to perform SQL operations on database
if _, err = sql.Open("mysql", dnsStr); err != nil {
panic(err)
}
fmt.Println("Successfully opened connection to database")
}

124
vendor/github.com/aws/aws-sdk-go/example/service/s3/presignURL/README.md generated vendored Normal file
View File

@ -0,0 +1,124 @@
# Presigned Amazon S3 API Operation Example
This example demonstrates how you can build a client application to retrieve and
upload object data from Amazon S3 without needing to know anything about Amazon
S3 or have access to any AWS credentials. Only the service would have knowledge
of how and where the objects are stored in Amazon S3.
The example is split into two parts `server.go` and `client.go`. These two parts
simulate the client/server architecture. In this example the client will represent
a third part user that will request resource URLs from the service. The service
will generate presigned S3 URLs which the client can use to download and
upload S3 object content.
The service supports generating presigned URLs for two S3 APIs; `GetObject` and
`PutObject`. The client will request a presigned URL from the service with an
object Key. In this example the value is the S3 object's `key`. Alternatively,
you could use your own pattern with no visible relation to the S3 object's key.
The server would then perform a cross reference with client provided value to
one that maps to the S3 object's key.
Before using the client to upload and download S3 objects you'll need to start the
service. The service will use the SDK's default credential chain to source your
AWS credentials. See the [`Configuring Credentials`](http://docs.aws.amazon.com/sdk-for-go/api/)
section of the SDK's API Reference guide on how the SDK loads your AWS credentials.
The server requires the S3 `-b bucket` the presigned URLs will be generated for. A
`-r region` is only needed if the bucket is in AWS China or AWS Gov Cloud. For
buckets in AWS the server will use the [`s3manager.GetBucketRegion`](http://docs.aws.amazon.com/sdk-for-go/api/service/s3/s3manager/#GetBucketRegion) utility to lookup the bucket's region.
You should run the service in the background or in a separate terminal tab before
moving onto the client.
```sh
go run -tags example server/server.go -b mybucket
> Starting Server On: 127.0.0.1:8080
```
Use the `--help` flag to see a list of additional configuration flags, and their
defaults.
## Downloading an Amazon S3 Object
Use the client application to request a presigned URL from the server and use
that presigned URL to download the object from S3. Calling the client with the
`-get key` flag will do this. An optional `-f filename` flag can be provided as
well to write the object to. If no flag is provided the object will be written
to `stdout`
```sh
go run -tags example client/client.go -get "my-object/key" -f outputfilename
```
Use the `--help` flag to see a list of additional configuration flags, and their
defaults.
The following curl request demonstrates the request the client makes to the server
for the presigned URL for the `my-object/key` S3 object. The `method` query
parameter lets the server know that we are requesting the `GetObject`'s presigned
URL. The `method` value can be `GET` or `PUT` for the `GetObject` or `PutObject` APIs.
```sh
curl -v "http://127.0.0.1:8080/presign/my-object/key?method=GET"
```
The server will respond with a JSON value. The value contains three pieces of
information that the client will need to correctly make the request. First is
the presigned URL. This is the URL the client will make the request to. Second
is the HTTP method the request should be sent as. This is included to simplify
the client's request building. Finally the response will include a list of
additional headers that the client should include that the presigned request
was signed with.
```json
{
"URL": "https://mybucket.s3-us-west-2.amazonaws.com/my-object/key?<signature>",
"Method": "GET",
"Header": {
"x-amz-content-sha256":["UNSIGNED-PAYLOAD"]
}
}
```
With this URL our client will build a HTTP request for the S3 object's data. The
`client.go` will then write the object's data to the `filename` if one is provided,
or to `stdout` of a filename is not set in the command line arguments.
## Uploading a File to Amazon S3
Just like the download, uploading a file to S3 will use a presigned URL requested
from the server. The resigned URL will be built into an HTTP request using the
URL, Method, and Headers. The `-put key` flag will upload the content of `-f filename`
or stdin if no filename is provided to S3 using a presigned URL provided by the
service
```sh
go run -tags example client/client.go -put "my-object/key" -f filename
```
Like the download case this will make a HTTP request to the server for the
presigned URL. The Server will respond with a presigned URL for S3's `PutObject`
API operation. In addition the `method` query parameter the client will also
include a `contentLength` this value instructs the server to generate the presigned
PutObject request with a `Content-Length` header value included in the signature.
This is done so the content that is uploaded by the client can only be the size
the presigned request was generated for.
```sh
curl -v "http://127.0.0.1:8080/presign/my-object/key?method=PUT&contentLength=1024"
```
## Expanding the Example
This example provides a spring board you can use to vend presigned URLs to your
clients instead of streaming the object's content through your service. This
client and server example can be expanded and customized. Adding new functionality
such as additional constraints the server puts on the presigned URLs like
`Content-Type`.
In addition to adding constraints to the presigned URLs the service could be
updated to obfuscate S3 object's key. Instead of the client knowing the object's
key, a lookup system could be used instead. This could be substitution based,
or lookup into an external data store such as DynamoDB.

266
vendor/github.com/aws/aws-sdk-go/example/service/s3/presignURL/client/client.go generated vendored Normal file
View File

@ -0,0 +1,266 @@
// +build example
package main
import (
"bytes"
"encoding/json"
"flag"
"fmt"
"io"
"io/ioutil"
"net/http"
"os"
"strconv"
"strings"
)
// client.go is an example of a client that will request URLs from a service that
// the client will use to upload and download content with.
//
// The server must be started before the client is run.
//
// Use "--help" command line argument flag to see all options and defaults. If
// filename is not provided the client will read from stdin for uploads and
// write to stdout for downloads.
//
// Usage:
// go run -tags example client.go -get myObjectKey -f filename
func main() {
method, filename, key, serverURL := loadConfig()
var err error
switch method {
case GetMethod:
// Requests the URL from the server that the client will use to download
// the content from. The content will be written to the file pointed to
// by filename. Creating it if the file does not exist. If filename is
// not set the contents will be written to stdout.
err = downloadFile(serverURL, key, filename)
case PutMethod:
// Requests the URL from the service that the client will use to upload
// content to. The content will be read from the file pointed to by the
// filename. If the filename is not set, content will be read from stdin.
err = uploadFile(serverURL, key, filename)
}
if err != nil {
exitError(err)
}
}
// loadConfig configures the client based on the command line arguments used.
func loadConfig() (method Method, serverURL, key, filename string) {
var getKey, putKey string
flag.StringVar(&getKey, "get", "",
"Downloads the object from S3 by the `key`. Writes the object to a file the filename is provided, otherwise writes to stdout.")
flag.StringVar(&putKey, "put", "",
"Uploads data to S3 at the `key` provided. Uploads the file if filename is provided, otherwise reads from stdin.")
flag.StringVar(&serverURL, "s", "http://127.0.0.1:8080", "Required `URL` the client will request presigned S3 operation from.")
flag.StringVar(&filename, "f", "", "The `filename` of the file to upload and get from S3.")
flag.Parse()
var errs Errors
if len(serverURL) == 0 {
errs = append(errs, fmt.Errorf("server URL required"))
}
if !((len(getKey) != 0) != (len(putKey) != 0)) {
errs = append(errs, fmt.Errorf("either `get` or `put` can be provided, and one of the two is required."))
}
if len(getKey) > 0 {
method = GetMethod
key = getKey
} else {
method = PutMethod
key = putKey
}
if len(errs) > 0 {
fmt.Fprintf(os.Stderr, "Failed to load configuration:%v\n", errs)
flag.PrintDefaults()
os.Exit(1)
}
return method, filename, key, serverURL
}
// downloadFile will request a URL from the server that the client can download
// the content pointed to by "key". The content will be written to the file
// pointed to by filename, creating the file if it doesn't exist. If filename
// is not set the content will be written to stdout.
func downloadFile(serverURL, key, filename string) error {
var w *os.File
if len(filename) > 0 {
f, err := os.Create(filename)
if err != nil {
return fmt.Errorf("failed to create download file %s, %v", filename, err)
}
w = f
} else {
w = os.Stdout
}
defer w.Close()
// Get the presigned URL from the remote service.
req, err := getPresignedRequest(serverURL, "GET", key, 0)
if err != nil {
return fmt.Errorf("failed to get get presigned request, %v", err)
}
// Gets the file contents with the URL provided by the service.
resp, err := http.DefaultClient.Do(req)
if err != nil {
return fmt.Errorf("failed to do GET request, %v", err)
}
defer resp.Body.Close()
if resp.StatusCode != http.StatusOK {
return fmt.Errorf("failed to get S3 object, %d:%s",
resp.StatusCode, resp.Status)
}
if _, err = io.Copy(w, resp.Body); err != nil {
return fmt.Errorf("failed to write S3 object, %v", err)
}
return nil
}
// uploadFile will request a URL from the service that the client can use to
// upload content to. The content will be read from the file pointed to by filename.
// If filename is not set the content will be read from stdin.
func uploadFile(serverURL, key, filename string) error {
var r io.ReadCloser
var size int64
if len(filename) > 0 {
f, err := os.Open(filename)
if err != nil {
return fmt.Errorf("failed to open upload file %s, %v", filename, err)
}
// Get the size of the file so that the constraint of Content-Length
// can be included with the presigned URL. This can be used by the
// server or client to ensure the content uploaded is of a certain size.
//
// These constraints can further be expanded to include things like
// Content-Type. Additionally constraints such as X-Amz-Content-Sha256
// header set restricting the content of the file to only the content
// the client initially made the request with. This prevents the object
// from being overwritten or used to upload other unintended content.
stat, err := f.Stat()
if err != nil {
return fmt.Errorf("failed to stat file, %s, %v", filename, err)
}
size = stat.Size()
r = f
} else {
buf := &bytes.Buffer{}
io.Copy(buf, os.Stdin)
size = int64(buf.Len())
r = ioutil.NopCloser(buf)
}
defer r.Close()
// Get the Presigned URL from the remote service. Pass in the file's
// size if it is known so that the presigned URL returned will be required
// to be used with the size of content requested.
req, err := getPresignedRequest(serverURL, "PUT", key, size)
if err != nil {
return fmt.Errorf("failed to get get presigned request, %v", err)
}
req.Body = r
// Upload the file contents to S3.
resp, err := http.DefaultClient.Do(req)
if err != nil {
return fmt.Errorf("failed to do GET request, %v", err)
}
defer resp.Body.Close()
if resp.StatusCode != http.StatusOK {
return fmt.Errorf("failed to put S3 object, %d:%s",
resp.StatusCode, resp.Status)
}
return nil
}
// getPresignRequest will request a URL from the service for the content specified
// by the key and method. Returns a constructed Request that can be used to
// upload or download content with based on the method used.
//
// If the PUT method is used the request's Body will need to be set on the returned
// request value.
func getPresignedRequest(serverURL, method, key string, contentLen int64) (*http.Request, error) {
u := fmt.Sprintf("%s/presign/%s?method=%s&contentLength=%d",
serverURL, key, method, contentLen,
)
resp, err := http.Get(u)
if err != nil {
return nil, fmt.Errorf("failed to make request for presigned URL, %v", err)
}
defer resp.Body.Close()
if resp.StatusCode != http.StatusOK {
return nil, fmt.Errorf("failed to get valid presign response, %s", resp.Status)
}
p := PresignResp{}
if err := json.NewDecoder(resp.Body).Decode(&p); err != nil {
return nil, fmt.Errorf("failed to decode response body, %v", err)
}
req, err := http.NewRequest(p.Method, p.URL, nil)
if err != nil {
return nil, fmt.Errorf("failed to build presigned request, %v", err)
}
for k, vs := range p.Header {
for _, v := range vs {
req.Header.Add(k, v)
}
}
// Need to ensure that the content length member is set of the HTTP Request
// or the request will not be transmitted correctly with a content length
// value across the wire.
if contLen := req.Header.Get("Content-Length"); len(contLen) > 0 {
req.ContentLength, _ = strconv.ParseInt(contLen, 10, 64)
}
return req, nil
}
type Method int
const (
PutMethod Method = iota
GetMethod
)
type Errors []error
func (es Errors) Error() string {
out := make([]string, len(es))
for _, e := range es {
out = append(out, e.Error())
}
return strings.Join(out, "\n")
}
type PresignResp struct {
Method, URL string
Header http.Header
}
func exitError(err error) {
fmt.Fprintln(os.Stderr, err.Error())
os.Exit(1)
}

186
vendor/github.com/aws/aws-sdk-go/example/service/s3/presignURL/server/server.go generated vendored Normal file
View File

@ -0,0 +1,186 @@
// +build example
package main
import (
"encoding/json"
"flag"
"fmt"
"net"
"net/http"
"os"
"strconv"
"strings"
"time"
"github.com/aws/aws-sdk-go/aws"
"github.com/aws/aws-sdk-go/aws/endpoints"
"github.com/aws/aws-sdk-go/aws/session"
"github.com/aws/aws-sdk-go/service/s3"
"github.com/aws/aws-sdk-go/service/s3/s3iface"
"github.com/aws/aws-sdk-go/service/s3/s3manager"
)
// server.go is an example of a service that vends lists for requests for presigned
// URLs for S3 objects. The service supports two S3 operations, "GetObject" and
// "PutObject".
//
// Example GetObject request to the service for the object with the key "MyObjectKey":
//
// curl -v "http://127.0.0.1:8080/presign/my-object/key?method=GET"
//
// Example PutObject request to the service for the object with the key "MyObjectKey":
//
// curl -v "http://127.0.0.1:8080/presign/my-object/key?method=PUT&contentLength=1024"
//
// Use "--help" command line argument flag to see all options and defaults.
//
// Usage:
// go run -tags example service.go -b myBucket
func main() {
addr, bucket, region := loadConfig()
// Create a AWS SDK for Go Session that will load credentials using the SDK's
// default credential change.
sess := session.Must(session.NewSession())
// Use the GetBucketRegion utility to lookup the bucket's region automatically.
// The service.go will only do this correctly for AWS regions. For AWS China
// and AWS Gov Cloud the region needs to be specified to let the service know
// to look in those partitions instead of AWS.
if len(region) == 0 {
var err error
region, err = s3manager.GetBucketRegion(aws.BackgroundContext(), sess, bucket, endpoints.UsWest2RegionID)
if err != nil {
exitError(fmt.Errorf("failed to get bucket region, %v", err))
}
}
// Create a new S3 service client that will be use by the service to generate
// presigned URLs with. Not actual API requests will be made with this client.
// The credentials loaded when the Session was created above will be used
// to sign the requests with.
s3Svc := s3.New(sess, &aws.Config{
Region: aws.String(region),
})
// Start the server listening and serve presigned URLs for GetObject and
// PutObject requests.
if err := listenAndServe(addr, bucket, s3Svc); err != nil {
exitError(err)
}
}
func loadConfig() (addr, bucket, region string) {
flag.StringVar(&bucket, "b", "", "S3 `bucket` object should be uploaded to.")
flag.StringVar(&region, "r", "", "AWS `region` the bucket exists in, If not set region will be looked up, only valid for AWS Regions, not AWS China or Gov Cloud.")
flag.StringVar(&addr, "a", "127.0.0.1:8080", "The TCP `address` the server will be started on.")
flag.Parse()
if len(bucket) == 0 {
fmt.Fprintln(os.Stderr, "bucket is required")
flag.PrintDefaults()
os.Exit(1)
}
return addr, bucket, region
}
func listenAndServe(addr, bucket string, svc s3iface.S3API) error {
l, err := net.Listen("tcp", addr)
if err != nil {
return fmt.Errorf("failed to start service listener, %v", err)
}
const presignPath = "/presign/"
// Create the HTTP handler for the "/presign/" path prefix. This will handle
// all requests on this path, extracting the object's key from the path.
http.HandleFunc(presignPath, func(w http.ResponseWriter, r *http.Request) {
var u string
var err error
var signedHeaders http.Header
query := r.URL.Query()
var contentLen int64
// Optionally the Content-Length header can be included with the signature
// of the request. This is helpful to ensure the content uploaded is the
// size that is expected. Constraints like these can be further expanded
// with headers such as `Content-Type`. These can be enforced by the service
// requiring the client to satisfying those constraints when uploading
//
// In addition the client could provide the service with a SHA256 of the
// content to be uploaded. This prevents any other third party from uploading
// anything else with the presigned URL
if contLenStr := query.Get("contentLength"); len(contLenStr) > 0 {
contentLen, err = strconv.ParseInt(contLenStr, 10, 64)
if err != nil {
fmt.Fprintf(os.Stderr, "unable to parse request content length, %v", err)
http.Error(w, err.Error(), http.StatusBadRequest)
return
}
}
// Extract the object key from the path
key := strings.Replace(r.URL.Path, presignPath, "", 1)
method := query.Get("method")
switch method {
case "PUT":
// For creating PutObject presigned URLs
fmt.Println("Received request to presign PutObject for,", key)
sdkReq, _ := svc.PutObjectRequest(&s3.PutObjectInput{
Bucket: aws.String(bucket),
Key: aws.String(key),
// If ContentLength is 0 the header will not be included in the signature.
ContentLength: aws.Int64(contentLen),
})
u, signedHeaders, err = sdkReq.PresignRequest(15 * time.Minute)
case "GET":
// For creating GetObject presigned URLs
fmt.Println("Received request to presign GetObject for,", key)
sdkReq, _ := svc.GetObjectRequest(&s3.GetObjectInput{
Bucket: aws.String(bucket),
Key: aws.String(key),
})
u, signedHeaders, err = sdkReq.PresignRequest(15 * time.Minute)
default:
fmt.Fprintf(os.Stderr, "invalid method provided, %s, %v\n", method, err)
err = fmt.Errorf("invalid request")
}
if err != nil {
http.Error(w, err.Error(), http.StatusBadRequest)
return
}
// Create the response back to the client with the information on the
// presigned request and additional headers to include.
if err := json.NewEncoder(w).Encode(PresignResp{
Method: method,
URL: u,
Header: signedHeaders,
}); err != nil {
fmt.Fprintf(os.Stderr, "failed to encode presign response, %v", err)
}
})
fmt.Println("Starting Server On:", "http://"+l.Addr().String())
s := &http.Server{}
return s.Serve(l)
}
// PresignResp provides the Go representation of the JSON value that will be
// sent to the client.
type PresignResp struct {
Method, URL string
Header http.Header
}
func exitError(err error) {
fmt.Fprintln(os.Stderr, err.Error())
os.Exit(1)
}

615
vendor/github.com/aws/aws-sdk-go/models/apis/athena/2017-05-18/api-2.json generated vendored Normal file
View File

@ -0,0 +1,615 @@
{
"version":"2.0",
"metadata":{
"apiVersion":"2017-05-18",
"endpointPrefix":"athena",
"jsonVersion":"1.1",
"protocol":"json",
"serviceFullName":"Amazon Athena",
"signatureVersion":"v4",
"targetPrefix":"AmazonAthena",
"uid":"athena-2017-05-18"
},
"operations":{
"BatchGetNamedQuery":{
"name":"BatchGetNamedQuery",
"http":{
"method":"POST",
"requestUri":"/"
},
"input":{"shape":"BatchGetNamedQueryInput"},
"output":{"shape":"BatchGetNamedQueryOutput"},
"errors":[
{"shape":"InternalServerException"},
{"shape":"InvalidRequestException"}
]
},
"BatchGetQueryExecution":{
"name":"BatchGetQueryExecution",
"http":{
"method":"POST",
"requestUri":"/"
},
"input":{"shape":"BatchGetQueryExecutionInput"},
"output":{"shape":"BatchGetQueryExecutionOutput"},
"errors":[
{"shape":"InternalServerException"},
{"shape":"InvalidRequestException"}
]
},
"CreateNamedQuery":{
"name":"CreateNamedQuery",
"http":{
"method":"POST",
"requestUri":"/"
},
"input":{"shape":"CreateNamedQueryInput"},
"output":{"shape":"CreateNamedQueryOutput"},
"errors":[
{"shape":"InternalServerException"},
{"shape":"InvalidRequestException"}
],
"idempotent":true
},
"DeleteNamedQuery":{
"name":"DeleteNamedQuery",
"http":{
"method":"POST",
"requestUri":"/"
},
"input":{"shape":"DeleteNamedQueryInput"},
"output":{"shape":"DeleteNamedQueryOutput"},
"errors":[
{"shape":"InternalServerException"},
{"shape":"InvalidRequestException"}
],
"idempotent":true
},
"GetNamedQuery":{
"name":"GetNamedQuery",
"http":{
"method":"POST",
"requestUri":"/"
},
"input":{"shape":"GetNamedQueryInput"},
"output":{"shape":"GetNamedQueryOutput"},
"errors":[
{"shape":"InternalServerException"},
{"shape":"InvalidRequestException"}
]
},
"GetQueryExecution":{
"name":"GetQueryExecution",
"http":{
"method":"POST",
"requestUri":"/"
},
"input":{"shape":"GetQueryExecutionInput"},
"output":{"shape":"GetQueryExecutionOutput"},
"errors":[
{"shape":"InternalServerException"},
{"shape":"InvalidRequestException"}
]
},
"GetQueryResults":{
"name":"GetQueryResults",
"http":{
"method":"POST",
"requestUri":"/"
},
"input":{"shape":"GetQueryResultsInput"},
"output":{"shape":"GetQueryResultsOutput"},
"errors":[
{"shape":"InternalServerException"},
{"shape":"InvalidRequestException"}
]
},
"ListNamedQueries":{
"name":"ListNamedQueries",
"http":{
"method":"POST",
"requestUri":"/"
},
"input":{"shape":"ListNamedQueriesInput"},
"output":{"shape":"ListNamedQueriesOutput"},
"errors":[
{"shape":"InternalServerException"},
{"shape":"InvalidRequestException"}
]
},
"ListQueryExecutions":{
"name":"ListQueryExecutions",
"http":{
"method":"POST",
"requestUri":"/"
},
"input":{"shape":"ListQueryExecutionsInput"},
"output":{"shape":"ListQueryExecutionsOutput"},
"errors":[
{"shape":"InternalServerException"},
{"shape":"InvalidRequestException"}
]
},
"StartQueryExecution":{
"name":"StartQueryExecution",
"http":{
"method":"POST",
"requestUri":"/"
},
"input":{"shape":"StartQueryExecutionInput"},
"output":{"shape":"StartQueryExecutionOutput"},
"errors":[
{"shape":"InternalServerException"},
{"shape":"InvalidRequestException"},
{"shape":"TooManyRequestsException"}
],
"idempotent":true
},
"StopQueryExecution":{
"name":"StopQueryExecution",
"http":{
"method":"POST",
"requestUri":"/"
},
"input":{"shape":"StopQueryExecutionInput"},
"output":{"shape":"StopQueryExecutionOutput"},
"errors":[
{"shape":"InternalServerException"},
{"shape":"InvalidRequestException"}
],
"idempotent":true
}
},
"shapes":{
"BatchGetNamedQueryInput":{
"type":"structure",
"required":["NamedQueryIds"],
"members":{
"NamedQueryIds":{"shape":"NamedQueryIdList"}
}
},
"BatchGetNamedQueryOutput":{
"type":"structure",
"members":{
"NamedQueries":{"shape":"NamedQueryList"},
"UnprocessedNamedQueryIds":{"shape":"UnprocessedNamedQueryIdList"}
}
},
"BatchGetQueryExecutionInput":{
"type":"structure",
"required":["QueryExecutionIds"],
"members":{
"QueryExecutionIds":{"shape":"QueryExecutionIdList"}
}
},
"BatchGetQueryExecutionOutput":{
"type":"structure",
"members":{
"QueryExecutions":{"shape":"QueryExecutionList"},
"UnprocessedQueryExecutionIds":{"shape":"UnprocessedQueryExecutionIdList"}
}
},
"Boolean":{"type":"boolean"},
"ColumnInfo":{
"type":"structure",
"required":[
"Name",
"Type"
],
"members":{
"CatalogName":{"shape":"String"},
"SchemaName":{"shape":"String"},
"TableName":{"shape":"String"},
"Name":{"shape":"String"},
"Label":{"shape":"String"},
"Type":{"shape":"String"},
"Precision":{"shape":"Integer"},
"Scale":{"shape":"Integer"},
"Nullable":{"shape":"ColumnNullable"},
"CaseSensitive":{"shape":"Boolean"}
}
},
"ColumnInfoList":{
"type":"list",
"member":{"shape":"ColumnInfo"}
},
"ColumnNullable":{
"type":"string",
"enum":[
"NOT_NULL",
"NULLABLE",
"UNKNOWN"
]
},
"CreateNamedQueryInput":{
"type":"structure",
"required":[
"Name",
"Database",
"QueryString"
],
"members":{
"Name":{"shape":"NameString"},
"Description":{"shape":"DescriptionString"},
"Database":{"shape":"DatabaseString"},
"QueryString":{"shape":"QueryString"},
"ClientRequestToken":{
"shape":"IdempotencyToken",
"idempotencyToken":true
}
}
},
"CreateNamedQueryOutput":{
"type":"structure",
"members":{
"NamedQueryId":{"shape":"NamedQueryId"}
}
},
"DatabaseString":{
"type":"string",
"max":32,
"min":1
},
"Date":{"type":"timestamp"},
"Datum":{
"type":"structure",
"members":{
"VarCharValue":{"shape":"datumString"}
}
},
"DeleteNamedQueryInput":{
"type":"structure",
"required":["NamedQueryId"],
"members":{
"NamedQueryId":{
"shape":"NamedQueryId",
"idempotencyToken":true
}
}
},
"DeleteNamedQueryOutput":{
"type":"structure",
"members":{
}
},
"DescriptionString":{
"type":"string",
"max":1024,
"min":1
},
"EncryptionConfiguration":{
"type":"structure",
"required":["EncryptionOption"],
"members":{
"EncryptionOption":{"shape":"EncryptionOption"},
"KmsKey":{"shape":"String"}
}
},
"EncryptionOption":{
"type":"string",
"enum":[
"SSE_S3",
"SSE_KMS",
"CSE_KMS"
]
},
"ErrorCode":{
"type":"string",
"max":256,
"min":1
},
"ErrorMessage":{"type":"string"},
"GetNamedQueryInput":{
"type":"structure",
"required":["NamedQueryId"],
"members":{
"NamedQueryId":{"shape":"NamedQueryId"}
}
},
"GetNamedQueryOutput":{
"type":"structure",
"members":{
"NamedQuery":{"shape":"NamedQuery"}
}
},
"GetQueryExecutionInput":{
"type":"structure",
"required":["QueryExecutionId"],
"members":{
"QueryExecutionId":{"shape":"QueryExecutionId"}
}
},
"GetQueryExecutionOutput":{
"type":"structure",
"members":{
"QueryExecution":{"shape":"QueryExecution"}
}
},
"GetQueryResultsInput":{
"type":"structure",
"required":["QueryExecutionId"],
"members":{
"QueryExecutionId":{"shape":"QueryExecutionId"},
"NextToken":{"shape":"Token"},
"MaxResults":{"shape":"MaxQueryResults"}
}
},
"GetQueryResultsOutput":{
"type":"structure",
"members":{
"ResultSet":{"shape":"ResultSet"},
"NextToken":{"shape":"Token"}
}
},
"IdempotencyToken":{
"type":"string",
"max":128,
"min":32
},
"Integer":{"type":"integer"},
"InternalServerException":{
"type":"structure",
"members":{
"Message":{"shape":"ErrorMessage"}
},
"exception":true,
"fault":true
},
"InvalidRequestException":{
"type":"structure",
"members":{
"AthenaErrorCode":{"shape":"ErrorCode"},
"Message":{"shape":"ErrorMessage"}
},
"exception":true
},
"ListNamedQueriesInput":{
"type":"structure",
"members":{
"NextToken":{"shape":"Token"},
"MaxResults":{"shape":"MaxNamedQueriesCount"}
}
},
"ListNamedQueriesOutput":{
"type":"structure",
"members":{
"NamedQueryIds":{"shape":"NamedQueryIdList"},
"NextToken":{"shape":"Token"}
}
},
"ListQueryExecutionsInput":{
"type":"structure",
"members":{
"NextToken":{"shape":"Token"},
"MaxResults":{"shape":"MaxQueryExecutionsCount"}
}
},
"ListQueryExecutionsOutput":{
"type":"structure",
"members":{
"QueryExecutionIds":{"shape":"QueryExecutionIdList"},
"NextToken":{"shape":"Token"}
}
},
"Long":{"type":"long"},
"MaxNamedQueriesCount":{
"type":"integer",
"box":true,
"max":50,
"min":0
},
"MaxQueryExecutionsCount":{
"type":"integer",
"box":true,
"max":50,
"min":0
},
"MaxQueryResults":{
"type":"integer",
"box":true,
"max":1000,
"min":0
},
"NameString":{
"type":"string",
"max":128,
"min":1
},
"NamedQuery":{
"type":"structure",
"required":[
"Name",
"Database",
"QueryString"
],
"members":{
"Name":{"shape":"NameString"},
"Description":{"shape":"DescriptionString"},
"Database":{"shape":"DatabaseString"},
"QueryString":{"shape":"QueryString"},
"NamedQueryId":{"shape":"NamedQueryId"}
}
},
"NamedQueryId":{"type":"string"},
"NamedQueryIdList":{
"type":"list",
"member":{"shape":"NamedQueryId"},
"max":50,
"min":1
},
"NamedQueryList":{
"type":"list",
"member":{"shape":"NamedQuery"}
},
"QueryExecution":{
"type":"structure",
"members":{
"QueryExecutionId":{"shape":"QueryExecutionId"},
"Query":{"shape":"QueryString"},
"ResultConfiguration":{"shape":"ResultConfiguration"},
"QueryExecutionContext":{"shape":"QueryExecutionContext"},
"Status":{"shape":"QueryExecutionStatus"},
"Statistics":{"shape":"QueryExecutionStatistics"}
}
},
"QueryExecutionContext":{
"type":"structure",
"members":{
"Database":{"shape":"DatabaseString"}
}
},
"QueryExecutionId":{"type":"string"},
"QueryExecutionIdList":{
"type":"list",
"member":{"shape":"QueryExecutionId"},
"max":50,
"min":1
},
"QueryExecutionList":{
"type":"list",
"member":{"shape":"QueryExecution"}
},
"QueryExecutionState":{
"type":"string",
"enum":[
"QUEUED",
"RUNNING",
"SUCCEEDED",
"FAILED",
"CANCELLED"
]
},
"QueryExecutionStatistics":{
"type":"structure",
"members":{
"EngineExecutionTimeInMillis":{"shape":"Long"},
"DataScannedInBytes":{"shape":"Long"}
}
},
"QueryExecutionStatus":{
"type":"structure",
"members":{
"State":{"shape":"QueryExecutionState"},
"StateChangeReason":{"shape":"String"},
"SubmissionDateTime":{"shape":"Date"},
"CompletionDateTime":{"shape":"Date"}
}
},
"QueryString":{
"type":"string",
"max":262144,
"min":1
},
"ResultConfiguration":{
"type":"structure",
"required":["OutputLocation"],
"members":{
"OutputLocation":{"shape":"String"},
"EncryptionConfiguration":{"shape":"EncryptionConfiguration"}
}
},
"ResultSet":{
"type":"structure",
"members":{
"Rows":{"shape":"RowList"},
"ResultSetMetadata":{"shape":"ResultSetMetadata"}
}
},
"ResultSetMetadata":{
"type":"structure",
"members":{
"ColumnInfo":{"shape":"ColumnInfoList"}
}
},
"Row":{
"type":"structure",
"members":{
"Data":{"shape":"datumList"}
}
},
"RowList":{
"type":"list",
"member":{"shape":"Row"}
},
"StartQueryExecutionInput":{
"type":"structure",
"required":[
"QueryString",
"ResultConfiguration"
],
"members":{
"QueryString":{"shape":"QueryString"},
"ClientRequestToken":{
"shape":"IdempotencyToken",
"idempotencyToken":true
},
"QueryExecutionContext":{"shape":"QueryExecutionContext"},
"ResultConfiguration":{"shape":"ResultConfiguration"}
}
},
"StartQueryExecutionOutput":{
"type":"structure",
"members":{
"QueryExecutionId":{"shape":"QueryExecutionId"}
}
},
"StopQueryExecutionInput":{
"type":"structure",
"required":["QueryExecutionId"],
"members":{
"QueryExecutionId":{
"shape":"QueryExecutionId",
"idempotencyToken":true
}
}
},
"StopQueryExecutionOutput":{
"type":"structure",
"members":{
}
},
"String":{"type":"string"},
"ThrottleReason":{
"type":"string",
"enum":["CONCURRENT_QUERY_LIMIT_EXCEEDED"]
},
"Token":{"type":"string"},
"TooManyRequestsException":{
"type":"structure",
"members":{
"Message":{"shape":"ErrorMessage"},
"Reason":{"shape":"ThrottleReason"}
},
"exception":true
},
"UnprocessedNamedQueryId":{
"type":"structure",
"members":{
"NamedQueryId":{"shape":"NamedQueryId"},
"ErrorCode":{"shape":"ErrorCode"},
"ErrorMessage":{"shape":"ErrorMessage"}
}
},
"UnprocessedNamedQueryIdList":{
"type":"list",
"member":{"shape":"UnprocessedNamedQueryId"}
},
"UnprocessedQueryExecutionId":{
"type":"structure",
"members":{
"QueryExecutionId":{"shape":"QueryExecutionId"},
"ErrorCode":{"shape":"ErrorCode"},
"ErrorMessage":{"shape":"ErrorMessage"}
}
},
"UnprocessedQueryExecutionIdList":{
"type":"list",
"member":{"shape":"UnprocessedQueryExecutionId"}
},
"datumList":{
"type":"list",
"member":{"shape":"Datum"}
},
"datumString":{"type":"string"}
}
}

467
vendor/github.com/aws/aws-sdk-go/models/apis/athena/2017-05-18/docs-2.json generated vendored Normal file
View File

@ -0,0 +1,467 @@
{
"version": "2.0",
"service": "<p>Amazon Athena is an interactive query service that lets you use standard SQL to analyze data directly in Amazon S3. You can point Athena at your data in Amazon S3 and run ad-hoc queries and get results in seconds. Athena is serverless, so there is no infrastructure to set up or manage. You pay only for the queries you run. Athena scales automatically—executing queries in parallel—so results are fast, even with large datasets and complex queries. For more information, see <a href=\"http://docs.aws.amazon.com/athena/latest/ug/what-is.html\">What is Amazon Athena</a> in the <i>Amazon Athena User Guide</i>.</p> <p>For code samples using the AWS SDK for Java, see <a href=\"http://docs.aws.amazon.com/athena/latest/ug/code-samples.html\">Examples and Code Samples</a> in the <i>Amazon Athena User Guide</i>.</p>",
"operations": {
"BatchGetNamedQuery": "<p>Returns the details of a single named query or a list of up to 50 queries, which you provide as an array of query ID strings. Use <a>ListNamedQueries</a> to get the list of named query IDs. If information could not be retrieved for a submitted query ID, information about the query ID submitted is listed under <a>UnprocessedNamedQueryId</a>. Named queries are different from executed queries. Use <a>BatchGetQueryExecution</a> to get details about each unique query execution, and <a>ListQueryExecutions</a> to get a list of query execution IDs.</p>",
"BatchGetQueryExecution": "<p>Returns the details of a single query execution or a list of up to 50 query executions, which you provide as an array of query execution ID strings. To get a list of query execution IDs, use <a>ListQueryExecutions</a>. Query executions are different from named (saved) queries. Use <a>BatchGetNamedQuery</a> to get details about named queries.</p>",
"CreateNamedQuery": "<p>Creates a named query.</p> <p>For code samples using the AWS SDK for Java, see <a href=\"http://docs.aws.amazon.com/athena/latest/ug/code-samples.html\">Examples and Code Samples</a> in the <i>Amazon Athena User Guide</i>.</p>",
"DeleteNamedQuery": "<p>Deletes a named query.</p> <p>For code samples using the AWS SDK for Java, see <a href=\"http://docs.aws.amazon.com/athena/latest/ug/code-samples.html\">Examples and Code Samples</a> in the <i>Amazon Athena User Guide</i>.</p>",
"GetNamedQuery": "<p>Returns information about a single query.</p>",
"GetQueryExecution": "<p>Returns information about a single execution of a query. Each time a query executes, information about the query execution is saved with a unique ID.</p>",
"GetQueryResults": "<p>Returns the results of a single query execution specified by <code>QueryExecutionId</code>. This request does not execute the query but returns results. Use <a>StartQueryExecution</a> to run a query.</p>",
"ListNamedQueries": "<p>Provides a list of all available query IDs.</p> <p>For code samples using the AWS SDK for Java, see <a href=\"http://docs.aws.amazon.com/athena/latest/ug/code-samples.html\">Examples and Code Samples</a> in the <i>Amazon Athena User Guide</i>.</p>",
"ListQueryExecutions": "<p>Provides a list of all available query execution IDs.</p> <p>For code samples using the AWS SDK for Java, see <a href=\"http://docs.aws.amazon.com/athena/latest/ug/code-samples.html\">Examples and Code Samples</a> in the <i>Amazon Athena User Guide</i>.</p>",
"StartQueryExecution": "<p>Runs (executes) the SQL query statements contained in the <code>Query</code> string.</p> <p>For code samples using the AWS SDK for Java, see <a href=\"http://docs.aws.amazon.com/athena/latest/ug/code-samples.html\">Examples and Code Samples</a> in the <i>Amazon Athena User Guide</i>.</p>",
"StopQueryExecution": "<p>Stops a query execution.</p> <p>For code samples using the AWS SDK for Java, see <a href=\"http://docs.aws.amazon.com/athena/latest/ug/code-samples.html\">Examples and Code Samples</a> in the <i>Amazon Athena User Guide</i>.</p>"
},
"shapes": {
"BatchGetNamedQueryInput": {
"base": null,
"refs": {
}
},
"BatchGetNamedQueryOutput": {
"base": null,
"refs": {
}
},
"BatchGetQueryExecutionInput": {
"base": null,
"refs": {
}
},
"BatchGetQueryExecutionOutput": {
"base": null,
"refs": {
}
},
"Boolean": {
"base": null,
"refs": {
"ColumnInfo$CaseSensitive": "<p>Indicates whether values in the column are case-sensitive.</p>"
}
},
"ColumnInfo": {
"base": "<p>Information about the columns in a query execution result.</p>",
"refs": {
"ColumnInfoList$member": null
}
},
"ColumnInfoList": {
"base": null,
"refs": {
"ResultSetMetadata$ColumnInfo": "<p>Information about the columns in a query execution result.</p>"
}
},
"ColumnNullable": {
"base": null,
"refs": {
"ColumnInfo$Nullable": "<p>Indicates the column's nullable status.</p>"
}
},
"CreateNamedQueryInput": {
"base": null,
"refs": {
}
},
"CreateNamedQueryOutput": {
"base": null,
"refs": {
}
},
"DatabaseString": {
"base": null,
"refs": {
"CreateNamedQueryInput$Database": "<p>The database to which the query belongs.</p>",
"NamedQuery$Database": "<p>The database to which the query belongs.</p>",
"QueryExecutionContext$Database": "<p>The name of the database.</p>"
}
},
"Date": {
"base": null,
"refs": {
"QueryExecutionStatus$SubmissionDateTime": "<p>The date and time that the query was submitted.</p>",
"QueryExecutionStatus$CompletionDateTime": "<p>The date and time that the query completed.</p>"
}
},
"Datum": {
"base": "<p>A piece of data (a field in the table).</p>",
"refs": {
"datumList$member": null
}
},
"DeleteNamedQueryInput": {
"base": null,
"refs": {
}
},
"DeleteNamedQueryOutput": {
"base": null,
"refs": {
}
},
"DescriptionString": {
"base": null,
"refs": {
"CreateNamedQueryInput$Description": "<p>A brief explanation of the query.</p>",
"NamedQuery$Description": "<p>A brief description of the query.</p>"
}
},
"EncryptionConfiguration": {
"base": "<p>If query results are encrypted in Amazon S3, indicates the Amazon S3 encryption option used.</p>",
"refs": {
"ResultConfiguration$EncryptionConfiguration": "<p>If query results are encrypted in S3, indicates the S3 encryption option used (for example, <code>SSE-KMS</code> or <code>CSE-KMS</code> and key information.</p>"
}
},
"EncryptionOption": {
"base": null,
"refs": {
"EncryptionConfiguration$EncryptionOption": "<p>Indicates whether Amazon S3 server-side encryption with Amazon S3-managed keys (<code>SSE-S3</code>), server-side encryption with KMS-managed keys (<code>SSE-KMS</code>), or client-side encryption with KMS-managed keys (CSE-KMS) is used.</p>"
}
},
"ErrorCode": {
"base": null,
"refs": {
"InvalidRequestException$AthenaErrorCode": null,
"UnprocessedNamedQueryId$ErrorCode": "<p>The error code returned when the processing request for the named query failed, if applicable.</p>",
"UnprocessedQueryExecutionId$ErrorCode": "<p>The error code returned when the query execution failed to process, if applicable.</p>"
}
},
"ErrorMessage": {
"base": null,
"refs": {
"InternalServerException$Message": null,
"InvalidRequestException$Message": null,
"TooManyRequestsException$Message": null,
"UnprocessedNamedQueryId$ErrorMessage": "<p>The error message returned when the processing request for the named query failed, if applicable.</p>",
"UnprocessedQueryExecutionId$ErrorMessage": "<p>The error message returned when the query execution failed to process, if applicable.</p>"
}
},
"GetNamedQueryInput": {
"base": null,
"refs": {
}
},
"GetNamedQueryOutput": {
"base": null,
"refs": {
}
},
"GetQueryExecutionInput": {
"base": null,
"refs": {
}
},
"GetQueryExecutionOutput": {
"base": null,
"refs": {
}
},
"GetQueryResultsInput": {
"base": null,
"refs": {
}
},
"GetQueryResultsOutput": {
"base": null,
"refs": {
}
},
"IdempotencyToken": {
"base": null,
"refs": {
"CreateNamedQueryInput$ClientRequestToken": "<p>A unique case-sensitive string used to ensure the request to create the query is idempotent (executes only once). If another <code>CreateNamedQuery</code> request is received, the same response is returned and another query is not created. If a parameter has changed, for example, the <code>QueryString</code>, an error is returned.</p> <important> <p>This token is listed as not required because AWS SDKs (for example the AWS SDK for Java) auto-generate the token for users. If you are not using the AWS SDK or the AWS CLI, you must provide this token or the action will fail.</p> </important>",
"StartQueryExecutionInput$ClientRequestToken": "<p>A unique case-sensitive string used to ensure the request to create the query is idempotent (executes only once). If another <code>StartQueryExecution</code> request is received, the same response is returned and another query is not created. If a parameter has changed, for example, the <code>QueryString</code>, an error is returned.</p> <important> <p>This token is listed as not required because AWS SDKs (for example the AWS SDK for Java) auto-generate the token for users. If you are not using the AWS SDK or the AWS CLI, you must provide this token or the action will fail.</p> </important>"
}
},
"Integer": {
"base": null,
"refs": {
"ColumnInfo$Precision": "<p>For <code>DECIMAL</code> data types, specifies the total number of digits, up to 38. For performance reasons, we recommend up to 18 digits.</p>",
"ColumnInfo$Scale": "<p>For <code>DECIMAL</code> data types, specifies the total number of digits in the fractional part of the value. Defaults to 0.</p>"
}
},
"InternalServerException": {
"base": "<p>Indicates a platform issue, which may be due to a transient condition or outage.</p>",
"refs": {
}
},
"InvalidRequestException": {
"base": "<p>Indicates that something is wrong with the input to the request. For example, a required parameter may be missing or out of range.</p>",
"refs": {
}
},
"ListNamedQueriesInput": {
"base": null,
"refs": {
}
},
"ListNamedQueriesOutput": {
"base": null,
"refs": {
}
},
"ListQueryExecutionsInput": {
"base": null,
"refs": {
}
},
"ListQueryExecutionsOutput": {
"base": null,
"refs": {
}
},
"Long": {
"base": null,
"refs": {
"QueryExecutionStatistics$EngineExecutionTimeInMillis": "<p>The number of milliseconds that the query took to execute.</p>",
"QueryExecutionStatistics$DataScannedInBytes": "<p>The number of bytes in the data that was queried.</p>"
}
},
"MaxNamedQueriesCount": {
"base": null,
"refs": {
"ListNamedQueriesInput$MaxResults": "<p>The maximum number of queries to return in this request.</p>"
}
},
"MaxQueryExecutionsCount": {
"base": null,
"refs": {
"ListQueryExecutionsInput$MaxResults": "<p>The maximum number of query executions to return in this request.</p>"
}
},
"MaxQueryResults": {
"base": null,
"refs": {
"GetQueryResultsInput$MaxResults": "<p>The maximum number of results (rows) to return in this request.</p>"
}
},
"NameString": {
"base": null,
"refs": {
"CreateNamedQueryInput$Name": "<p>The plain language name for the query.</p>",
"NamedQuery$Name": "<p>The plain-language name of the query.</p>"
}
},
"NamedQuery": {
"base": "<p>A query, where <code>QueryString</code> is the SQL query statements that comprise the query.</p>",
"refs": {
"GetNamedQueryOutput$NamedQuery": "<p>Information about the query.</p>",
"NamedQueryList$member": null
}
},
"NamedQueryId": {
"base": null,
"refs": {
"CreateNamedQueryOutput$NamedQueryId": "<p>The unique ID of the query.</p>",
"DeleteNamedQueryInput$NamedQueryId": "<p>The unique ID of the query to delete.</p>",
"GetNamedQueryInput$NamedQueryId": "<p>The unique ID of the query. Use <a>ListNamedQueries</a> to get query IDs.</p>",
"NamedQuery$NamedQueryId": "<p>The unique identifier of the query.</p>",
"NamedQueryIdList$member": null,
"UnprocessedNamedQueryId$NamedQueryId": "<p>The unique identifier of the named query.</p>"
}
},
"NamedQueryIdList": {
"base": null,
"refs": {
"BatchGetNamedQueryInput$NamedQueryIds": "<p>An array of query IDs.</p>",
"ListNamedQueriesOutput$NamedQueryIds": "<p>The list of unique query IDs.</p>"
}
},
"NamedQueryList": {
"base": null,
"refs": {
"BatchGetNamedQueryOutput$NamedQueries": "<p>Information about the named query IDs submitted.</p>"
}
},
"QueryExecution": {
"base": "<p>Information about a single instance of a query execution.</p>",
"refs": {
"GetQueryExecutionOutput$QueryExecution": "<p>Information about the query execution.</p>",
"QueryExecutionList$member": null
}
},
"QueryExecutionContext": {
"base": "<p>The database in which the query execution occurs.</p>",
"refs": {
"QueryExecution$QueryExecutionContext": "<p>The database in which the query execution occurred.</p>",
"StartQueryExecutionInput$QueryExecutionContext": "<p>The database within which the query executes.</p>"
}
},
"QueryExecutionId": {
"base": null,
"refs": {
"GetQueryExecutionInput$QueryExecutionId": "<p>The unique ID of the query execution.</p>",
"GetQueryResultsInput$QueryExecutionId": "<p>The unique ID of the query execution.</p>",
"QueryExecution$QueryExecutionId": "<p>The unique identifier for each query execution.</p>",
"QueryExecutionIdList$member": null,
"StartQueryExecutionOutput$QueryExecutionId": "<p>The unique ID of the query that ran as a result of this request.</p>",
"StopQueryExecutionInput$QueryExecutionId": "<p>The unique ID of the query execution to stop.</p>",
"UnprocessedQueryExecutionId$QueryExecutionId": "<p>The unique identifier of the query execution.</p>"
}
},
"QueryExecutionIdList": {
"base": null,
"refs": {
"BatchGetQueryExecutionInput$QueryExecutionIds": "<p>An array of query execution IDs.</p>",
"ListQueryExecutionsOutput$QueryExecutionIds": "<p>The unique IDs of each query execution as an array of strings.</p>"
}
},
"QueryExecutionList": {
"base": null,
"refs": {
"BatchGetQueryExecutionOutput$QueryExecutions": "<p>Information about a query execution.</p>"
}
},
"QueryExecutionState": {
"base": null,
"refs": {
"QueryExecutionStatus$State": "<p>The state of query execution. <code>SUBMITTED</code> indicates that the query is queued for execution. <code>RUNNING</code> indicates that the query is scanning data and returning results. <code>SUCCEEDED</code> indicates that the query completed without error. <code>FAILED</code> indicates that the query experienced an error and did not complete processing. <code>CANCELLED</code> indicates that user input interrupted query execution.</p>"
}
},
"QueryExecutionStatistics": {
"base": "<p>The amount of data scanned during the query execution and the amount of time that it took to execute.</p>",
"refs": {
"QueryExecution$Statistics": "<p>The amount of data scanned during the query execution and the amount of time that it took to execute.</p>"
}
},
"QueryExecutionStatus": {
"base": "<p>The completion date, current state, submission time, and state change reason (if applicable) for the query execution.</p>",
"refs": {
"QueryExecution$Status": "<p>The completion date, current state, submission time, and state change reason (if applicable) for the query execution.</p>"
}
},
"QueryString": {
"base": null,
"refs": {
"CreateNamedQueryInput$QueryString": "<p>The text of the query itself. In other words, all query statements.</p>",
"NamedQuery$QueryString": "<p>The SQL query statements that comprise the query.</p>",
"QueryExecution$Query": "<p>The SQL query statements which the query execution ran.</p>",
"StartQueryExecutionInput$QueryString": "<p>The SQL query statements to be executed.</p>"
}
},
"ResultConfiguration": {
"base": "<p>The location in Amazon S3 where query results are stored and the encryption option, if any, used for query results.</p>",
"refs": {
"QueryExecution$ResultConfiguration": "<p>The location in Amazon S3 where query results were stored and the encryption option, if any, used for query results.</p>",
"StartQueryExecutionInput$ResultConfiguration": "<p>Specifies information about where and how to save the results of the query execution.</p>"
}
},
"ResultSet": {
"base": "<p>The metadata and rows that comprise a query result set. The metadata describes the column structure and data types.</p>",
"refs": {
"GetQueryResultsOutput$ResultSet": "<p>The results of the query execution.</p>"
}
},
"ResultSetMetadata": {
"base": "<p>The metadata that describes the column structure and data types of a table of query results.</p>",
"refs": {
"ResultSet$ResultSetMetadata": "<p>The metadata that describes the column structure and data types of a table of query results.</p>"
}
},
"Row": {
"base": "<p>The rows that comprise a query result table.</p>",
"refs": {
"RowList$member": null
}
},
"RowList": {
"base": null,
"refs": {
"ResultSet$Rows": "<p>The rows in the table.</p>"
}
},
"StartQueryExecutionInput": {
"base": null,
"refs": {
}
},
"StartQueryExecutionOutput": {
"base": null,
"refs": {
}
},
"StopQueryExecutionInput": {
"base": null,
"refs": {
}
},
"StopQueryExecutionOutput": {
"base": null,
"refs": {
}
},
"String": {
"base": null,
"refs": {
"ColumnInfo$CatalogName": "<p>The catalog to which the query results belong.</p>",
"ColumnInfo$SchemaName": "<p>The schema name (database name) to which the query results belong.</p>",
"ColumnInfo$TableName": "<p>The table name for the query results.</p>",
"ColumnInfo$Name": "<p>The name of the column.</p>",
"ColumnInfo$Label": "<p>A column label.</p>",
"ColumnInfo$Type": "<p>The data type of the column.</p>",
"EncryptionConfiguration$KmsKey": "<p>For <code>SSE-KMS</code> and <code>CSE-KMS</code>, this is the KMS key ARN or ID.</p>",
"QueryExecutionStatus$StateChangeReason": "<p>Further detail about the status of the query.</p>",
"ResultConfiguration$OutputLocation": "<p>The location in S3 where query results are stored.</p>"
}
},
"ThrottleReason": {
"base": null,
"refs": {
"TooManyRequestsException$Reason": null
}
},
"Token": {
"base": null,
"refs": {
"GetQueryResultsInput$NextToken": "<p>The token that specifies where to start pagination if a previous request was truncated.</p>",
"GetQueryResultsOutput$NextToken": "<p>A token to be used by the next request if this request is truncated.</p>",
"ListNamedQueriesInput$NextToken": "<p>The token that specifies where to start pagination if a previous request was truncated.</p>",
"ListNamedQueriesOutput$NextToken": "<p>A token to be used by the next request if this request is truncated.</p>",
"ListQueryExecutionsInput$NextToken": "<p>The token that specifies where to start pagination if a previous request was truncated.</p>",
"ListQueryExecutionsOutput$NextToken": "<p>A token to be used by the next request if this request is truncated.</p>"
}
},
"TooManyRequestsException": {
"base": "<p>Indicates that the request was throttled.</p>",
"refs": {
}
},
"UnprocessedNamedQueryId": {
"base": "<p>Information about a named query ID that could not be processed.</p>",
"refs": {
"UnprocessedNamedQueryIdList$member": null
}
},
"UnprocessedNamedQueryIdList": {
"base": null,
"refs": {
"BatchGetNamedQueryOutput$UnprocessedNamedQueryIds": "<p>Information about provided query IDs.</p>"
}
},
"UnprocessedQueryExecutionId": {
"base": "<p>Describes a query execution that failed to process.</p>",
"refs": {
"UnprocessedQueryExecutionIdList$member": null
}
},
"UnprocessedQueryExecutionIdList": {
"base": null,
"refs": {
"BatchGetQueryExecutionOutput$UnprocessedQueryExecutionIds": "<p>Information about the query executions that failed to run.</p>"
}
},
"datumList": {
"base": null,
"refs": {
"Row$Data": "<p>The data that populates a row in a query result table.</p>"
}
},
"datumString": {
"base": null,
"refs": {
"Datum$VarCharValue": "<p>The value of the datum.</p>"
}
}
}
}

5
vendor/github.com/aws/aws-sdk-go/models/apis/athena/2017-05-18/examples-1.json generated vendored Normal file
View File

@ -0,0 +1,5 @@
{
"version": "1.0",
"examples": {
}
}

19
vendor/github.com/aws/aws-sdk-go/models/apis/athena/2017-05-18/paginators-1.json generated vendored Normal file
View File

@ -0,0 +1,19 @@
{
"pagination": {
"GetQueryResults": {
"input_token": "NextToken",
"output_token": "NextToken",
"limit_key": "MaxResults"
},
"ListNamedQueries": {
"input_token": "NextToken",
"output_token": "NextToken",
"limit_key": "MaxResults"
},
"ListQueryExecutions": {
"input_token": "NextToken",
"output_token": "NextToken",
"limit_key": "MaxResults"
}
}
}

204
vendor/github.com/aws/aws-sdk-go/models/apis/autoscaling/2011-01-01/docs-2.json generated vendored
View File

@ -2,9 +2,9 @@
"version": "2.0",
"service": "<fullname>Auto Scaling</fullname> <p>Auto Scaling is designed to automatically launch or terminate EC2 instances based on user-defined policies, schedules, and health checks. Use this service in conjunction with the Amazon CloudWatch and Elastic Load Balancing services.</p>",
"operations": {
"AttachInstances": "<p>Attaches one or more EC2 instances to the specified Auto Scaling group.</p> <p>When you attach instances, Auto Scaling increases the desired capacity of the group by the number of instances being attached. If the number of instances being attached plus the desired capacity of the group exceeds the maximum size of the group, the operation fails.</p> <p>If there is a Classic load balancer attached to your Auto Scaling group, the instances are also registered with the load balancer. If there are target groups attached to your Auto Scaling group, the instances are also registered with the target groups.</p> <p>For more information, see <a href=\"http://docs.aws.amazon.com/autoscaling/latest/userguide/attach-instance-asg.html\">Attach EC2 Instances to Your Auto Scaling Group</a> in the <i>Auto Scaling User Guide</i>.</p>",
"AttachInstances": "<p>Attaches one or more EC2 instances to the specified Auto Scaling group.</p> <p>When you attach instances, Auto Scaling increases the desired capacity of the group by the number of instances being attached. If the number of instances being attached plus the desired capacity of the group exceeds the maximum size of the group, the operation fails.</p> <p>If there is a Classic Load Balancer attached to your Auto Scaling group, the instances are also registered with the load balancer. If there are target groups attached to your Auto Scaling group, the instances are also registered with the target groups.</p> <p>For more information, see <a href=\"http://docs.aws.amazon.com/autoscaling/latest/userguide/attach-instance-asg.html\">Attach EC2 Instances to Your Auto Scaling Group</a> in the <i>Auto Scaling User Guide</i>.</p>",
"AttachLoadBalancerTargetGroups": "<p>Attaches one or more target groups to the specified Auto Scaling group.</p> <p>To describe the target groups for an Auto Scaling group, use <a>DescribeLoadBalancerTargetGroups</a>. To detach the target group from the Auto Scaling group, use <a>DetachLoadBalancerTargetGroups</a>.</p> <p>For more information, see <a href=\"http://docs.aws.amazon.com/autoscaling/latest/userguide/attach-load-balancer-asg.html\">Attach a Load Balancer to Your Auto Scaling Group</a> in the <i>Auto Scaling User Guide</i>.</p>",
"AttachLoadBalancers": "<p>Attaches one or more Classic load balancers to the specified Auto Scaling group.</p> <p>To attach an Application load balancer instead, see <a>AttachLoadBalancerTargetGroups</a>.</p> <p>To describe the load balancers for an Auto Scaling group, use <a>DescribeLoadBalancers</a>. To detach the load balancer from the Auto Scaling group, use <a>DetachLoadBalancers</a>.</p> <p>For more information, see <a href=\"http://docs.aws.amazon.com/autoscaling/latest/userguide/attach-load-balancer-asg.html\">Attach a Load Balancer to Your Auto Scaling Group</a> in the <i>Auto Scaling User Guide</i>.</p>",
"AttachLoadBalancers": "<p>Attaches one or more Classic Load Balancers to the specified Auto Scaling group.</p> <p>To attach an Application Load Balancer instead, see <a>AttachLoadBalancerTargetGroups</a>.</p> <p>To describe the load balancers for an Auto Scaling group, use <a>DescribeLoadBalancers</a>. To detach the load balancer from the Auto Scaling group, use <a>DetachLoadBalancers</a>.</p> <p>For more information, see <a href=\"http://docs.aws.amazon.com/autoscaling/latest/userguide/attach-load-balancer-asg.html\">Attach a Load Balancer to Your Auto Scaling Group</a> in the <i>Auto Scaling User Guide</i>.</p>",
"CompleteLifecycleAction": "<p>Completes the lifecycle action for the specified token or instance with the specified result.</p> <p>This step is a part of the procedure for adding a lifecycle hook to an Auto Scaling group:</p> <ol> <li> <p>(Optional) Create a Lambda function and a rule that allows CloudWatch Events to invoke your Lambda function when Auto Scaling launches or terminates instances.</p> </li> <li> <p>(Optional) Create a notification target and an IAM role. The target can be either an Amazon SQS queue or an Amazon SNS topic. The role allows Auto Scaling to publish lifecycle notifications to the target.</p> </li> <li> <p>Create the lifecycle hook. Specify whether the hook is used when the instances launch or terminate.</p> </li> <li> <p>If you need more time, record the lifecycle action heartbeat to keep the instance in a pending state.</p> </li> <li> <p> <b>If you finish before the timeout period ends, complete the lifecycle action.</b> </p> </li> </ol> <p>For more information, see <a href=\"http://docs.aws.amazon.com/autoscaling/latest/userguide/AutoScalingGroupLifecycle.html\">Auto Scaling Lifecycle</a> in the <i>Auto Scaling User Guide</i>.</p>",
"CreateAutoScalingGroup": "<p>Creates an Auto Scaling group with the specified name and attributes.</p> <p>If you exceed your maximum limit of Auto Scaling groups, which by default is 20 per region, the call fails. For information about viewing and updating this limit, see <a>DescribeAccountLimits</a>.</p> <p>For more information, see <a href=\"http://docs.aws.amazon.com/autoscaling/latest/userguide/AutoScalingGroup.html\">Auto Scaling Groups</a> in the <i>Auto Scaling User Guide</i>.</p>",
"CreateLaunchConfiguration": "<p>Creates a launch configuration.</p> <p>If you exceed your maximum limit of launch configurations, which by default is 100 per region, the call fails. For information about viewing and updating this limit, see <a>DescribeAccountLimits</a>.</p> <p>For more information, see <a href=\"http://docs.aws.amazon.com/autoscaling/latest/userguide/LaunchConfiguration.html\">Launch Configurations</a> in the <i>Auto Scaling User Guide</i>.</p>",
@ -25,7 +25,7 @@
"DescribeLifecycleHookTypes": "<p>Describes the available types of lifecycle hooks.</p>",
"DescribeLifecycleHooks": "<p>Describes the lifecycle hooks for the specified Auto Scaling group.</p>",
"DescribeLoadBalancerTargetGroups": "<p>Describes the target groups for the specified Auto Scaling group.</p>",
"DescribeLoadBalancers": "<p>Describes the load balancers for the specified Auto Scaling group.</p> <p>Note that this operation describes only Classic load balancers. If you have Application load balancers, use <a>DescribeLoadBalancerTargetGroups</a> instead.</p>",
"DescribeLoadBalancers": "<p>Describes the load balancers for the specified Auto Scaling group.</p> <p>Note that this operation describes only Classic Load Balancers. If you have Application Load Balancers, use <a>DescribeLoadBalancerTargetGroups</a> instead.</p>",
"DescribeMetricCollectionTypes": "<p>Describes the available CloudWatch metrics for Auto Scaling.</p> <p>Note that the <code>GroupStandbyInstances</code> metric is not returned by default. You must explicitly request this metric when calling <a>EnableMetricsCollection</a>.</p>",
"DescribeNotificationConfigurations": "<p>Describes the notification actions associated with the specified Auto Scaling group.</p>",
"DescribePolicies": "<p>Describes the policies for the specified Auto Scaling group.</p>",
@ -34,14 +34,14 @@
"DescribeScheduledActions": "<p>Describes the actions scheduled for your Auto Scaling group that haven't run. To describe the actions that have already run, use <a>DescribeScalingActivities</a>.</p>",
"DescribeTags": "<p>Describes the specified tags.</p> <p>You can use filters to limit the results. For example, you can query for the tags for a specific Auto Scaling group. You can specify multiple values for a filter. A tag must match at least one of the specified values for it to be included in the results.</p> <p>You can also specify multiple filters. The result includes information for a particular tag only if it matches all the filters. If there's no match, no special message is returned.</p>",
"DescribeTerminationPolicyTypes": "<p>Describes the termination policies supported by Auto Scaling.</p>",
"DetachInstances": "<p>Removes one or more instances from the specified Auto Scaling group.</p> <p>After the instances are detached, you can manage them independently from the rest of the Auto Scaling group.</p> <p>If you do not specify the option to decrement the desired capacity, Auto Scaling launches instances to replace the ones that are detached.</p> <p>If there is a Classic load balancer attached to the Auto Scaling group, the instances are deregistered from the load balancer. If there are target groups attached to the Auto Scaling group, the instances are deregistered from the target groups.</p> <p>For more information, see <a href=\"http://docs.aws.amazon.com/autoscaling/latest/userguide/detach-instance-asg.html\">Detach EC2 Instances from Your Auto Scaling Group</a> in the <i>Auto Scaling User Guide</i>.</p>",
"DetachInstances": "<p>Removes one or more instances from the specified Auto Scaling group.</p> <p>After the instances are detached, you can manage them independent of the Auto Scaling group.</p> <p>If you do not specify the option to decrement the desired capacity, Auto Scaling launches instances to replace the ones that are detached.</p> <p>If there is a Classic Load Balancer attached to the Auto Scaling group, the instances are deregistered from the load balancer. If there are target groups attached to the Auto Scaling group, the instances are deregistered from the target groups.</p> <p>For more information, see <a href=\"http://docs.aws.amazon.com/autoscaling/latest/userguide/detach-instance-asg.html\">Detach EC2 Instances from Your Auto Scaling Group</a> in the <i>Auto Scaling User Guide</i>.</p>",
"DetachLoadBalancerTargetGroups": "<p>Detaches one or more target groups from the specified Auto Scaling group.</p>",
"DetachLoadBalancers": "<p>Detaches one or more Classic load balancers from the specified Auto Scaling group.</p> <p>Note that this operation detaches only Classic load balancers. If you have Application load balancers, use <a>DetachLoadBalancerTargetGroups</a> instead.</p> <p>When you detach a load balancer, it enters the <code>Removing</code> state while deregistering the instances in the group. When all instances are deregistered, then you can no longer describe the load balancer using <a>DescribeLoadBalancers</a>. Note that the instances remain running.</p>",
"DetachLoadBalancers": "<p>Detaches one or more Classic Load Balancers from the specified Auto Scaling group.</p> <p>Note that this operation detaches only Classic Load Balancers. If you have Application Load Balancers, use <a>DetachLoadBalancerTargetGroups</a> instead.</p> <p>When you detach a load balancer, it enters the <code>Removing</code> state while deregistering the instances in the group. When all instances are deregistered, then you can no longer describe the load balancer using <a>DescribeLoadBalancers</a>. Note that the instances remain running.</p>",
"DisableMetricsCollection": "<p>Disables group metrics for the specified Auto Scaling group.</p>",
"EnableMetricsCollection": "<p>Enables group metrics for the specified Auto Scaling group. For more information, see <a href=\"http://docs.aws.amazon.com/autoscaling/latest/userguide/as-instance-monitoring.html\">Monitoring Your Auto Scaling Groups and Instances</a> in the <i>Auto Scaling User Guide</i>.</p>",
"EnterStandby": "<p>Moves the specified instances into <code>Standby</code> mode.</p> <p>For more information, see <a href=\"http://docs.aws.amazon.com/autoscaling/latest/userguide/AutoScalingGroupLifecycle.html\">Auto Scaling Lifecycle</a> in the <i>Auto Scaling User Guide</i>.</p>",
"EnterStandby": "<p>Moves the specified instances into the standby state.</p> <p>For more information, see <a href=\"http://docs.aws.amazon.com/autoscaling/latest/userguide/as-enter-exit-standby.html\">Temporarily Removing Instances from Your Auto Scaling Group</a> in the <i>Auto Scaling User Guide</i>.</p>",
"ExecutePolicy": "<p>Executes the specified policy.</p>",
"ExitStandby": "<p>Moves the specified instances out of <code>Standby</code> mode.</p> <p>For more information, see <a href=\"http://docs.aws.amazon.com/autoscaling/latest/userguide/AutoScalingGroupLifecycle.html\">Auto Scaling Lifecycle</a> in the <i>Auto Scaling User Guide</i>.</p>",
"ExitStandby": "<p>Moves the specified instances out of the standby state.</p> <p>For more information, see <a href=\"http://docs.aws.amazon.com/autoscaling/latest/userguide/as-enter-exit-standby.html\">Temporarily Removing Instances from Your Auto Scaling Group</a> in the <i>Auto Scaling User Guide</i>.</p>",
"PutLifecycleHook": "<p>Creates or updates a lifecycle hook for the specified Auto Scaling Group.</p> <p>A lifecycle hook tells Auto Scaling that you want to perform an action on an instance that is not actively in service; for example, either when the instance launches or before the instance terminates.</p> <p>This step is a part of the procedure for adding a lifecycle hook to an Auto Scaling group:</p> <ol> <li> <p>(Optional) Create a Lambda function and a rule that allows CloudWatch Events to invoke your Lambda function when Auto Scaling launches or terminates instances.</p> </li> <li> <p>(Optional) Create a notification target and an IAM role. The target can be either an Amazon SQS queue or an Amazon SNS topic. The role allows Auto Scaling to publish lifecycle notifications to the target.</p> </li> <li> <p> <b>Create the lifecycle hook. Specify whether the hook is used when the instances launch or terminate.</b> </p> </li> <li> <p>If you need more time, record the lifecycle action heartbeat to keep the instance in a pending state.</p> </li> <li> <p>If you finish before the timeout period ends, complete the lifecycle action.</p> </li> </ol> <p>For more information, see <a href=\"http://docs.aws.amazon.com/autoscaling/latest/userguide/lifecycle-hooks.html\">Auto Scaling Lifecycle Hooks</a> in the <i>Auto Scaling User Guide</i>.</p> <p>If you exceed your maximum limit of lifecycle hooks, which by default is 50 per Auto Scaling group, the call fails. For information about updating this limit, see <a href=\"http://docs.aws.amazon.com/general/latest/gr/aws_service_limits.html\">AWS Service Limits</a> in the <i>Amazon Web Services General Reference</i>.</p>",
"PutNotificationConfiguration": "<p>Configures an Auto Scaling group to send notifications when specified events take place. Subscribers to the specified topic can have messages delivered to an endpoint such as a web server or an email address.</p> <p>This configuration overwrites any existing configuration.</p> <p>For more information see <a href=\"http://docs.aws.amazon.com/autoscaling/latest/userguide/ASGettingNotifications.html\">Getting SNS Notifications When Your Auto Scaling Group Scales</a> in the <i>Auto Scaling User Guide</i>.</p>",
"PutScalingPolicy": "<p>Creates or updates a policy for an Auto Scaling group. To update an existing policy, use the existing policy name and set the parameters you want to change. Any existing parameter not changed in an update to an existing policy is not changed in this update request.</p> <p>If you exceed your maximum limit of step adjustments, which by default is 20 per region, the call fails. For information about updating this limit, see <a href=\"http://docs.aws.amazon.com/general/latest/gr/aws_service_limits.html\">AWS Service Limits</a> in the <i>Amazon Web Services General Reference</i>.</p>",
@ -53,7 +53,7 @@
"SetInstanceProtection": "<p>Updates the instance protection settings of the specified instances.</p> <p>For more information, see <a href=\"http://docs.aws.amazon.com/autoscaling/latest/userguide/as-instance-termination.html#instance-protection\">Instance Protection</a> in the <i>Auto Scaling User Guide</i>.</p>",
"SuspendProcesses": "<p>Suspends the specified Auto Scaling processes, or all processes, for the specified Auto Scaling group.</p> <p>Note that if you suspend either the <code>Launch</code> or <code>Terminate</code> process types, it can prevent other process types from functioning properly.</p> <p>To resume processes that have been suspended, use <a>ResumeProcesses</a>.</p> <p>For more information, see <a href=\"http://docs.aws.amazon.com/autoscaling/latest/userguide/as-suspend-resume-processes.html\">Suspending and Resuming Auto Scaling Processes</a> in the <i>Auto Scaling User Guide</i>.</p>",
"TerminateInstanceInAutoScalingGroup": "<p>Terminates the specified instance and optionally adjusts the desired group size.</p> <p>This call simply makes a termination request. The instance is not terminated immediately.</p>",
"UpdateAutoScalingGroup": "<p>Updates the configuration for the specified Auto Scaling group.</p> <p>To update an Auto Scaling group with a launch configuration with <code>InstanceMonitoring</code> set to <code>False</code>, you must first disable the collection of group metrics. Otherwise, you will get an error. If you have previously enabled the collection of group metrics, you can disable it using <a>DisableMetricsCollection</a>.</p> <p>The new settings are registered upon the completion of this call. Any launch configuration settings take effect on any triggers after this call returns. Scaling activities that are currently in progress aren't affected.</p> <p>Note the following:</p> <ul> <li> <p>If you specify a new value for <code>MinSize</code> without specifying a value for <code>DesiredCapacity</code>, and the new <code>MinSize</code> is larger than the current size of the group, we implicitly call <a>SetDesiredCapacity</a> to set the size of the group to the new value of <code>MinSize</code>.</p> </li> <li> <p>If you specify a new value for <code>MaxSize</code> without specifying a value for <code>DesiredCapacity</code>, and the new <code>MaxSize</code> is smaller than the current size of the group, we implicitly call <a>SetDesiredCapacity</a> to set the size of the group to the new value of <code>MaxSize</code>.</p> </li> <li> <p>All other optional parameters are left unchanged if not specified.</p> </li> </ul>"
"UpdateAutoScalingGroup": "<p>Updates the configuration for the specified Auto Scaling group.</p> <p>The new settings take effect on any scaling activities after this call returns. Scaling activities that are currently in progress aren't affected.</p> <p>To update an Auto Scaling group with a launch configuration with <code>InstanceMonitoring</code> set to <code>false</code>, you must first disable the collection of group metrics. Otherwise, you will get an error. If you have previously enabled the collection of group metrics, you can disable it using <a>DisableMetricsCollection</a>.</p> <p>Note the following:</p> <ul> <li> <p>If you specify a new value for <code>MinSize</code> without specifying a value for <code>DesiredCapacity</code>, and the new <code>MinSize</code> is larger than the current size of the group, we implicitly call <a>SetDesiredCapacity</a> to set the size of the group to the new value of <code>MinSize</code>.</p> </li> <li> <p>If you specify a new value for <code>MaxSize</code> without specifying a value for <code>DesiredCapacity</code>, and the new <code>MaxSize</code> is smaller than the current size of the group, we implicitly call <a>SetDesiredCapacity</a> to set the size of the group to the new value of <code>MaxSize</code>.</p> </li> <li> <p>All other optional parameters are left unchanged if not specified.</p> </li> </ul>"
},
"shapes": {
"Activities": {
@ -66,7 +66,7 @@
}
},
"ActivitiesType": {
"base": "<p>Contains the output of DescribeScalingActivities.</p>",
"base": null,
"refs": {
}
},
@ -84,7 +84,7 @@
}
},
"ActivityType": {
"base": "<p>Contains the output of TerminateInstancesInAutoScalingGroup.</p>",
"base": null,
"refs": {
}
},
@ -136,7 +136,7 @@
}
},
"AttachInstancesQuery": {
"base": "<p>Contains the parameters for AttachInstances.</p>",
"base": null,
"refs": {
}
},
@ -146,17 +146,17 @@
}
},
"AttachLoadBalancerTargetGroupsType": {
"base": "<p>Contains the parameters for AttachLoadBalancerTargetGroups.</p>",
"base": null,
"refs": {
}
},
"AttachLoadBalancersResultType": {
"base": "<p>Contains the output of AttachLoadBalancers.</p>",
"base": null,
"refs": {
}
},
"AttachLoadBalancersType": {
"base": "<p>Contains the parameters for AttachLoadBalancers.</p>",
"base": null,
"refs": {
}
},
@ -170,7 +170,7 @@
"base": null,
"refs": {
"AutoScalingGroup$DesiredCapacity": "<p>The desired size of the group.</p>",
"CreateAutoScalingGroupType$DesiredCapacity": "<p>The number of EC2 instances that should be running in the group. This number must be greater than or equal to the minimum size of the group and less than or equal to the maximum size of the group.</p>",
"CreateAutoScalingGroupType$DesiredCapacity": "<p>The number of EC2 instances that should be running in the group. This number must be greater than or equal to the minimum size of the group and less than or equal to the maximum size of the group. If you do not specify a desired capacity, the default is the minimum size of the group.</p>",
"PutScheduledUpdateGroupActionType$DesiredCapacity": "<p>The number of EC2 instances that should be running in the group.</p>",
"ScheduledUpdateGroupAction$DesiredCapacity": "<p>The number of instances you prefer to maintain in the group.</p>",
"SetDesiredCapacityType$DesiredCapacity": "<p>The number of EC2 instances that should be running in the Auto Scaling group.</p>",
@ -205,7 +205,7 @@
}
},
"AutoScalingGroupNamesType": {
"base": "<p>Contains the parameters for DescribeAutoScalingGroups.</p>",
"base": null,
"refs": {
}
},
@ -216,7 +216,7 @@
}
},
"AutoScalingGroupsType": {
"base": "<p>Contains the output for DescribeAutoScalingGroups.</p>",
"base": null,
"refs": {
}
},
@ -233,7 +233,7 @@
}
},
"AutoScalingInstancesType": {
"base": "<p>Contains the output of DescribeAutoScalingInstances.</p>",
"base": null,
"refs": {
}
},
@ -304,12 +304,12 @@
}
},
"CompleteLifecycleActionAnswer": {
"base": "<p>Contains the output of CompleteLifecycleAction.</p>",
"base": null,
"refs": {
}
},
"CompleteLifecycleActionType": {
"base": "<p>Contains the parameters for CompleteLifecycleAction.</p>",
"base": null,
"refs": {
}
},
@ -319,162 +319,162 @@
"AutoScalingGroup$DefaultCooldown": "<p>The amount of time, in seconds, after a scaling activity completes before another scaling activity can start.</p>",
"CreateAutoScalingGroupType$DefaultCooldown": "<p>The amount of time, in seconds, after a scaling activity completes before another scaling activity can start. The default is 300.</p> <p>For more information, see <a href=\"http://docs.aws.amazon.com/autoscaling/latest/userguide/Cooldown.html\">Auto Scaling Cooldowns</a> in the <i>Auto Scaling User Guide</i>.</p>",
"PutScalingPolicyType$Cooldown": "<p>The amount of time, in seconds, after a scaling activity completes and before the next scaling activity can start. If this parameter is not specified, the default cooldown period for the group applies.</p> <p>This parameter is not supported unless the policy type is <code>SimpleScaling</code>.</p> <p>For more information, see <a href=\"http://docs.aws.amazon.com/autoscaling/latest/userguide/Cooldown.html\">Auto Scaling Cooldowns</a> in the <i>Auto Scaling User Guide</i>.</p>",
"ScalingPolicy$Cooldown": "<p>The amount of time, in seconds, after a scaling activity completes before any further trigger-related scaling activities can start.</p>",
"ScalingPolicy$Cooldown": "<p>The amount of time, in seconds, after a scaling activity completes before any further dynamic scaling activities can start.</p>",
"UpdateAutoScalingGroupType$DefaultCooldown": "<p>The amount of time, in seconds, after a scaling activity completes before another scaling activity can start. The default is 300.</p> <p>For more information, see <a href=\"http://docs.aws.amazon.com/autoscaling/latest/userguide/Cooldown.html\">Auto Scaling Cooldowns</a> in the <i>Auto Scaling User Guide</i>.</p>"
}
},
"CreateAutoScalingGroupType": {
"base": "<p>Contains the parameters for CreateAutoScalingGroup.</p>",
"base": null,
"refs": {
}
},
"CreateLaunchConfigurationType": {
"base": "<p>Contains the parameters for CreateLaunchConfiguration.</p>",
"base": null,
"refs": {
}
},
"CreateOrUpdateTagsType": {
"base": "<p>Contains the parameters for CreateOrUpdateTags.</p>",
"base": null,
"refs": {
}
},
"DeleteAutoScalingGroupType": {
"base": "<p>Contains the parameters for DeleteAutoScalingGroup.</p>",
"base": null,
"refs": {
}
},
"DeleteLifecycleHookAnswer": {
"base": "<p>Contains the output of DeleteLifecycleHook.</p>",
"base": null,
"refs": {
}
},
"DeleteLifecycleHookType": {
"base": "<p>Contains the parameters for DeleteLifecycleHook.</p>",
"base": null,
"refs": {
}
},
"DeleteNotificationConfigurationType": {
"base": "<p>Contains the parameters for DeleteNotificationConfiguration.</p>",
"base": null,
"refs": {
}
},
"DeletePolicyType": {
"base": "<p>Contains the parameters for DeletePolicy.</p>",
"base": null,
"refs": {
}
},
"DeleteScheduledActionType": {
"base": "<p>Contains the parameters for DeleteScheduledAction.</p>",
"base": null,
"refs": {
}
},
"DeleteTagsType": {
"base": "<p>Contains the parameters for DeleteTags.</p>",
"base": null,
"refs": {
}
},
"DescribeAccountLimitsAnswer": {
"base": "<p>Contains the parameters for DescribeAccountLimits.</p>",
"base": null,
"refs": {
}
},
"DescribeAdjustmentTypesAnswer": {
"base": "<p>Contains the parameters for DescribeAdjustmentTypes.</p>",
"base": null,
"refs": {
}
},
"DescribeAutoScalingInstancesType": {
"base": "<p>Contains the parameters for DescribeAutoScalingInstances.</p>",
"base": null,
"refs": {
}
},
"DescribeAutoScalingNotificationTypesAnswer": {
"base": "<p>Contains the output of DescribeAutoScalingNotificationTypes.</p>",
"base": null,
"refs": {
}
},
"DescribeLifecycleHookTypesAnswer": {
"base": "<p>Contains the output of DescribeLifecycleHookTypes.</p>",
"base": null,
"refs": {
}
},
"DescribeLifecycleHooksAnswer": {
"base": "<p>Contains the output of DescribeLifecycleHooks.</p>",
"base": null,
"refs": {
}
},
"DescribeLifecycleHooksType": {
"base": "<p>Contains the parameters for DescribeLifecycleHooks.</p>",
"base": null,
"refs": {
}
},
"DescribeLoadBalancerTargetGroupsRequest": {
"base": "<p>Contains the parameters for DescribeLoadBalancerTargetGroups.</p>",
"base": null,
"refs": {
}
},
"DescribeLoadBalancerTargetGroupsResponse": {
"base": "<p>Contains the output of DescribeLoadBalancerTargetGroups.</p>",
"base": null,
"refs": {
}
},
"DescribeLoadBalancersRequest": {
"base": "<p>Contains the parameters for DescribeLoadBalancers.</p>",
"base": null,
"refs": {
}
},
"DescribeLoadBalancersResponse": {
"base": "<p>Contains the output of DescribeLoadBalancers.</p>",
"base": null,
"refs": {
}
},
"DescribeMetricCollectionTypesAnswer": {
"base": "<p>Contains the output of DescribeMetricsCollectionTypes.</p>",
"base": null,
"refs": {
}
},
"DescribeNotificationConfigurationsAnswer": {
"base": "<p>Contains the output from DescribeNotificationConfigurations.</p>",
"base": null,
"refs": {
}
},
"DescribeNotificationConfigurationsType": {
"base": "<p>Contains the parameters for DescribeNotificationConfigurations.</p>",
"base": null,
"refs": {
}
},
"DescribePoliciesType": {
"base": "<p>Contains the parameters for DescribePolicies.</p>",
"base": null,
"refs": {
}
},
"DescribeScalingActivitiesType": {
"base": "<p>Contains the parameters for DescribeScalingActivities.</p>",
"base": null,
"refs": {
}
},
"DescribeScheduledActionsType": {
"base": "<p>Contains the parameters for DescribeScheduledActions.</p>",
"base": null,
"refs": {
}
},
"DescribeTagsType": {
"base": "<p>Contains the parameters for DescribeTags.</p>",
"base": null,
"refs": {
}
},
"DescribeTerminationPolicyTypesAnswer": {
"base": "<p>Contains the output of DescribeTerminationPolicyTypes.</p>",
"base": null,
"refs": {
}
},
"DetachInstancesAnswer": {
"base": "<p>Contains the output of DetachInstances.</p>",
"base": null,
"refs": {
}
},
"DetachInstancesQuery": {
"base": "<p>Contains the parameters for DetachInstances.</p>",
"base": null,
"refs": {
}
},
@ -489,17 +489,17 @@
}
},
"DetachLoadBalancersResultType": {
"base": "<p>Contains the output for DetachLoadBalancers.</p>",
"base": null,
"refs": {
}
},
"DetachLoadBalancersType": {
"base": "<p>Contains the parameters for DetachLoadBalancers.</p>",
"base": null,
"refs": {
}
},
"DisableMetricsCollectionQuery": {
"base": "<p>Contains the parameters for DisableMetricsCollection.</p>",
"base": null,
"refs": {
}
},
@ -517,7 +517,7 @@
}
},
"EnableMetricsCollectionQuery": {
"base": "<p>Contains the parameters for EnableMetricsCollection.</p>",
"base": null,
"refs": {
}
},
@ -534,12 +534,12 @@
}
},
"EnterStandbyAnswer": {
"base": "<p>Contains the output of EnterStandby.</p>",
"base": null,
"refs": {
}
},
"EnterStandbyQuery": {
"base": "<p>Contains the parameters for EnteStandby.</p>",
"base": null,
"refs": {
}
},
@ -551,17 +551,17 @@
}
},
"ExecutePolicyType": {
"base": "<p>Contains the parameters for ExecutePolicy.</p>",
"base": null,
"refs": {
}
},
"ExitStandbyAnswer": {
"base": "<p>Contains the parameters for ExitStandby.</p>",
"base": null,
"refs": {
}
},
"ExitStandbyQuery": {
"base": "<p>Contains the parameters for ExitStandby.</p>",
"base": null,
"refs": {
}
},
@ -629,9 +629,9 @@
}
},
"InstanceMonitoring": {
"base": "<p>Describes whether instance monitoring is enabled.</p>",
"base": "<p>Describes whether detailed monitoring is enabled for the Auto Scaling instances.</p>",
"refs": {
"CreateLaunchConfigurationType$InstanceMonitoring": "<p>Enables detailed monitoring (<code>true</code>) or basic monitoring (<code>false</code>) for the Auto Scaling instances.</p>",
"CreateLaunchConfigurationType$InstanceMonitoring": "<p>Enables detailed monitoring (<code>true</code>) or basic monitoring (<code>false</code>) for the Auto Scaling instances. The default is <code>true</code>.</p>",
"LaunchConfiguration$InstanceMonitoring": "<p>Controls whether instances in this group are launched with detailed (<code>true</code>) or basic (<code>false</code>) monitoring.</p>"
}
},
@ -663,7 +663,7 @@
}
},
"LaunchConfigurationNameType": {
"base": "<p>Contains the parameters for DeleteLaunchConfiguration.</p>",
"base": null,
"refs": {
}
},
@ -674,7 +674,7 @@
}
},
"LaunchConfigurationNamesType": {
"base": "<p>Contains the parameters for DescribeLaunchConfigurations.</p>",
"base": null,
"refs": {
}
},
@ -685,7 +685,7 @@
}
},
"LaunchConfigurationsType": {
"base": "<p>Contains the output of DescribeLaunchConfigurations.</p>",
"base": null,
"refs": {
}
},
@ -745,12 +745,12 @@
"refs": {
"AttachLoadBalancersType$LoadBalancerNames": "<p>One or more load balancer names.</p>",
"AutoScalingGroup$LoadBalancerNames": "<p>One or more load balancers associated with the group.</p>",
"CreateAutoScalingGroupType$LoadBalancerNames": "<p>One or more Classic load balancers. To specify an Application load balancer, use <code>TargetGroupARNs</code> instead.</p> <p>For more information, see <a href=\"http://docs.aws.amazon.com/autoscaling/latest/userguide/create-asg-from-instance.html\">Using a Load Balancer With an Auto Scaling Group</a> in the <i>Auto Scaling User Guide</i>.</p>",
"CreateAutoScalingGroupType$LoadBalancerNames": "<p>One or more Classic Load Balancers. To specify an Application Load Balancer, use <code>TargetGroupARNs</code> instead.</p> <p>For more information, see <a href=\"http://docs.aws.amazon.com/autoscaling/latest/userguide/create-asg-from-instance.html\">Using a Load Balancer With an Auto Scaling Group</a> in the <i>Auto Scaling User Guide</i>.</p>",
"DetachLoadBalancersType$LoadBalancerNames": "<p>One or more load balancer names.</p>"
}
},
"LoadBalancerState": {
"base": "<p>Describes the state of a Classic load balancer.</p> <p>If you specify a load balancer when creating the Auto Scaling group, the state of the load balancer is <code>InService</code>.</p> <p>If you attach a load balancer to an existing Auto Scaling group, the initial state is <code>Adding</code>. The state transitions to <code>Added</code> after all instances in the group are registered with the load balancer. If ELB health checks are enabled for the load balancer, the state transitions to <code>InService</code> after at least one instance in the group passes the health check. If EC2 health checks are enabled instead, the load balancer remains in the <code>Added</code> state.</p>",
"base": "<p>Describes the state of a Classic Load Balancer.</p> <p>If you specify a load balancer when creating the Auto Scaling group, the state of the load balancer is <code>InService</code>.</p> <p>If you attach a load balancer to an existing Auto Scaling group, the initial state is <code>Adding</code>. The state transitions to <code>Added</code> after all instances in the group are registered with the load balancer. If ELB health checks are enabled for the load balancer, the state transitions to <code>InService</code> after at least one instance in the group passes the health check. If EC2 health checks are enabled instead, the load balancer remains in the <code>Added</code> state.</p>",
"refs": {
"LoadBalancerStates$member": null
}
@ -788,16 +788,16 @@
"MaxRecords": {
"base": null,
"refs": {
"AutoScalingGroupNamesType$MaxRecords": "<p>The maximum number of items to return with this call.</p>",
"DescribeAutoScalingInstancesType$MaxRecords": "<p>The maximum number of items to return with this call.</p>",
"DescribeLoadBalancerTargetGroupsRequest$MaxRecords": "<p>The maximum number of items to return with this call.</p>",
"DescribeLoadBalancersRequest$MaxRecords": "<p>The maximum number of items to return with this call.</p>",
"DescribeNotificationConfigurationsType$MaxRecords": "<p>The maximum number of items to return with this call.</p>",
"DescribePoliciesType$MaxRecords": "<p>The maximum number of items to be returned with each call.</p>",
"DescribeScalingActivitiesType$MaxRecords": "<p>The maximum number of items to return with this call.</p>",
"DescribeScheduledActionsType$MaxRecords": "<p>The maximum number of items to return with this call.</p>",
"DescribeTagsType$MaxRecords": "<p>The maximum number of items to return with this call.</p>",
"LaunchConfigurationNamesType$MaxRecords": "<p>The maximum number of items to return with this call. The default is 100.</p>"
"AutoScalingGroupNamesType$MaxRecords": "<p>The maximum number of items to return with this call. The default value is 50 and the maximum value is 100.</p>",
"DescribeAutoScalingInstancesType$MaxRecords": "<p>The maximum number of items to return with this call. The default value is 50 and the maximum value is 100.</p>",
"DescribeLoadBalancerTargetGroupsRequest$MaxRecords": "<p>The maximum number of items to return with this call. The default value is 50 and the maximum value is 100.</p>",
"DescribeLoadBalancersRequest$MaxRecords": "<p>The maximum number of items to return with this call. The default value is 50 and the maximum value is 100.</p>",
"DescribeNotificationConfigurationsType$MaxRecords": "<p>The maximum number of items to return with this call. The default value is 50 and the maximum value is 100.</p>",
"DescribePoliciesType$MaxRecords": "<p>The maximum number of items to be returned with each call. The default value is 50 and the maximum value is 100.</p>",
"DescribeScalingActivitiesType$MaxRecords": "<p>The maximum number of items to return with this call. The default value is 100.</p>",
"DescribeScheduledActionsType$MaxRecords": "<p>The maximum number of items to return with this call. The default value is 50 and the maximum value is 100.</p>",
"DescribeTagsType$MaxRecords": "<p>The maximum number of items to return with this call. The default value is 50 and the maximum value is 100.</p>",
"LaunchConfigurationNamesType$MaxRecords": "<p>The maximum number of items to return with this call. The default value is 50 and the maximum value is 100.</p>"
}
},
"MetricCollectionType": {
@ -857,7 +857,7 @@
"MonitoringEnabled": {
"base": null,
"refs": {
"InstanceMonitoring$Enabled": "<p>If <code>True</code>, instance monitoring is enabled.</p>"
"InstanceMonitoring$Enabled": "<p>If <code>true</code>, detailed monitoring is enabled. Otherwise, basic monitoring is enabled.</p>"
}
},
"NoDevice": {
@ -897,12 +897,12 @@
}
},
"PoliciesType": {
"base": "<p>Contains the output of DescribePolicies.</p>",
"base": null,
"refs": {
}
},
"PolicyARNType": {
"base": "<p>Contains the output of PutScalingPolicy.</p>",
"base": null,
"refs": {
}
},
@ -945,7 +945,7 @@
}
},
"ProcessesType": {
"base": "<p>Contains the output of DescribeScalingProcessTypes.</p>",
"base": null,
"refs": {
}
},
@ -969,37 +969,37 @@
}
},
"PutLifecycleHookAnswer": {
"base": "<p>Contains the output of PutLifecycleHook.</p>",
"base": null,
"refs": {
}
},
"PutLifecycleHookType": {
"base": "<p>Contains the parameters for PutLifecycleHook.</p>",
"base": null,
"refs": {
}
},
"PutNotificationConfigurationType": {
"base": "<p>Contains the parameters for PutNotificationConfiguration.</p>",
"base": null,
"refs": {
}
},
"PutScalingPolicyType": {
"base": "<p>Contains the parameters for PutScalingPolicy.</p>",
"base": null,
"refs": {
}
},
"PutScheduledUpdateGroupActionType": {
"base": "<p>Contains the parameters for PutScheduledUpdateGroupAction.</p>",
"base": null,
"refs": {
}
},
"RecordLifecycleActionHeartbeatAnswer": {
"base": "<p>Contains the output of RecordLifecycleActionHeartBeat.</p>",
"base": null,
"refs": {
}
},
"RecordLifecycleActionHeartbeatType": {
"base": "<p>Contains the parameters for RecordLifecycleActionHeartbeat.</p>",
"base": null,
"refs": {
}
},
@ -1098,7 +1098,7 @@
}
},
"ScalingProcessQuery": {
"base": "<p>Contains the parameters for SuspendProcesses and ResumeProcesses.</p>",
"base": null,
"refs": {
}
},
@ -1109,7 +1109,7 @@
}
},
"ScheduledActionsType": {
"base": "<p>Contains the output of DescribeScheduledActions.</p>",
"base": null,
"refs": {
}
},
@ -1133,22 +1133,22 @@
}
},
"SetDesiredCapacityType": {
"base": "<p>Contains the parameters for SetDesiredCapacity.</p>",
"base": null,
"refs": {
}
},
"SetInstanceHealthQuery": {
"base": "<p>Contains the parameters for SetInstanceHealth.</p>",
"base": null,
"refs": {
}
},
"SetInstanceProtectionAnswer": {
"base": "<p>Contains the output of SetInstanceProtection.</p>",
"base": null,
"refs": {
}
},
"SetInstanceProtectionQuery": {
"base": "<p>Contains the parameters for SetInstanceProtection.</p>",
"base": null,
"refs": {
}
},
@ -1240,7 +1240,7 @@
}
},
"TagsType": {
"base": "<p>Contains the output of DescribeTags.</p>",
"base": null,
"refs": {
}
},
@ -1254,7 +1254,7 @@
}
},
"TerminateInstanceInAutoScalingGroupType": {
"base": "<p>Contains the parameters for TerminateInstanceInAutoScalingGroup.</p>",
"base": null,
"refs": {
}
},
@ -1285,7 +1285,7 @@
}
},
"UpdateAutoScalingGroupType": {
"base": "<p>Contains the parameters for UpdateAutoScalingGroup.</p>",
"base": null,
"refs": {
}
},
@ -1353,7 +1353,7 @@
"AutoScalingInstanceDetails$InstanceId": "<p>The ID of the instance.</p>",
"CompleteLifecycleActionType$InstanceId": "<p>The ID of the instance.</p>",
"CreateAutoScalingGroupType$InstanceId": "<p>The ID of the instance used to create a launch configuration for the group. Alternatively, specify a launch configuration instead of an EC2 instance.</p> <p>When you specify an ID of an instance, Auto Scaling creates a new launch configuration and associates it with the group. This launch configuration derives its attributes from the specified instance, with the exception of the block device mapping.</p> <p>For more information, see <a href=\"http://docs.aws.amazon.com/autoscaling/latest/userguide/create-asg-from-instance.html\">Create an Auto Scaling Group Using an EC2 Instance</a> in the <i>Auto Scaling User Guide</i>.</p>",
"CreateLaunchConfigurationType$InstanceId": "<p>The ID of the instance to use to create the launch configuration.</p> <p>The new launch configuration derives attributes from the instance, with the exception of the block device mapping.</p> <p>To create a launch configuration with a block device mapping or override any other instance attributes, specify them as part of the same request.</p> <p>For more information, see <a href=\"http://docs.aws.amazon.com/autoscaling/latest/userguide/create-lc-with-instanceID.html\">Create a Launch Configuration Using an EC2 Instance</a> in the <i>Auto Scaling User Guide</i>.</p>",
"CreateLaunchConfigurationType$InstanceId": "<p>The ID of the instance to use to create the launch configuration. The new launch configuration derives attributes from the instance, with the exception of the block device mapping.</p> <p>If you do not specify <code>InstanceId</code>, you must specify both <code>ImageId</code> and <code>InstanceType</code>.</p> <p>To create a launch configuration with a block device mapping or override any other instance attributes, specify them as part of the same request.</p> <p>For more information, see <a href=\"http://docs.aws.amazon.com/autoscaling/latest/userguide/create-lc-with-instanceID.html\">Create a Launch Configuration Using an EC2 Instance</a> in the <i>Auto Scaling User Guide</i>.</p>",
"Instance$InstanceId": "<p>The ID of the instance.</p>",
"InstanceIds$member": null,
"RecordLifecycleActionHeartbeatType$InstanceId": "<p>The ID of the instance.</p>",
@ -1383,7 +1383,7 @@
"AutoScalingGroup$Status": "<p>The current state of the group when <a>DeleteAutoScalingGroup</a> is in progress.</p>",
"AutoScalingInstanceDetails$AutoScalingGroupName": "<p>The name of the Auto Scaling group associated with the instance.</p>",
"AutoScalingInstanceDetails$AvailabilityZone": "<p>The Availability Zone for the instance.</p>",
"AutoScalingInstanceDetails$LaunchConfigurationName": "<p>The launch configuration associated with the instance.</p>",
"AutoScalingInstanceDetails$LaunchConfigurationName": "<p>The launch configuration used to launch the instance. This value is not available if you attached the instance to the Auto Scaling group.</p>",
"AutoScalingNotificationTypes$member": null,
"AvailabilityZones$member": null,
"BlockDeviceMapping$VirtualName": "<p>The name of the virtual device (for example, <code>ephemeral0</code>).</p>",
@ -1392,10 +1392,10 @@
"CreateAutoScalingGroupType$AutoScalingGroupName": "<p>The name of the group. This name must be unique within the scope of your AWS account.</p>",
"CreateAutoScalingGroupType$PlacementGroup": "<p>The name of the placement group into which you'll launch your instances, if any. For more information, see <a href=\"http://docs.aws.amazon.com/AWSEC2/latest/UserGuide/placement-groups.html\">Placement Groups</a> in the <i>Amazon Elastic Compute Cloud User Guide</i>.</p>",
"CreateLaunchConfigurationType$LaunchConfigurationName": "<p>The name of the launch configuration. This name must be unique within the scope of your AWS account.</p>",
"CreateLaunchConfigurationType$ImageId": "<p>The ID of the Amazon Machine Image (AMI) to use to launch your EC2 instances. For more information, see <a href=\"http://docs.aws.amazon.com/AWSEC2/latest/UserGuide/finding-an-ami.html\">Finding an AMI</a> in the <i>Amazon Elastic Compute Cloud User Guide</i>.</p>",
"CreateLaunchConfigurationType$ImageId": "<p>The ID of the Amazon Machine Image (AMI) to use to launch your EC2 instances.</p> <p>If you do not specify <code>InstanceId</code>, you must specify <code>ImageId</code>.</p> <p>For more information, see <a href=\"http://docs.aws.amazon.com/AWSEC2/latest/UserGuide/finding-an-ami.html\">Finding an AMI</a> in the <i>Amazon Elastic Compute Cloud User Guide</i>.</p>",
"CreateLaunchConfigurationType$KeyName": "<p>The name of the key pair. For more information, see <a href=\"http://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-key-pairs.html\">Amazon EC2 Key Pairs</a> in the <i>Amazon Elastic Compute Cloud User Guide</i>.</p>",
"CreateLaunchConfigurationType$ClassicLinkVPCId": "<p>The ID of a ClassicLink-enabled VPC to link your EC2-Classic instances to. This parameter is supported only if you are launching EC2-Classic instances. For more information, see <a href=\"http://docs.aws.amazon.com/AWSEC2/latest/UserGuide/vpc-classiclink.html\">ClassicLink</a> in the <i>Amazon Elastic Compute Cloud User Guide</i>.</p>",
"CreateLaunchConfigurationType$InstanceType": "<p>The instance type of the EC2 instance. For information about available instance types, see <a href=\"http://docs.aws.amazon.com/AWSEC2/latest/UserGuide/instance-types.html#AvailableInstanceTypes\"> Available Instance Types</a> in the <i>Amazon Elastic Compute Cloud User Guide.</i> </p>",
"CreateLaunchConfigurationType$InstanceType": "<p>The instance type of the EC2 instance.</p> <p>If you do not specify <code>InstanceId</code>, you must specify <code>InstanceType</code>.</p> <p>For information about available instance types, see <a href=\"http://docs.aws.amazon.com/AWSEC2/latest/UserGuide/instance-types.html#AvailableInstanceTypes\">Available Instance Types</a> in the <i>Amazon Elastic Compute Cloud User Guide.</i> </p>",
"CreateLaunchConfigurationType$KernelId": "<p>The ID of the kernel associated with the AMI.</p>",
"CreateLaunchConfigurationType$RamdiskId": "<p>The ID of the RAM disk associated with the AMI.</p>",
"Ebs$SnapshotId": "<p>The ID of the snapshot.</p>",

3
vendor/github.com/aws/aws-sdk-go/models/apis/autoscaling/2011-01-01/examples-1.json generated vendored
View File

@ -410,7 +410,8 @@
"HealthStatus": "Healthy",
"InstanceId": "i-4ba0837f",
"LaunchConfigurationName": "my-launch-config",
"LifecycleState": "InService"
"LifecycleState": "InService",
"ProtectedFromScaleIn": false
}
],
"LaunchConfigurationName": "my-launch-config",

16
vendor/github.com/aws/aws-sdk-go/models/apis/autoscaling/2011-01-01/paginators-1.json generated vendored
View File

@ -2,50 +2,50 @@
"pagination": {
"DescribeAutoScalingGroups": {
"input_token": "NextToken",
"output_token": "NextToken",
"limit_key": "MaxRecords",
"output_token": "NextToken",
"result_key": "AutoScalingGroups"
},
"DescribeAutoScalingInstances": {
"input_token": "NextToken",
"output_token": "NextToken",
"limit_key": "MaxRecords",
"output_token": "NextToken",
"result_key": "AutoScalingInstances"
},
"DescribeLaunchConfigurations": {
"input_token": "NextToken",
"output_token": "NextToken",
"limit_key": "MaxRecords",
"output_token": "NextToken",
"result_key": "LaunchConfigurations"
},
"DescribeNotificationConfigurations": {
"input_token": "NextToken",
"output_token": "NextToken",
"limit_key": "MaxRecords",
"output_token": "NextToken",
"result_key": "NotificationConfigurations"
},
"DescribePolicies": {
"input_token": "NextToken",
"output_token": "NextToken",
"limit_key": "MaxRecords",
"output_token": "NextToken",
"result_key": "ScalingPolicies"
},
"DescribeScalingActivities": {
"input_token": "NextToken",
"output_token": "NextToken",
"limit_key": "MaxRecords",
"output_token": "NextToken",
"result_key": "Activities"
},
"DescribeScheduledActions": {
"input_token": "NextToken",
"output_token": "NextToken",
"limit_key": "MaxRecords",
"output_token": "NextToken",
"result_key": "ScheduledUpdateGroupActions"
},
"DescribeTags": {
"input_token": "NextToken",
"output_token": "NextToken",
"limit_key": "MaxRecords",
"output_token": "NextToken",
"result_key": "Tags"
}
}

33
vendor/github.com/aws/aws-sdk-go/models/apis/codedeploy/2014-10-06/api-2.json generated vendored
View File

@ -178,7 +178,8 @@
{"shape":"DeploymentLimitExceededException"},
{"shape":"InvalidTargetInstancesException"},
{"shape":"InvalidAutoRollbackConfigException"},
{"shape":"InvalidLoadBalancerInfoException"}
{"shape":"InvalidLoadBalancerInfoException"},
{"shape":"InvalidFileExistsBehaviorException"}
]
},
"CreateDeploymentConfig":{
@ -467,7 +468,8 @@
{"shape":"InvalidNextTokenException"},
{"shape":"InvalidDeploymentIdException"},
{"shape":"InvalidInstanceStatusException"},
{"shape":"InvalidInstanceTypeException"}
{"shape":"InvalidInstanceTypeException"},
{"shape":"InvalidDeploymentInstanceTypeException"}
]
},
"ListDeployments":{
@ -966,7 +968,8 @@
"ignoreApplicationStopFailures":{"shape":"Boolean"},
"targetInstances":{"shape":"TargetInstances"},
"autoRollbackConfiguration":{"shape":"AutoRollbackConfiguration"},
"updateOutdatedInstancesOnly":{"shape":"Boolean"}
"updateOutdatedInstancesOnly":{"shape":"Boolean"},
"fileExistsBehavior":{"shape":"FileExistsBehavior"}
}
},
"CreateDeploymentOutput":{
@ -1147,6 +1150,7 @@
"deploymentGroupName":{"shape":"DeploymentGroupName"},
"deploymentConfigName":{"shape":"DeploymentConfigName"},
"deploymentId":{"shape":"DeploymentId"},
"previousRevision":{"shape":"RevisionLocation"},
"revision":{"shape":"RevisionLocation"},
"status":{"shape":"DeploymentStatus"},
"errorInformation":{"shape":"ErrorInformation"},
@ -1165,7 +1169,8 @@
"instanceTerminationWaitTimeStarted":{"shape":"Boolean"},
"blueGreenDeploymentConfiguration":{"shape":"BlueGreenDeploymentConfiguration"},
"loadBalancerInfo":{"shape":"LoadBalancerInfo"},
"additionalDeploymentStatusInfo":{"shape":"AdditionalDeploymentStatusInfo"}
"additionalDeploymentStatusInfo":{"shape":"AdditionalDeploymentStatusInfo"},
"fileExistsBehavior":{"shape":"FileExistsBehavior"}
}
},
"DeploymentIsNotInReadyStateException":{
@ -1343,6 +1348,14 @@
}
},
"ErrorMessage":{"type":"string"},
"FileExistsBehavior":{
"type":"string",
"enum":[
"DISALLOW",
"OVERWRITE",
"RETAIN"
]
},
"GenericRevisionInfo":{
"type":"structure",
"members":{
@ -1677,6 +1690,12 @@
},
"exception":true
},
"InvalidDeploymentInstanceTypeException":{
"type":"structure",
"members":{
},
"exception":true
},
"InvalidDeploymentStatusException":{
"type":"structure",
"members":{
@ -1695,6 +1714,12 @@
},
"exception":true
},
"InvalidFileExistsBehaviorException":{
"type":"structure",
"members":{
},
"exception":true
},
"InvalidIamSessionArnException":{
"type":"structure",
"members":{

66
vendor/github.com/aws/aws-sdk-go/models/apis/codedeploy/2014-10-06/docs-2.json generated vendored
View File

@ -1,6 +1,6 @@
{
"version": "2.0",
"service": "<fullname>AWS CodeDeploy</fullname> <p> <b>Overview</b> </p> <p>This reference guide provides descriptions of the AWS CodeDeploy APIs. For more information about AWS CodeDeploy, see the <a href=\"http://docs.aws.amazon.com/codedeploy/latest/userguide\">AWS CodeDeploy User Guide</a>.</p> <p> <b>Using the APIs</b> </p> <p>You can use the AWS CodeDeploy APIs to work with the following:</p> <ul> <li> <p>Applications are unique identifiers used by AWS CodeDeploy to ensure the correct combinations of revisions, deployment configurations, and deployment groups are being referenced during deployments.</p> <p>You can use the AWS CodeDeploy APIs to create, delete, get, list, and update applications.</p> </li> <li> <p>Deployment configurations are sets of deployment rules and success and failure conditions used by AWS CodeDeploy during deployments.</p> <p>You can use the AWS CodeDeploy APIs to create, delete, get, and list deployment configurations.</p> </li> <li> <p>Deployment groups are groups of instances to which application revisions can be deployed.</p> <p>You can use the AWS CodeDeploy APIs to create, delete, get, list, and update deployment groups.</p> </li> <li> <p>Instances represent Amazon EC2 instances to which application revisions are deployed. Instances are identified by their Amazon EC2 tags or Auto Scaling group names. Instances belong to deployment groups.</p> <p>You can use the AWS CodeDeploy APIs to get and list instance.</p> </li> <li> <p>Deployments represent the process of deploying revisions to instances.</p> <p>You can use the AWS CodeDeploy APIs to create, get, list, and stop deployments.</p> </li> <li> <p>Application revisions are archive files stored in Amazon S3 buckets or GitHub repositories. These revisions contain source content (such as source code, web pages, executable files, and deployment scripts) along with an application specification (AppSpec) file. (The AppSpec file is unique to AWS CodeDeploy; it defines the deployment actions you want AWS CodeDeploy to execute.) For application revisions stored in Amazon S3 buckets, an application revision is uniquely identified by its Amazon S3 object key and its ETag, version, or both. For application revisions stored in GitHub repositories, an application revision is uniquely identified by its repository name and commit ID. Application revisions are deployed through deployment groups.</p> <p>You can use the AWS CodeDeploy APIs to get, list, and register application revisions.</p> </li> </ul>",
"service": "<fullname>AWS CodeDeploy</fullname> <p>AWS CodeDeploy is a deployment service that automates application deployments to Amazon EC2 instances or on-premises instances running in your own facility.</p> <p>You can deploy a nearly unlimited variety of application content, such as code, web and configuration files, executables, packages, scripts, multimedia files, and so on. AWS CodeDeploy can deploy application content stored in Amazon S3 buckets, GitHub repositories, or Bitbucket repositories. You do not need to make changes to your existing code before you can use AWS CodeDeploy.</p> <p>AWS CodeDeploy makes it easier for you to rapidly release new features, helps you avoid downtime during application deployment, and handles the complexity of updating your applications, without many of the risks associated with error-prone manual deployments.</p> <p> <b>AWS CodeDeploy Components</b> </p> <p>Use the information in this guide to help you work with the following AWS CodeDeploy components:</p> <ul> <li> <p> <b>Application</b>: A name that uniquely identifies the application you want to deploy. AWS CodeDeploy uses this name, which functions as a container, to ensure the correct combination of revision, deployment configuration, and deployment group are referenced during a deployment.</p> </li> <li> <p> <b>Deployment group</b>: A set of individual instances. A deployment group contains individually tagged instances, Amazon EC2 instances in Auto Scaling groups, or both. </p> </li> <li> <p> <b>Deployment configuration</b>: A set of deployment rules and deployment success and failure conditions used by AWS CodeDeploy during a deployment.</p> </li> <li> <p> <b>Deployment</b>: The process, and the components involved in the process, of installing content on one or more instances. </p> </li> <li> <p> <b>Application revisions</b>: An archive file containing source content—source code, web pages, executable files, and deployment scripts—along with an application specification file (AppSpec file). Revisions are stored in Amazon S3 buckets or GitHub repositories. For Amazon S3, a revision is uniquely identified by its Amazon S3 object key and its ETag, version, or both. For GitHub, a revision is uniquely identified by its commit ID.</p> </li> </ul> <p>This guide also contains information to help you get details about the instances in your deployments and to make on-premises instances available for AWS CodeDeploy deployments.</p> <p> <b>AWS CodeDeploy Information Resources</b> </p> <ul> <li> <p> <a href=\"http://docs.aws.amazon.com/codedeploy/latest/userguide\">AWS CodeDeploy User Guide</a> </p> </li> <li> <p> <a href=\"http://docs.aws.amazon.com/codedeploy/latest/APIReference/\">AWS CodeDeploy API Reference Guide</a> </p> </li> <li> <p> <a href=\"http://docs.aws.amazon.com/cli/latest/reference/deploy/index.html\">AWS CLI Reference for AWS CodeDeploy</a> </p> </li> <li> <p> <a href=\"https://forums.aws.amazon.com/forum.jspa?forumID=179\">AWS CodeDeploy Developer Forum</a> </p> </li> </ul>",
"operations": {
"AddTagsToOnPremisesInstances": "<p>Adds tags to on-premises instances.</p>",
"BatchGetApplicationRevisions": "<p>Gets information about one or more application revisions.</p>",
@ -9,7 +9,7 @@
"BatchGetDeploymentInstances": "<p>Gets information about one or more instance that are part of a deployment group.</p>",
"BatchGetDeployments": "<p>Gets information about one or more deployments.</p>",
"BatchGetOnPremisesInstances": "<p>Gets information about one or more on-premises instances.</p>",
"ContinueDeployment": "<p>Starts the process of rerouting traffic from instances in the original environment to instances in thereplacement environment without waiting for a specified wait time to elapse. (Traffic rerouting, which is achieved by registering instances in the replacement environment with the load balancer, can start as soon as all instances have a status of Ready.) </p>",
"ContinueDeployment": "<p>For a blue/green deployment, starts the process of rerouting traffic from instances in the original environment to instances in the replacement environment without waiting for a specified wait time to elapse. (Traffic rerouting, which is achieved by registering instances in the replacement environment with the load balancer, can start as soon as all instances have a status of Ready.) </p>",
"CreateApplication": "<p>Creates an application.</p>",
"CreateDeployment": "<p>Deploys an application revision through the specified deployment group.</p>",
"CreateDeploymentConfig": "<p>Creates a deployment configuration.</p>",
@ -61,9 +61,9 @@
"AlarmConfiguration": {
"base": "<p>Information about alarms associated with the deployment group.</p>",
"refs": {
"CreateDeploymentGroupInput$alarmConfiguration": "<p>Information to add about Amazon CloudWatch alarms when the deployment group is created. </p>",
"CreateDeploymentGroupInput$alarmConfiguration": "<p>Information to add about Amazon CloudWatch alarms when the deployment group is created.</p>",
"DeploymentGroupInfo$alarmConfiguration": "<p>A list of alarms associated with the deployment group.</p>",
"UpdateDeploymentGroupInput$alarmConfiguration": "<p>Information to add or change about Amazon CloudWatch alarms when the deployment group is updated. </p>"
"UpdateDeploymentGroupInput$alarmConfiguration": "<p>Information to add or change about Amazon CloudWatch alarms when the deployment group is updated.</p>"
}
},
"AlarmList": {
@ -440,7 +440,7 @@
"base": null,
"refs": {
"CreateDeploymentConfigInput$deploymentConfigName": "<p>The name of the deployment configuration to create.</p>",
"CreateDeploymentGroupInput$deploymentConfigName": "<p>If specified, the deployment configuration name can be either one of the predefined configurations provided with AWS CodeDeploy or a custom deployment configuration that you create by calling the create deployment configuration operation.</p> <p>CodeDeployDefault.OneAtATime is the default deployment configuration. It is used if a configuration isn't specified for the deployment or the deployment group.</p> <p>For more information about the predefined deployment configurations in AWS CodeDeploy, see see <a href=\"http://docs.aws.amazon.com/codedeploy/latest/userguide/deployment-configurations.html\">Working with Deployment Groups in AWS CodeDeploy</a> in the AWS CodeDeploy User Guide.</p>",
"CreateDeploymentGroupInput$deploymentConfigName": "<p>If specified, the deployment configuration name can be either one of the predefined configurations provided with AWS CodeDeploy or a custom deployment configuration that you create by calling the create deployment configuration operation.</p> <p>CodeDeployDefault.OneAtATime is the default deployment configuration. It is used if a configuration isn't specified for the deployment or the deployment group.</p> <p>For more information about the predefined deployment configurations in AWS CodeDeploy, see <a href=\"http://docs.aws.amazon.com/codedeploy/latest/userguide/deployment-configurations.html\">Working with Deployment Groups in AWS CodeDeploy</a> in the AWS CodeDeploy User Guide.</p>",
"CreateDeploymentInput$deploymentConfigName": "<p>The name of a deployment configuration associated with the applicable IAM user or AWS account.</p> <p>If not specified, the value configured in the deployment group will be used as the default. If the deployment group does not have a deployment configuration associated with it, then CodeDeployDefault.OneAtATime will be used by default.</p>",
"DeleteDeploymentConfigInput$deploymentConfigName": "<p>The name of a deployment configuration associated with the applicable IAM user or AWS account.</p>",
"DeploymentConfigInfo$deploymentConfigName": "<p>The deployment configuration name.</p>",
@ -619,18 +619,18 @@
}
},
"DeploymentStyle": {
"base": "<p>Information about the type of deployment, either standard or blue/green, you want to run and whether to route deployment traffic behind a load balancer.</p>",
"base": "<p>Information about the type of deployment, either in-place or blue/green, you want to run and whether to route deployment traffic behind a load balancer.</p>",
"refs": {
"CreateDeploymentGroupInput$deploymentStyle": "<p>Information about the type of deployment, standard or blue/green, that you want to run and whether to route deployment traffic behind a load balancer.</p>",
"DeploymentGroupInfo$deploymentStyle": "<p>Information about the type of deployment, either standard or blue/green, you want to run and whether to route deployment traffic behind a load balancer.</p>",
"DeploymentInfo$deploymentStyle": "<p>Information about the type of deployment, either standard or blue/green, you want to run and whether to route deployment traffic behind a load balancer.</p>",
"UpdateDeploymentGroupInput$deploymentStyle": "<p>Information about the type of deployment, either standard or blue/green, you want to run and whether to route deployment traffic behind a load balancer.</p>"
"CreateDeploymentGroupInput$deploymentStyle": "<p>Information about the type of deployment, in-place or blue/green, that you want to run and whether to route deployment traffic behind a load balancer.</p>",
"DeploymentGroupInfo$deploymentStyle": "<p>Information about the type of deployment, either in-place or blue/green, you want to run and whether to route deployment traffic behind a load balancer.</p>",
"DeploymentInfo$deploymentStyle": "<p>Information about the type of deployment, either in-place or blue/green, you want to run and whether to route deployment traffic behind a load balancer.</p>",
"UpdateDeploymentGroupInput$deploymentStyle": "<p>Information about the type of deployment, either in-place or blue/green, you want to run and whether to route deployment traffic behind a load balancer.</p>"
}
},
"DeploymentType": {
"base": null,
"refs": {
"DeploymentStyle$deploymentType": "<p>Indicates whether to run a standard deployment or a blue/green deployment.</p>"
"DeploymentStyle$deploymentType": "<p>Indicates whether to run an in-place deployment or a blue/green deployment.</p>"
}
},
"DeploymentsInfoList": {
@ -680,7 +680,7 @@
}
},
"EC2TagFilter": {
"base": "<p>Information about a tag filter.</p>",
"base": "<p>Information about an EC2 tag filter.</p>",
"refs": {
"EC2TagFilterList$member": null
}
@ -688,7 +688,7 @@
"EC2TagFilterList": {
"base": null,
"refs": {
"CreateDeploymentGroupInput$ec2TagFilters": "<p>The Amazon EC2 tags on which to filter.</p>",
"CreateDeploymentGroupInput$ec2TagFilters": "<p>The Amazon EC2 tags on which to filter. The deployment group will include EC2 instances with any of the specified tags.</p>",
"DeploymentGroupInfo$ec2TagFilters": "<p>The Amazon EC2 tags on which to filter.</p>",
"TargetInstances$tagFilters": "<p>The tag filter key, type, and value used to identify Amazon EC2 instances in a replacement environment for a blue/green deployment.</p>",
"UpdateDeploymentGroupInput$ec2TagFilters": "<p>The replacement set of Amazon EC2 tags on which to filter, if you want to change them. To keep the existing tags, enter their names. To remove tags, do not enter any tag names.</p>"
@ -701,7 +701,7 @@
}
},
"ELBInfo": {
"base": "<p>Information about a load balancer in Elastic Load Balancing to use in a blue/green deployment.</p>",
"base": "<p>Information about a load balancer in Elastic Load Balancing to use in a deployment.</p>",
"refs": {
"ELBInfoList$member": null
}
@ -709,13 +709,13 @@
"ELBInfoList": {
"base": null,
"refs": {
"LoadBalancerInfo$elbInfoList": "<p>An array containing information about the load balancer in Elastic Load Balancing to use in a blue/green deployment.</p>"
"LoadBalancerInfo$elbInfoList": "<p>An array containing information about the load balancer in Elastic Load Balancing to use in a deployment.</p>"
}
},
"ELBName": {
"base": null,
"refs": {
"ELBInfo$name": "<p>The name of the load balancer that will be used to route traffic from original instances to replacement instances in a blue/green deployment.</p>"
"ELBInfo$name": "<p>For blue/green deployments, the name of the load balancer that will be used to route traffic from original instances to replacement instances in a blue/green deployment. For in-place deployments, the name of the load balancer that instances are deregistered from so they are not serving traffic during a deployment, and then re-registered with after the deployment completes.</p>"
}
},
"ETag": {
@ -745,6 +745,13 @@
"ErrorInformation$message": "<p>An accompanying error message.</p>"
}
},
"FileExistsBehavior": {
"base": null,
"refs": {
"CreateDeploymentInput$fileExistsBehavior": "<p>Information about how AWS CodeDeploy handles files that already exist in a deployment target location but weren't part of the previous successful deployment.</p> <p>The fileExistsBehavior parameter takes any of the following values:</p> <ul> <li> <p>DISALLOW: The deployment fails. This is also the default behavior if no option is specified.</p> </li> <li> <p>OVERWRITE: The version of the file from the application revision currently being deployed replaces the version already on the instance.</p> </li> <li> <p>RETAIN: The version of the file already on the instance is kept and used as part of the new deployment.</p> </li> </ul>",
"DeploymentInfo$fileExistsBehavior": "<p>Information about how AWS CodeDeploy handles files that already exist in a deployment target location but weren't part of the previous successful deployment.</p> <ul> <li> <p>DISALLOW: The deployment fails. This is also the default behavior if no option is specified.</p> </li> <li> <p>OVERWRITE: The version of the file from the application revision currently being deployed replaces the version already on the instance.</p> </li> <li> <p>RETAIN: The version of the file already on the instance is kept and used as part of the new deployment.</p> </li> </ul>"
}
},
"GenericRevisionInfo": {
"base": "<p>Information about an application revision.</p>",
"refs": {
@ -1063,13 +1070,18 @@
"refs": {
}
},
"InvalidDeploymentInstanceTypeException": {
"base": "<p>An instance type was specified for an in-place deployment. Instance types are supported for blue/green deployments only.</p>",
"refs": {
}
},
"InvalidDeploymentStatusException": {
"base": "<p>The specified deployment status doesn't exist or cannot be determined.</p>",
"refs": {
}
},
"InvalidDeploymentStyleException": {
"base": "<p>An invalid deployment style was specified. Valid deployment types include \"IN_PLACE\" and \"BLUE_GREEN\". Valid deployment options for blue/green deployments include \"WITH_TRAFFIC_CONTROL\" and \"WITHOUT_TRAFFIC_CONTROL\".</p>",
"base": "<p>An invalid deployment style was specified. Valid deployment types include \"IN_PLACE\" and \"BLUE_GREEN\". Valid deployment options include \"WITH_TRAFFIC_CONTROL\" and \"WITHOUT_TRAFFIC_CONTROL\".</p>",
"refs": {
}
},
@ -1078,6 +1090,11 @@
"refs": {
}
},
"InvalidFileExistsBehaviorException": {
"base": "<p>An invalid fileExistsBehavior option was specified to determine how AWS CodeDeploy handles files or directories that already exist in a deployment target location but weren't part of the previous successful deployment. Valid values include \"DISALLOW\", \"OVERWRITE\", and \"RETAIN\".</p>",
"refs": {
}
},
"InvalidIamSessionArnException": {
"base": "<p>The IAM session ARN was specified in an invalid format.</p>",
"refs": {
@ -1304,12 +1321,12 @@
}
},
"LoadBalancerInfo": {
"base": "<p>Information about the load balancer used in a blue/green deployment.</p>",
"base": "<p>Information about the load balancer used in a deployment.</p>",
"refs": {
"CreateDeploymentGroupInput$loadBalancerInfo": "<p>Information about the load balancer used in a blue/green deployment.</p>",
"DeploymentGroupInfo$loadBalancerInfo": "<p>Information about the load balancer to use in a blue/green deployment.</p>",
"DeploymentInfo$loadBalancerInfo": "<p>Information about the load balancer used in this blue/green deployment.</p>",
"UpdateDeploymentGroupInput$loadBalancerInfo": "<p>Information about the load balancer used in a blue/green deployment.</p>"
"CreateDeploymentGroupInput$loadBalancerInfo": "<p>Information about the load balancer used in a deployment.</p>",
"DeploymentGroupInfo$loadBalancerInfo": "<p>Information about the load balancer to use in a deployment.</p>",
"DeploymentInfo$loadBalancerInfo": "<p>Information about the load balancer used in the deployment.</p>",
"UpdateDeploymentGroupInput$loadBalancerInfo": "<p>Information about the load balancer used in a deployment.</p>"
}
},
"LogTail": {
@ -1334,7 +1351,7 @@
"MinimumHealthyHostsType": {
"base": null,
"refs": {
"MinimumHealthyHosts$type": "<p>The minimum healthy instance type:</p> <ul> <li> <p>HOST_COUNT: The minimum number of healthy instance as an absolute value.</p> </li> <li> <p>FLEET_PERCENT: The minimum number of healthy instance as a percentage of the total number of instance in the deployment.</p> </li> </ul> <p>In an example of nine instance, if a HOST_COUNT of six is specified, deploy to up to three instances at a time. The deployment will be successful if six or more instances are deployed to successfully; otherwise, the deployment fails. If a FLEET_PERCENT of 40 is specified, deploy to up to five instance at a time. The deployment will be successful if four or more instance are deployed to successfully; otherwise, the deployment fails.</p> <note> <p>In a call to the get deployment configuration operation, CodeDeployDefault.OneAtATime will return a minimum healthy instance type of MOST_CONCURRENCY and a value of 1. This means a deployment to only one instance at a time. (You cannot set the type to MOST_CONCURRENCY, only to HOST_COUNT or FLEET_PERCENT.) In addition, with CodeDeployDefault.OneAtATime, AWS CodeDeploy will try to ensure that all instances but one are kept in a healthy state during the deployment. Although this allows one instance at a time to be taken offline for a new deployment, it also means that if the deployment to the last instance fails, the overall deployment still succeeds.</p> </note>"
"MinimumHealthyHosts$type": "<p>The minimum healthy instance type:</p> <ul> <li> <p>HOST_COUNT: The minimum number of healthy instance as an absolute value.</p> </li> <li> <p>FLEET_PERCENT: The minimum number of healthy instance as a percentage of the total number of instance in the deployment.</p> </li> </ul> <p>In an example of nine instance, if a HOST_COUNT of six is specified, deploy to up to three instances at a time. The deployment will be successful if six or more instances are deployed to successfully; otherwise, the deployment fails. If a FLEET_PERCENT of 40 is specified, deploy to up to five instance at a time. The deployment will be successful if four or more instance are deployed to successfully; otherwise, the deployment fails.</p> <note> <p>In a call to the get deployment configuration operation, CodeDeployDefault.OneAtATime will return a minimum healthy instance type of MOST_CONCURRENCY and a value of 1. This means a deployment to only one instance at a time. (You cannot set the type to MOST_CONCURRENCY, only to HOST_COUNT or FLEET_PERCENT.) In addition, with CodeDeployDefault.OneAtATime, AWS CodeDeploy will try to ensure that all instances but one are kept in a healthy state during the deployment. Although this allows one instance at a time to be taken offline for a new deployment, it also means that if the deployment to the last instance fails, the overall deployment still succeeds.</p> </note> <p>For more information, see <a href=\"http://docs.aws.amazon.com/codedeploy/latest/userguide/instances-health.html\">AWS CodeDeploy Instance Health</a> in the <i>AWS CodeDeploy User Guide</i>.</p>"
}
},
"MinimumHealthyHostsValue": {
@ -1422,6 +1439,7 @@
"refs": {
"CreateDeploymentInput$revision": "<p>The type and location of the revision to deploy.</p>",
"DeploymentGroupInfo$targetRevision": "<p>Information about the deployment group's target revision, including type and location.</p>",
"DeploymentInfo$previousRevision": "<p>Information about the application revision that was deployed to the deployment group before the most recent successful deployment.</p>",
"DeploymentInfo$revision": "<p>Information about the location of stored application artifacts and the service from which to retrieve them.</p>",
"GetApplicationRevisionInput$revision": "<p>Information about the application revision to get, including type and location.</p>",
"GetApplicationRevisionOutput$revision": "<p>Additional information about the revision, including type and location.</p>",
@ -1535,7 +1553,7 @@
"TagFilterList": {
"base": null,
"refs": {
"CreateDeploymentGroupInput$onPremisesInstanceTagFilters": "<p>The on-premises instance tags on which to filter.</p>",
"CreateDeploymentGroupInput$onPremisesInstanceTagFilters": "<p>The on-premises instance tags on which to filter. The deployment group will include on-premises instances with any of the specified tags.</p>",
"DeploymentGroupInfo$onPremisesInstanceTagFilters": "<p>The on-premises instance tags on which to filter.</p>",
"ListOnPremisesInstancesInput$tagFilters": "<p>The on-premises instance tags that will be used to restrict the corresponding on-premises instance names returned.</p>",
"UpdateDeploymentGroupInput$onPremisesInstanceTagFilters": "<p>The replacement set of on-premises instance tags on which to filter, if you want to change them. To keep the existing tags, enter their names. To remove tags, do not enter any tag names.</p>"

22
vendor/github.com/aws/aws-sdk-go/models/apis/events/2015-10-07/docs-2.json generated vendored
View File

@ -11,8 +11,8 @@
"ListTargetsByRule": "<p>Lists the targets assigned to the specified rule.</p>",
"PutEvents": "<p>Sends custom events to Amazon CloudWatch Events so that they can be matched to rules.</p>",
"PutRule": "<p>Creates or updates the specified rule. Rules are enabled by default, or based on value of the state. You can disable a rule using <a>DisableRule</a>.</p> <p>When you create or update a rule, incoming events might not immediately start matching to new or updated rules. Please allow a short period of time for changes to take effect.</p> <p>A rule must contain at least an EventPattern or ScheduleExpression. Rules with EventPatterns are triggered when a matching event is observed. Rules with ScheduleExpressions self-trigger based on the given schedule. A rule can have both an EventPattern and a ScheduleExpression, in which case the rule triggers on matching events as well as on a schedule.</p> <p>Most services in AWS treat : or / as the same character in Amazon Resource Names (ARNs). However, CloudWatch Events uses an exact match in event patterns and rules. Be sure to use the correct ARN characters when creating event patterns so that they match the ARN syntax in the event you want to match.</p>",
"PutTargets": "<p>Adds the specified targets to the specified rule, or updates the targets if they are already associated with the rule.</p> <p>Targets are the resources that are invoked when a rule is triggered. Example targets include EC2 instances, AWS Lambda functions, Amazon Kinesis streams, Amazon ECS tasks, AWS Step Functions state machines, and built-in targets. Note that creating rules with built-in targets is supported only in the AWS Management Console.</p> <p>For some target types, <code>PutTargets</code> provides target-specific parameters. If the target is an Amazon Kinesis stream, you can optionally specify which shard the event goes to by using the <code>KinesisParameters</code> argument. To invoke a command on multiple EC2 instances with one rule, you can use the <code>RunCommandParameters</code> field.</p> <p>To be able to make API calls against the resources that you own, Amazon CloudWatch Events needs the appropriate permissions. For AWS Lambda and Amazon SNS resources, CloudWatch Events relies on resource-based policies. For EC2 instances, Amazon Kinesis streams, and AWS Step Functions state machines, CloudWatch Events relies on IAM roles that you specify in the <code>RoleARN</code> argument in <code>PutTarget</code>. For more information, see <a href=\"http://docs.aws.amazon.com/AmazonCloudWatch/latest/events/auth-and-access-control-cwe.html\">Authentication and Access Control</a> in the <i>Amazon CloudWatch Events User Guide</i>.</p> <p> <b>Input</b>, <b>InputPath</b> and <b>InputTransformer</b> are mutually exclusive and optional parameters of a target. When a rule is triggered due to a matched event:</p> <ul> <li> <p>If none of the following arguments are specified for a target, then the entire event is passed to the target in JSON form (unless the target is Amazon EC2 Run Command or Amazon ECS task, in which case nothing from the event is passed to the target).</p> </li> <li> <p>If <b>Input</b> is specified in the form of valid JSON, then the matched event is overridden with this constant.</p> </li> <li> <p>If <b>InputPath</b> is specified in the form of JSONPath (for example, <code>$.detail</code>), then only the part of the event specified in the path is passed to the target (for example, only the detail part of the event is passed). </p> </li> <li> <p>If <b>InputTransformer</b> is specified, then one or more specified JSONPaths are extracted from the event and used as values in a template that you specify as the input to the target.</p> </li> </ul> <p>When you add targets to a rule and the associated rule triggers soon after, new or updated targets might not be immediately invoked. Please allow a short period of time for changes to take effect.</p>",
"RemoveTargets": "<p>Removes the specified targets from the specified rule. When the rule is triggered, those targets are no longer be invoked.</p> <p>When you remove a target, when the associated rule triggers, removed targets might continue to be invoked. Please allow a short period of time for changes to take effect.</p>",
"PutTargets": "<p>Adds the specified targets to the specified rule, or updates the targets if they are already associated with the rule.</p> <p>Targets are the resources that are invoked when a rule is triggered. Example targets include EC2 instances, AWS Lambda functions, Amazon Kinesis streams, Amazon ECS tasks, AWS Step Functions state machines, and built-in targets. Note that creating rules with built-in targets is supported only in the AWS Management Console.</p> <p>For some target types, <code>PutTargets</code> provides target-specific parameters. If the target is an Amazon Kinesis stream, you can optionally specify which shard the event goes to by using the <code>KinesisParameters</code> argument. To invoke a command on multiple EC2 instances with one rule, you can use the <code>RunCommandParameters</code> field.</p> <p>To be able to make API calls against the resources that you own, Amazon CloudWatch Events needs the appropriate permissions. For AWS Lambda and Amazon SNS resources, CloudWatch Events relies on resource-based policies. For EC2 instances, Amazon Kinesis streams, and AWS Step Functions state machines, CloudWatch Events relies on IAM roles that you specify in the <code>RoleARN</code> argument in <code>PutTarget</code>. For more information, see <a href=\"http://docs.aws.amazon.com/AmazonCloudWatch/latest/events/auth-and-access-control-cwe.html\">Authentication and Access Control</a> in the <i>Amazon CloudWatch Events User Guide</i>.</p> <p> <b>Input</b>, <b>InputPath</b> and <b>InputTransformer</b> are mutually exclusive and optional parameters of a target. When a rule is triggered due to a matched event:</p> <ul> <li> <p>If none of the following arguments are specified for a target, then the entire event is passed to the target in JSON form (unless the target is Amazon EC2 Run Command or Amazon ECS task, in which case nothing from the event is passed to the target).</p> </li> <li> <p>If <b>Input</b> is specified in the form of valid JSON, then the matched event is overridden with this constant.</p> </li> <li> <p>If <b>InputPath</b> is specified in the form of JSONPath (for example, <code>$.detail</code>), then only the part of the event specified in the path is passed to the target (for example, only the detail part of the event is passed).</p> </li> <li> <p>If <b>InputTransformer</b> is specified, then one or more specified JSONPaths are extracted from the event and used as values in a template that you specify as the input to the target.</p> </li> </ul> <p>When you specify <code>Input</code>, <code>InputPath</code>, or <code>InputTransformer</code>, you must use JSON dot notation, not bracket notation.</p> <p>When you add targets to a rule and the associated rule triggers soon after, new or updated targets might not be immediately invoked. Please allow a short period of time for changes to take effect.</p> <p>This action can partially fail if too many requests are made at the same time. If that happens, <code>FailedEntryCount</code> is non-zero in the response and each entry in <code>FailedEntries</code> provides the ID of the failed target and the error code.</p>",
"RemoveTargets": "<p>Removes the specified targets from the specified rule. When the rule is triggered, those targets are no longer be invoked.</p> <p>When you remove a target, when the associated rule triggers, removed targets might continue to be invoked. Please allow a short period of time for changes to take effect.</p> <p>This action can partially fail if too many requests are made at the same time. If that happens, <code>FailedEntryCount</code> is non-zero in the response and each entry in <code>FailedEntries</code> provides the ID of the failed target and the error code.</p>",
"TestEventPattern": "<p>Tests whether the specified event pattern matches the provided event.</p> <p>Most services in AWS treat : or / as the same character in Amazon Resource Names (ARNs). However, CloudWatch Events uses an exact match in event patterns and rules. Be sure to use the correct ARN characters when creating event patterns so that they match the ARN syntax in the event you want to match.</p>"
},
"shapes": {
@ -68,8 +68,8 @@
"base": null,
"refs": {
"PutEventsResultEntry$ErrorCode": "<p>The error code that indicates why the event submission failed.</p>",
"PutTargetsResultEntry$ErrorCode": "<p>The error code that indicates why the target addition failed.</p>",
"RemoveTargetsResultEntry$ErrorCode": "<p>The error code that indicates why the target removal failed.</p>"
"PutTargetsResultEntry$ErrorCode": "<p>The error code that indicates why the target addition failed. If the value is <code>ConcurrentModificationException</code>, too many requests were made at the same time.</p>",
"RemoveTargetsResultEntry$ErrorCode": "<p>The error code that indicates why the target removal failed. If the value is <code>ConcurrentModificationException</code>, too many requests were made at the same time.</p>"
}
},
"ErrorMessage": {
@ -89,10 +89,10 @@
"EventPattern": {
"base": null,
"refs": {
"DescribeRuleResponse$EventPattern": "<p>The event pattern.</p>",
"PutRuleRequest$EventPattern": "<p>The event pattern.</p>",
"Rule$EventPattern": "<p>The event pattern of the rule.</p>",
"TestEventPatternRequest$EventPattern": "<p>The event pattern.</p>"
"DescribeRuleResponse$EventPattern": "<p>The event pattern. For more information, see <a href=\"http://docs.aws.amazon.com/AmazonCloudWatch/latest/events/CloudWatchEventsandEventPatterns.html\">Events and Event Patterns</a> in the <i>Amazon CloudWatch Events User Guide</i>.</p>",
"PutRuleRequest$EventPattern": "<p>The event pattern. For more information, see <a href=\"http://docs.aws.amazon.com/AmazonCloudWatch/latest/events/CloudWatchEventsandEventPatterns.html\">Events and Event Patterns</a> in the <i>Amazon CloudWatch Events User Guide</i>.</p>",
"Rule$EventPattern": "<p>The event pattern of the rule. For more information, see <a href=\"http://docs.aws.amazon.com/AmazonCloudWatch/latest/events/CloudWatchEventsandEventPatterns.html\">Events and Event Patterns</a> in the <i>Amazon CloudWatch Events User Guide</i>.</p>",
"TestEventPatternRequest$EventPattern": "<p>The event pattern. For more information, see <a href=\"http://docs.aws.amazon.com/AmazonCloudWatch/latest/events/CloudWatchEventsandEventPatterns.html\">Events and Event Patterns</a> in the <i>Amazon CloudWatch Events User Guide</i>.</p>"
}
},
"EventResource": {
@ -454,13 +454,13 @@
"TargetInput": {
"base": null,
"refs": {
"Target$Input": "<p>Valid JSON text passed to the target. In this case, nothing from the event itself is passed to the target. For more information, see <a href=\"http://www.rfc-editor.org/rfc/rfc7159.txt\">The JavaScript Object Notation (JSON) Data Interchange Format</a>.</p>"
"Target$Input": "<p>Valid JSON text passed to the target. In this case, nothing from the event itself is passed to the target. You must use JSON dot notation, not bracket notation. For more information, see <a href=\"http://www.rfc-editor.org/rfc/rfc7159.txt\">The JavaScript Object Notation (JSON) Data Interchange Format</a>.</p>"
}
},
"TargetInputPath": {
"base": null,
"refs": {
"Target$InputPath": "<p>The value of the JSONPath that is used for extracting part of the matched event when passing it to the target. For more information about JSON paths, see <a href=\"http://goessner.net/articles/JsonPath/\">JSONPath</a>.</p>",
"Target$InputPath": "<p>The value of the JSONPath that is used for extracting part of the matched event when passing it to the target. You must use JSON dot notation, not bracket notation. For more information about JSON paths, see <a href=\"http://goessner.net/articles/JsonPath/\">JSONPath</a>.</p>",
"TransformerPaths$value": null
}
},
@ -496,7 +496,7 @@
"TransformerPaths": {
"base": null,
"refs": {
"InputTransformer$InputPathsMap": "<p>Map of JSON paths to be extracted from the event. These are key-value pairs, where each value is a JSON path.</p>"
"InputTransformer$InputPathsMap": "<p>Map of JSON paths to be extracted from the event. These are key-value pairs, where each value is a JSON path. You must use JSON dot notation, not bracket notation.</p>"
}
}
}

39
vendor/github.com/aws/aws-sdk-go/models/apis/gamelift/2015-10-01/api-2.json generated vendored
View File

@ -91,7 +91,8 @@
"errors":[
{"shape":"InternalServiceException"},
{"shape":"InvalidRequestException"},
{"shape":"UnauthorizedException"}
{"shape":"UnauthorizedException"},
{"shape":"LimitExceededException"}
]
},
"CreatePlayerSession":{
@ -874,7 +875,8 @@
"EC2InboundPermissions":{"shape":"IpPermissionsList"},
"NewGameSessionProtectionPolicy":{"shape":"ProtectionPolicy"},
"RuntimeConfiguration":{"shape":"RuntimeConfiguration"},
"ResourceCreationLimitPolicy":{"shape":"ResourceCreationLimitPolicy"}
"ResourceCreationLimitPolicy":{"shape":"ResourceCreationLimitPolicy"},
"MetricGroups":{"shape":"MetricGroupList"}
}
},
"CreateFleetOutput":{
@ -1372,7 +1374,8 @@
"LogPaths":{"shape":"StringList"},
"NewGameSessionProtectionPolicy":{"shape":"ProtectionPolicy"},
"OperatingSystem":{"shape":"OperatingSystem"},
"ResourceCreationLimitPolicy":{"shape":"ResourceCreationLimitPolicy"}
"ResourceCreationLimitPolicy":{"shape":"ResourceCreationLimitPolicy"},
"MetricGroups":{"shape":"MetricGroupList"}
}
},
"FleetAttributesList":{
@ -1479,6 +1482,11 @@
"CreatorId":{"shape":"NonZeroAndMaxString"}
}
},
"GameSessionActivationTimeoutSeconds":{
"type":"integer",
"max":600,
"min":1
},
"GameSessionDetail":{
"type":"structure",
"members":{
@ -1774,15 +1782,33 @@
"NextToken":{"shape":"NonZeroAndMaxString"}
}
},
"MaxConcurrentGameSessionActivations":{
"type":"integer",
"max":2147483647,
"min":1
},
"MetricGroup":{
"type":"string",
"max":255,
"min":1
},
"MetricGroupList":{
"type":"list",
"member":{"shape":"MetricGroup"},
"max":1
},
"MetricName":{
"type":"string",
"enum":[
"ActivatingGameSessions",
"ActiveGameSessions",
"ActiveInstances",
"AvailableGameSessions",
"AvailablePlayerSessions",
"CurrentPlayerSessions",
"IdleInstances",
"PercentAvailableGameSessions",
"PercentIdleInstances",
"QueueDepth",
"WaitTime"
]
@ -2010,7 +2036,9 @@
"RuntimeConfiguration":{
"type":"structure",
"members":{
"ServerProcesses":{"shape":"ServerProcessList"}
"ServerProcesses":{"shape":"ServerProcessList"},
"MaxConcurrentGameSessionActivations":{"shape":"MaxConcurrentGameSessionActivations"},
"GameSessionActivationTimeoutSeconds":{"shape":"GameSessionActivationTimeoutSeconds"}
}
},
"S3Location":{
@ -2189,7 +2217,8 @@
"Name":{"shape":"NonZeroAndMaxString"},
"Description":{"shape":"NonZeroAndMaxString"},
"NewGameSessionProtectionPolicy":{"shape":"ProtectionPolicy"},
"ResourceCreationLimitPolicy":{"shape":"ResourceCreationLimitPolicy"}
"ResourceCreationLimitPolicy":{"shape":"ResourceCreationLimitPolicy"},
"MetricGroups":{"shape":"MetricGroupList"}
}
},
"UpdateFleetAttributesOutput":{

34
vendor/github.com/aws/aws-sdk-go/models/apis/gamelift/2015-10-01/docs-2.json generated vendored
View File

@ -4,7 +4,7 @@
"operations": {
"CreateAlias": "<p>Creates an alias and sets a target fleet. A fleet alias can be used in place of a fleet ID, such as when calling <code>CreateGameSession</code> from a game client or game service or adding destinations to a game session queue. By changing an alias's target fleet, you can switch your players to the new fleet without changing any other component. In production, this feature is particularly useful to redirect your player base seamlessly to the latest game server update. </p> <p>Amazon GameLift supports two types of routing strategies for aliases: simple and terminal. Use a simple alias to point to an active fleet. Use a terminal alias to display a message to incoming traffic instead of routing players to an active fleet. This option is useful when a game server is no longer supported but you want to provide better messaging than a standard 404 error.</p> <p>To create a fleet alias, specify an alias name, routing strategy, and optional description. If successful, a new alias record is returned, including an alias ID, which you can reference when creating a game session. To reassign the alias to another fleet ID, call <a>UpdateAlias</a>.</p>",
"CreateBuild": "<p>Creates a new Amazon GameLift build from a set of game server binary files stored in an Amazon Simple Storage Service (Amazon S3) location. When using this API call, you must create a <code>.zip</code> file containing all of the build files and store it in an Amazon S3 bucket under your AWS account. For help on packaging your build files and creating a build, see <a href=\"http://docs.aws.amazon.com/gamelift/latest/developerguide/gamelift-build-intro.html\">Uploading Your Game to Amazon GameLift</a>.</p> <important> <p>Use this API action ONLY if you are storing your game build files in an Amazon S3 bucket in your AWS account. To create a build using files stored in a directory, use the CLI command <a href=\"http://docs.aws.amazon.com/cli/latest/reference/gamelift/upload-build.html\"> <code>upload-build</code> </a>, which uploads the build files from a file location you specify and creates a build.</p> </important> <p>To create a new build using <code>CreateBuild</code>, identify the storage location and operating system of your game build. You also have the option of specifying a build name and version. If successful, this action creates a new build record with an unique build ID and in <code>INITIALIZED</code> status. Use the API call <a>DescribeBuild</a> to check the status of your build. A build must be in <code>READY</code> status before it can be used to create fleets to host your game.</p>",
"CreateFleet": "<p>Creates a new fleet to run your game servers. A fleet is a set of Amazon Elastic Compute Cloud (Amazon EC2) instances, each of which can run multiple server processes to host game sessions. You configure a fleet to create instances with certain hardware specifications (see <a href=\"http://aws.amazon.com/ec2/instance-types/\">Amazon EC2 Instance Types</a> for more information), and deploy a specified game build to each instance. A newly created fleet passes through several statuses; once it reaches the <code>ACTIVE</code> status, it can begin hosting game sessions.</p> <p>To create a new fleet, provide a fleet name, an EC2 instance type, and a build ID of the game build to deploy. You can also configure the new fleet with the following settings: (1) a runtime configuration describing what server processes to run on each instance in the fleet (required to create fleet), (2) access permissions for inbound traffic, (3) fleet-wide game session protection, and (4) the location of default log files for Amazon GameLift to upload and store.</p> <p>If the CreateFleet call is successful, Amazon GameLift performs the following tasks:</p> <ul> <li> <p>Creates a fleet record and sets the status to <code>NEW</code> (followed by other statuses as the fleet is activated).</p> </li> <li> <p>Sets the fleet's capacity to 1 \"desired\", which causes Amazon GameLift to start one new EC2 instance.</p> </li> <li> <p>Starts launching server processes on the instance. If the fleet is configured to run multiple server processes per instance, Amazon GameLift staggers each launch by a few seconds.</p> </li> <li> <p>Begins writing events to the fleet event log, which can be accessed in the Amazon GameLift console.</p> </li> <li> <p>Sets the fleet's status to <code>ACTIVE</code> once one server process in the fleet is ready to host a game session.</p> </li> </ul> <p>After a fleet is created, use the following actions to change fleet properties and configuration:</p> <ul> <li> <p> <a>UpdateFleetAttributes</a> -- Update fleet metadata, including name and description.</p> </li> <li> <p> <a>UpdateFleetCapacity</a> -- Increase or decrease the number of instances you want the fleet to maintain.</p> </li> <li> <p> <a>UpdateFleetPortSettings</a> -- Change the IP address and port ranges that allow access to incoming traffic.</p> </li> <li> <p> <a>UpdateRuntimeConfiguration</a> -- Change how server processes are launched in the fleet, including launch path, launch parameters, and the number of concurrent processes.</p> </li> <li> <p> <a>PutScalingPolicy</a> -- Create or update rules that are used to set the fleet's capacity (autoscaling).</p> </li> </ul>",
"CreateFleet": "<p>Creates a new fleet to run your game servers. A fleet is a set of Amazon Elastic Compute Cloud (Amazon EC2) instances, each of which can run multiple server processes to host game sessions. You configure a fleet to create instances with certain hardware specifications (see <a href=\"http://aws.amazon.com/ec2/instance-types/\">Amazon EC2 Instance Types</a> for more information), and deploy a specified game build to each instance. A newly created fleet passes through several statuses; once it reaches the <code>ACTIVE</code> status, it can begin hosting game sessions.</p> <p>To create a new fleet, you must specify the following: (1) fleet name, (2) build ID of an uploaded game build, (3) an EC2 instance type, and (4) a runtime configuration that describes which server processes to run on each instance in the fleet. (Although the runtime configuration is not a required parameter, the fleet cannot be successfully created without it.) You can also configure the new fleet with the following settings: fleet description, access permissions for inbound traffic, fleet-wide game session protection, and resource creation limit. If you use Amazon CloudWatch for metrics, you can add the new fleet to a metric group, which allows you to view aggregated metrics for a set of fleets. Once you specify a metric group, the new fleet's metrics are included in the metric group's data.</p> <p>If the CreateFleet call is successful, Amazon GameLift performs the following tasks:</p> <ul> <li> <p>Creates a fleet record and sets the status to <code>NEW</code> (followed by other statuses as the fleet is activated).</p> </li> <li> <p>Sets the fleet's capacity to 1 \"desired\", which causes Amazon GameLift to start one new EC2 instance.</p> </li> <li> <p>Starts launching server processes on the instance. If the fleet is configured to run multiple server processes per instance, Amazon GameLift staggers each launch by a few seconds.</p> </li> <li> <p>Begins writing events to the fleet event log, which can be accessed in the Amazon GameLift console.</p> </li> <li> <p>Sets the fleet's status to <code>ACTIVE</code> once one server process in the fleet is ready to host a game session.</p> </li> </ul> <p>After a fleet is created, use the following actions to change fleet properties and configuration:</p> <ul> <li> <p> <a>UpdateFleetAttributes</a> -- Update fleet metadata, including name and description.</p> </li> <li> <p> <a>UpdateFleetCapacity</a> -- Increase or decrease the number of instances you want the fleet to maintain.</p> </li> <li> <p> <a>UpdateFleetPortSettings</a> -- Change the IP address and port ranges that allow access to incoming traffic.</p> </li> <li> <p> <a>UpdateRuntimeConfiguration</a> -- Change how server processes are launched in the fleet, including launch path, launch parameters, and the number of concurrent processes.</p> </li> <li> <p> <a>PutScalingPolicy</a> -- Create or update rules that are used to set the fleet's capacity (autoscaling).</p> </li> </ul>",
"CreateGameSession": "<p>Creates a multiplayer game session for players. This action creates a game session record and assigns an available server process in the specified fleet to host the game session. A fleet must have an <code>ACTIVE</code> status before a game session can be created in it.</p> <p>To create a game session, specify either fleet ID or alias ID and indicate a maximum number of players to allow in the game session. You can also provide a name and game-specific properties for this game session. If successful, a <a>GameSession</a> object is returned containing game session properties, including a game session ID with the custom string you provided.</p> <p> <b>Idempotency tokens.</b> You can add a token that uniquely identifies game session requests. This is useful for ensuring that game session requests are idempotent. Multiple requests with the same idempotency token are processed only once; subsequent requests return the original result. All response values are the same with the exception of game session status, which may change.</p> <p> <b>Resource creation limits.</b> If you are creating a game session on a fleet with a resource creation limit policy in force, then you must specify a creator ID. Without this ID, Amazon GameLift has no way to evaluate the policy for this new game session request.</p> <p> By default, newly created game sessions allow new players to join. Use <a>UpdateGameSession</a> to change the game session's player session creation policy.</p> <p> <i>Available in Amazon GameLift Local.</i> </p>",
"CreateGameSessionQueue": "<p>Establishes a new queue for processing requests to place new game sessions. A queue identifies where new game sessions can be hosted -- by specifying a list of destinations (fleets or aliases) -- and how long requests can wait in the queue before timing out. You can set up a queue to try to place game sessions on fleets in multiple regions. To add placement requests to a queue, call <a>StartGameSessionPlacement</a> and reference the queue name.</p> <p> <b>Destination order.</b> When processing a request for a game session, Amazon GameLift tries each destination in order until it finds one with available resources to host the new game session. A queue's default order is determined by how destinations are listed. The default order is overridden when a game session placement request provides player latency information. Player latency information enables Amazon GameLift to prioritize destinations where players report the lowest average latency, as a result placing the new game session where the majority of players will have the best possible gameplay experience.</p> <p> <b>Player latency policies.</b> For placement requests containing player latency information, use player latency policies to protect individual players from very high latencies. With a latency cap, even when a destination can deliver a low latency for most players, the game is not placed where any individual player is reporting latency higher than a policy's maximum. A queue can have multiple latency policies, which are enforced consecutively starting with the policy with the lowest latency cap. Use multiple policies to gradually relax latency controls; for example, you might set a policy with a low latency cap for the first 60 seconds, a second policy with a higher cap for the next 60 seconds, etc. </p> <p>To create a new queue, provide a name, timeout value, a list of destinations and, if desired, a set of latency policies. If successful, a new queue object is returned.</p>",
"CreatePlayerSession": "<p>Adds a player to a game session and creates a player session record. Before a player can be added, a game session must have an <code>ACTIVE</code> status, have a creation policy of <code>ALLOW_ALL</code>, and have an open player slot. To add a group of players to a game session, use <a>CreatePlayerSessions</a>.</p> <p>To create a player session, specify a game session ID, player ID, and optionally a string of player data. If successful, the player is added to the game session and a new <a>PlayerSession</a> object is returned. Player sessions cannot be updated. </p> <p> <i>Available in Amazon GameLift Local.</i> </p>",
@ -39,7 +39,7 @@
"RequestUploadCredentials": "<p> <i>This API call is not currently in use. </i> Retrieves a fresh set of upload credentials and the assigned Amazon S3 storage location for a specific build. Valid credentials are required to upload your game build files to Amazon S3.</p>",
"ResolveAlias": "<p>Retrieves the fleet ID that a specified alias is currently pointing to.</p>",
"SearchGameSessions": "<p>Retrieves a set of game sessions that match a set of search criteria and sorts them in a specified order. Currently a game session search is limited to a single fleet. Search results include only game sessions that are in <code>ACTIVE</code> status. If you need to retrieve game sessions with a status other than active, use <a>DescribeGameSessions</a>. If you need to retrieve the protection policy for each game session, use <a>DescribeGameSessionDetails</a>.</p> <p>You can search or sort by the following game session attributes:</p> <ul> <li> <p> <b>gameSessionId</b> -- Unique identifier for the game session. You can use either a <code>GameSessionId</code> or <code>GameSessionArn</code> value. </p> </li> <li> <p> <b>gameSessionName</b> -- Name assigned to a game session. This value is set when requesting a new game session with <a>CreateGameSession</a> or updating with <a>UpdateGameSession</a>. Game session names do not need to be unique to a game session.</p> </li> <li> <p> <b>creationTimeMillis</b> -- Value indicating when a game session was created. It is expressed in Unix time as milliseconds.</p> </li> <li> <p> <b>playerSessionCount</b> -- Number of players currently connected to a game session. This value changes rapidly as players join the session or drop out.</p> </li> <li> <p> <b>maximumSessions</b> -- Maximum number of player sessions allowed for a game session. This value is set when requesting a new game session with <a>CreateGameSession</a> or updating with <a>UpdateGameSession</a>.</p> </li> <li> <p> <b>hasAvailablePlayerSessions</b> -- Boolean value indicating whether or not a game session has reached its maximum number of players. When searching with this attribute, the search value must be <code>true</code> or <code>false</code>. It is highly recommended that all search requests include this filter attribute to optimize search performance and return only sessions that players can join. </p> </li> </ul> <p>To search or sort, specify either a fleet ID or an alias ID, and provide a search filter expression, a sort expression, or both. Use the pagination parameters to retrieve results as a set of sequential pages. If successful, a collection of <a>GameSession</a> objects matching the request is returned.</p> <note> <p>Returned values for <code>playerSessionCount</code> and <code>hasAvailablePlayerSessions</code> change quickly as players join sessions and others drop out. Results should be considered a snapshot in time. Be sure to refresh search results often, and handle sessions that fill up before a player can join. </p> </note> <p> <i>Available in Amazon GameLift Local.</i> </p>",
"StartGameSessionPlacement": "<p>Places a request for a new game session in a queue (see <a>CreateGameSessionQueue</a>). When processing a placement request, Amazon GameLift searches for available resources on the queue's destinations, scanning each until it finds resources or the placement request times out. A game session placement request can also request player sessions. When a new game session is successfully created, Amazon GameLift creates a player session for each player included in the request.</p> <p>When placing a game session, by default Amazon GameLift tries each fleet in the order they are listed in the queue configuration. Ideally, a queue's destinations are listed in preference order. Alternatively, when requesting a game session with players, you can also provide latency data for each player in relevant regions. Latency data indicates the performance lag a player experiences when connected to a fleet in the region. Amazon GameLift uses latency data to reorder the list of destinations to place the game session in a region with minimal lag. If latency data is provided for multiple players, Amazon GameLift calculates each region's average lag for all players and reorders to get the best game play across all players. </p> <p>To place a new game session request, specify the queue name and a set of game session properties and settings. Also provide a unique ID (such as a UUID) for the placement. You'll use this ID to track the status of the placement request. Optionally, provide a set of IDs and player data for each player you want to join to the new game session. To optimize game play for the players, also provide latency data for all players. If successful, a new game session placement is created. To track the status of a placement request, call <a>DescribeGameSessionPlacement</a> and check the request's status. If the status is Fulfilled, a new game session has been created and a game session ARN and region are referenced. If the placement request times out, you have the option of resubmitting the request or retrying it with a different queue. </p>",
"StartGameSessionPlacement": "<p>Places a request for a new game session in a queue (see <a>CreateGameSessionQueue</a>). When processing a placement request, Amazon GameLift searches for available resources on the queue's destinations, scanning each until it finds resources or the placement request times out.</p> <p>A game session placement request can also request player sessions. When a new game session is successfully created, Amazon GameLift creates a player session for each player included in the request.</p> <p>When placing a game session, by default Amazon GameLift tries each fleet in the order they are listed in the queue configuration. Ideally, a queue's destinations are listed in preference order.</p> <p>Alternatively, when requesting a game session with players, you can also provide latency data for each player in relevant regions. Latency data indicates the performance lag a player experiences when connected to a fleet in the region. Amazon GameLift uses latency data to reorder the list of destinations to place the game session in a region with minimal lag. If latency data is provided for multiple players, Amazon GameLift calculates each region's average lag for all players and reorders to get the best game play across all players. </p> <p>To place a new game session request, specify the following:</p> <ul> <li> <p>The queue name and a set of game session properties and settings</p> </li> <li> <p>A unique ID (such as a UUID) for the placement. You use this ID to track the status of the placement request</p> </li> <li> <p>(Optional) A set of IDs and player data for each player you want to join to the new game session</p> </li> <li> <p>Latency data for all players (if you want to optimize game play for the players)</p> </li> </ul> <p>If successful, a new game session placement is created.</p> <p>To track the status of a placement request, call <a>DescribeGameSessionPlacement</a> and check the request's status. If the status is <code>Fulfilled</code>, a new game session has been created and a game session ARN and region are referenced. If the placement request times out, you can resubmit the request or retry it with a different queue. </p>",
"StopGameSessionPlacement": "<p>Cancels a game session placement that is in Pending status. To stop a placement, provide the placement ID values. If successful, the placement is moved to Cancelled status.</p>",
"UpdateAlias": "<p>Updates properties for a fleet alias. To update properties, specify the alias ID to be updated and provide the information to be changed. To reassign an alias to another fleet, provide an updated routing strategy. If successful, the updated alias record is returned.</p>",
"UpdateBuild": "<p>Updates metadata in a build record, including the build name and version. To update the metadata, specify the build ID to update and provide the new values. If successful, a build object containing the updated metadata is returned.</p>",
@ -90,7 +90,7 @@
"DescribeGameSessionsInput$GameSessionId": "<p>Unique identifier for the game session to retrieve. You can use either a <code>GameSessionId</code> or <code>GameSessionArn</code> value. </p>",
"DescribePlayerSessionsInput$GameSessionId": "<p>Unique identifier for the game session to retrieve player sessions for.</p>",
"FleetAttributes$FleetArn": "<p>Identifier for a fleet that is unique across all regions.</p>",
"GameSessionQueue$GameSessionQueueArn": "<p>Amazon Resource Name (<a href=\"http://docs.aws.amazon.com/docs.aws.amazon.com/AmazonS3/latest/dev/s3-arn-format.html\">ARN</a>) that is assigned to a game session queue and uniquely identifies it. Format is <code>arn:aws:gamelift:&lt;region&gt;::fleet/fleet-a1234567-b8c9-0d1e-2fa3-b45c6d7e8912</code>.</p>",
"GameSessionQueue$GameSessionQueueArn": "<p>Amazon Resource Name (<a href=\"http://docs.aws.amazon.com/AmazonS3/latest/dev/s3-arn-format.html\">ARN</a>) that is assigned to a game session queue and uniquely identifies it. Format is <code>arn:aws:gamelift:&lt;region&gt;::fleet/fleet-a1234567-b8c9-0d1e-2fa3-b45c6d7e8912</code>.</p>",
"GameSessionQueueDestination$DestinationArn": "<p>Amazon Resource Name (ARN) assigned to fleet or fleet alias. ARNs, which include a fleet ID or alias ID and a region name, provide a unique identifier across all regions. </p>",
"GetGameSessionLogUrlInput$GameSessionId": "<p>Unique identifier for the game session to get logs for.</p>",
"UpdateGameSessionInput$GameSessionId": "<p>Unique identifier for the game session to update.</p>"
@ -619,6 +619,12 @@
"UpdateGameSessionOutput$GameSession": "<p>Object that contains the updated game session metadata.</p>"
}
},
"GameSessionActivationTimeoutSeconds": {
"base": null,
"refs": {
"RuntimeConfiguration$GameSessionActivationTimeoutSeconds": "<p>Maximum amount of time (in seconds) that a game session can remain in status ACTIVATING. If the game session is not active before the timeout, activation is terminated and the game session status is changed to TERMINATED.</p>"
}
},
"GameSessionDetail": {
"base": "<p>A game session's properties plus the protection policy currently in force.</p>",
"refs": {
@ -877,6 +883,26 @@
"refs": {
}
},
"MaxConcurrentGameSessionActivations": {
"base": null,
"refs": {
"RuntimeConfiguration$MaxConcurrentGameSessionActivations": "<p>Maximum number of game sessions with status ACTIVATING to allow on an instance simultaneously. This setting limits the amount of instance resources that can be used for new game activations at any one time.</p>"
}
},
"MetricGroup": {
"base": null,
"refs": {
"MetricGroupList$member": null
}
},
"MetricGroupList": {
"base": null,
"refs": {
"CreateFleetInput$MetricGroups": "<p>Names of metric groups to add this fleet to. Use an existing metric group name to add this fleet to the group, or use a new name to create a new metric group. Currently, a fleet can only be included in one metric group at a time.</p>",
"FleetAttributes$MetricGroups": "<p>Names of metric groups that this fleet is included in. In Amazon CloudWatch, you can view metrics for an individual fleet or aggregated metrics for a fleets that are in a fleet metric group. Currently, a fleet can be included in only one metric group at a time.</p>",
"UpdateFleetAttributesInput$MetricGroups": "<p>Names of metric groups to include this fleet with. A fleet metric group is used in Amazon CloudWatch to aggregate metrics from multiple fleets. Use an existing metric group name to add this fleet to the group, or use a new name to create a new metric group. Currently, a fleet can only be included in one metric group at a time.</p>"
}
},
"MetricName": {
"base": null,
"refs": {
@ -1283,7 +1309,7 @@
"ServerProcessList": {
"base": null,
"refs": {
"RuntimeConfiguration$ServerProcesses": "<p>Collection of server process configurations describing what server processes to run on each instance in a fleet</p>"
"RuntimeConfiguration$ServerProcesses": "<p>Collection of server process configurations that describe which server processes to run on each instance in a fleet.</p>"
}
},
"StartGameSessionPlacementInput": {

92
vendor/github.com/aws/aws-sdk-go/models/apis/inspector/2016-02-16/api-2.json generated vendored
View File

@ -207,6 +207,23 @@
{"shape":"InvalidInputException"}
]
},
"GetAssessmentReport":{
"name":"GetAssessmentReport",
"http":{
"method":"POST",
"requestUri":"/"
},
"input":{"shape":"GetAssessmentReportRequest"},
"output":{"shape":"GetAssessmentReportResponse"},
"errors":[
{"shape":"InternalException"},
{"shape":"InvalidInputException"},
{"shape":"AccessDeniedException"},
{"shape":"NoSuchEntityException"},
{"shape":"AssessmentRunInProgressException"},
{"shape":"UnsupportedFeatureException"}
]
},
"GetTelemetryMetadata":{
"name":"GetTelemetryMetadata",
"http":{
@ -656,7 +673,8 @@
"stateChangedAt",
"dataCollected",
"stateChanges",
"notifications"
"notifications",
"findingCounts"
],
"members":{
"arn":{"shape":"Arn"},
@ -672,7 +690,8 @@
"stateChangedAt":{"shape":"Timestamp"},
"dataCollected":{"shape":"Bool"},
"stateChanges":{"shape":"AssessmentRunStateChangeList"},
"notifications":{"shape":"AssessmentRunNotificationList"}
"notifications":{"shape":"AssessmentRunNotificationList"},
"findingCounts":{"shape":"AssessmentRunFindingCounts"}
}
},
"AssessmentRunAgent":{
@ -717,6 +736,11 @@
"stateChangeTimeRange":{"shape":"TimestampRange"}
}
},
"AssessmentRunFindingCounts":{
"type":"map",
"key":{"shape":"Severity"},
"value":{"shape":"FindingCount"}
},
"AssessmentRunInProgressArnList":{
"type":"list",
"member":{"shape":"Arn"},
@ -790,8 +814,10 @@
"COLLECTING_DATA",
"STOP_DATA_COLLECTION_PENDING",
"DATA_COLLECTED",
"START_EVALUATING_RULES_PENDING",
"EVALUATING_RULES",
"FAILED",
"ERROR",
"COMPLETED",
"COMPLETED_WITH_ERRORS"
]
@ -1248,6 +1274,7 @@
"updatedAt":{"shape":"Timestamp"}
}
},
"FindingCount":{"type":"integer"},
"FindingFilter":{
"type":"structure",
"members":{
@ -1269,9 +1296,30 @@
"FindingList":{
"type":"list",
"member":{"shape":"Finding"},
"max":10,
"max":100,
"min":0
},
"GetAssessmentReportRequest":{
"type":"structure",
"required":[
"assessmentRunArn",
"reportFileFormat",
"reportType"
],
"members":{
"assessmentRunArn":{"shape":"Arn"},
"reportFileFormat":{"shape":"ReportFileFormat"},
"reportType":{"shape":"ReportType"}
}
},
"GetAssessmentReportResponse":{
"type":"structure",
"required":["status"],
"members":{
"status":{"shape":"ReportStatus"},
"url":{"shape":"Url"}
}
},
"GetTelemetryMetadataRequest":{
"type":"structure",
"required":["assessmentRunArn"],
@ -1710,6 +1758,28 @@
"failedItems":{"shape":"FailedItems"}
}
},
"ReportFileFormat":{
"type":"string",
"enum":[
"HTML",
"PDF"
]
},
"ReportStatus":{
"type":"string",
"enum":[
"WORK_IN_PROGRESS",
"FAILED",
"COMPLETED"
]
},
"ReportType":{
"type":"string",
"enum":[
"FINDING",
"FULL"
]
},
"ResourceGroup":{
"type":"structure",
"required":[
@ -1931,6 +2001,18 @@
"topicArn":{"shape":"Arn"}
}
},
"UnsupportedFeatureException":{
"type":"structure",
"required":[
"message",
"canRetry"
],
"members":{
"message":{"shape":"ErrorMessage"},
"canRetry":{"shape":"Bool"}
},
"exception":true
},
"UpdateAssessmentTargetRequest":{
"type":"structure",
"required":[
@ -1944,6 +2026,10 @@
"resourceGroupArn":{"shape":"Arn"}
}
},
"Url":{
"type":"string",
"max":2048
},
"UserAttributeKeyList":{
"type":"list",
"member":{"shape":"AttributeKey"},

64
vendor/github.com/aws/aws-sdk-go/models/apis/inspector/2016-02-16/docs-2.json generated vendored
View File

@ -16,6 +16,7 @@
"DescribeFindings": "<p>Describes the findings that are specified by the ARNs of the findings.</p>",
"DescribeResourceGroups": "<p>Describes the resource groups that are specified by the ARNs of the resource groups.</p>",
"DescribeRulesPackages": "<p>Describes the rules packages that are specified by the ARNs of the rules packages.</p>",
"GetAssessmentReport": "<p>Produces an assessment report that includes detailed and comprehensive results of a specified assessment run. </p>",
"GetTelemetryMetadata": "<p>Information about the data that is collected for the specified assessment run.</p>",
"ListAssessmentRunAgents": "<p>Lists the agents of the assessment runs that are specified by the ARNs of the assessment runs.</p>",
"ListAssessmentRuns": "<p>Lists the assessment runs that correspond to the assessment templates that are specified by the ARNs of the assessment templates.</p>",
@ -176,6 +177,7 @@
"FailedItems$key": null,
"FilterRulesPackageArnList$member": null,
"Finding$arn": "<p>The ARN that specifies the finding.</p>",
"GetAssessmentReportRequest$assessmentRunArn": "<p>The ARN that specifies the assessment run for which you want to generate a report.</p>",
"GetTelemetryMetadataRequest$assessmentRunArn": "<p>The ARN that specifies the assessment run that has the telemetry data that you want to obtain.</p>",
"InspectorServiceAttributes$assessmentRunArn": "<p>The ARN of the assessment run during which the finding is generated.</p>",
"InspectorServiceAttributes$rulesPackageArn": "<p>The ARN of the rules package that is used to generate the finding.</p>",
@ -242,6 +244,12 @@
"ListAssessmentRunsRequest$filter": "<p>You can use this parameter to specify a subset of data to be included in the action's response.</p> <p>For a record to match a filter, all specified filter attributes must match. When multiple values are specified for a filter attribute, any of the values can match.</p>"
}
},
"AssessmentRunFindingCounts": {
"base": null,
"refs": {
"AssessmentRun$findingCounts": "<p>Provides a total count of generated findings per severity.</p>"
}
},
"AssessmentRunInProgressArnList": {
"base": null,
"refs": {
@ -451,7 +459,8 @@
"InvalidCrossAccountRoleException$canRetry": "<p>You can immediately retry your request.</p>",
"InvalidInputException$canRetry": "<p>You can immediately retry your request.</p>",
"LimitExceededException$canRetry": "<p>You can immediately retry your request.</p>",
"NoSuchEntityException$canRetry": "<p>You can immediately retry your request.</p>"
"NoSuchEntityException$canRetry": "<p>You can immediately retry your request.</p>",
"UnsupportedFeatureException$canRetry": null
}
},
"CreateAssessmentTargetRequest": {
@ -581,7 +590,8 @@
"InvalidCrossAccountRoleException$message": "<p>Details of the exception error.</p>",
"InvalidInputException$message": "<p>Details of the exception error.</p>",
"LimitExceededException$message": "<p>Details of the exception error.</p>",
"NoSuchEntityException$message": "<p>Details of the exception error.</p>"
"NoSuchEntityException$message": "<p>Details of the exception error.</p>",
"UnsupportedFeatureException$message": null
}
},
"EventSubscription": {
@ -635,6 +645,12 @@
"FindingList$member": null
}
},
"FindingCount": {
"base": null,
"refs": {
"AssessmentRunFindingCounts$value": null
}
},
"FindingFilter": {
"base": "<p>This data type is used as a request parameter in the <a>ListFindings</a> action.</p>",
"refs": {
@ -653,6 +669,16 @@
"DescribeFindingsResponse$findings": "<p>Information about the finding.</p>"
}
},
"GetAssessmentReportRequest": {
"base": null,
"refs": {
}
},
"GetAssessmentReportResponse": {
"base": null,
"refs": {
}
},
"GetTelemetryMetadataRequest": {
"base": null,
"refs": {
@ -681,7 +707,7 @@
"InspectorServiceAttributes": {
"base": "<p>This data type is used in the <a>Finding</a> data type.</p>",
"refs": {
"Finding$serviceAttributes": null
"Finding$serviceAttributes": "<p>This data type is used in the <a>Finding</a> data type.</p>"
}
},
"InternalException": {
@ -873,7 +899,7 @@
"base": null,
"refs": {
"AssessmentRunAgent$agentHealthDetails": "<p>The description for the agent health code.</p>",
"AssessmentRunNotification$message": null
"AssessmentRunNotification$message": "<p>The message included in the notification.</p>"
}
},
"MessageType": {
@ -973,6 +999,24 @@
"refs": {
}
},
"ReportFileFormat": {
"base": null,
"refs": {
"GetAssessmentReportRequest$reportFileFormat": "<p>Specifies the file format (html or pdf) of the assessment report that you want to generate.</p>"
}
},
"ReportStatus": {
"base": null,
"refs": {
"GetAssessmentReportResponse$status": "<p>Specifies the status of the request to generate an assessment report. </p>"
}
},
"ReportType": {
"base": null,
"refs": {
"GetAssessmentReportRequest$reportType": "<p>Specifies the type of the assessment report that you want to generate. There are two types of assessment reports: a finding report and a full report. For more information, see <a href=\"http://docs.aws.amazon.com/inspector/latest/userguide/inspector_reports.html\">Assessment Reports</a>. </p>"
}
},
"ResourceGroup": {
"base": "<p>Contains information about a resource group. The resource group defines a set of tags that, when queried, identify the AWS resources that make up the assessment target. This data type is used as the response element in the <a>DescribeResourceGroups</a> action.</p>",
"refs": {
@ -1042,6 +1086,7 @@
"Severity": {
"base": null,
"refs": {
"AssessmentRunFindingCounts$key": null,
"Finding$severity": "<p>The finding severity. Values can be set to High, Medium, Low, and Informational.</p>",
"SeverityList$member": null
}
@ -1168,11 +1213,22 @@
"refs": {
}
},
"UnsupportedFeatureException": {
"base": "<p>Used by the <a>GetAssessmentReport</a> API. The request was rejected because you tried to generate a report for an assessment run that existed before reporting was supported in Amazon Inspector. You can only generate reports for assessment runs that took place or will take place after generating reports in Amazon Inspector became available.</p>",
"refs": {
}
},
"UpdateAssessmentTargetRequest": {
"base": null,
"refs": {
}
},
"Url": {
"base": null,
"refs": {
"GetAssessmentReportResponse$url": "<p>Specifies the URL where you can find the generated assessment report. This parameter is only returned if the report is successfully generated.</p>"
}
},
"UserAttributeKeyList": {
"base": null,
"refs": {

7
vendor/github.com/aws/aws-sdk-go/models/apis/inspector/2016-02-16/examples-1.json generated vendored
View File

@ -168,6 +168,13 @@
"createdAt": "1458680170.035",
"dataCollected": true,
"durationInSeconds": 3600,
"findingCounts": {
"High": 14,
"Informational": 0,
"Low": 0,
"Medium": 2,
"Undefined": 0
},
"notifications": [
],

4
vendor/github.com/aws/aws-sdk-go/models/apis/inspector/2016-02-16/paginators-1.json generated vendored Normal file
View File

@ -0,0 +1,4 @@
{
"pagination": {
}
}

2
vendor/github.com/aws/aws-sdk-go/models/apis/kms/2014-11-01/docs-2.json generated vendored
View File

@ -737,7 +737,7 @@
"PrincipalIdType": {
"base": null,
"refs": {
"CreateGrantRequest$GranteePrincipal": "<p>The principal that is given permission to perform the operations that the grant permits.</p> <p>To specify the principal, use the <a href=\"http://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html\">Amazon Resource Name (ARN)</a> of an AWS principal. Valid AWS principals include AWS accounts (root), IAM users, federated users, and assumed role users. For examples of the ARN syntax to use for specifying a principal, see <a href=\"http://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html#arn-syntax-iam\">AWS Identity and Access Management (IAM)</a> in the Example ARNs section of the <i>AWS General Reference</i>.</p>",
"CreateGrantRequest$GranteePrincipal": "<p>The principal that is given permission to perform the operations that the grant permits.</p> <p>To specify the principal, use the <a href=\"http://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html\">Amazon Resource Name (ARN)</a> of an AWS principal. Valid AWS principals include AWS accounts (root), IAM users, IAM roles, federated users, and assumed role users. For examples of the ARN syntax to use for specifying a principal, see <a href=\"http://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html#arn-syntax-iam\">AWS Identity and Access Management (IAM)</a> in the Example ARNs section of the <i>AWS General Reference</i>.</p>",
"CreateGrantRequest$RetiringPrincipal": "<p>The principal that is given permission to retire the grant by using <a>RetireGrant</a> operation.</p> <p>To specify the principal, use the <a href=\"http://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html\">Amazon Resource Name (ARN)</a> of an AWS principal. Valid AWS principals include AWS accounts (root), IAM users, federated users, and assumed role users. For examples of the ARN syntax to use for specifying a principal, see <a href=\"http://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html#arn-syntax-iam\">AWS Identity and Access Management (IAM)</a> in the Example ARNs section of the <i>AWS General Reference</i>.</p>",
"GrantListEntry$GranteePrincipal": "<p>The principal that receives the grant's permissions.</p>",
"GrantListEntry$RetiringPrincipal": "<p>The principal that can retire the grant.</p>",

60
vendor/github.com/aws/aws-sdk-go/models/apis/lightsail/2016-11-28/api-2.json generated vendored
View File

@ -749,6 +749,24 @@
{"shape":"UnauthenticatedException"}
]
},
"PutInstancePublicPorts":{
"name":"PutInstancePublicPorts",
"http":{
"method":"POST",
"requestUri":"/"
},
"input":{"shape":"PutInstancePublicPortsRequest"},
"output":{"shape":"PutInstancePublicPortsResult"},
"errors":[
{"shape":"ServiceException"},
{"shape":"InvalidInputException"},
{"shape":"NotFoundException"},
{"shape":"OperationFailureException"},
{"shape":"AccessDeniedException"},
{"shape":"AccountSetupInProgressException"},
{"shape":"UnauthenticatedException"}
]
},
"RebootInstance":{
"name":"RebootInstance",
"http":{
@ -1375,7 +1393,7 @@
"GetInstancePortStatesResult":{
"type":"structure",
"members":{
"portStates":{"shape":"PortStateList"}
"portStates":{"shape":"InstancePortStateList"}
}
},
"GetInstanceRequest":{
@ -1654,6 +1672,19 @@
"type":"list",
"member":{"shape":"InstancePortInfo"}
},
"InstancePortState":{
"type":"structure",
"members":{
"fromPort":{"shape":"Port"},
"toPort":{"shape":"Port"},
"protocol":{"shape":"NetworkProtocol"},
"state":{"shape":"PortState"}
}
},
"InstancePortStateList":{
"type":"list",
"member":{"shape":"InstancePortState"}
},
"InstanceSnapshot":{
"type":"structure",
"members":{
@ -1898,6 +1929,7 @@
"StartInstance",
"RebootInstance",
"OpenInstancePublicPorts",
"PutInstancePublicPorts",
"CloseInstancePublicPorts",
"AllocateStaticIp",
"ReleaseStaticIp",
@ -1943,6 +1975,10 @@
"protocol":{"shape":"NetworkProtocol"}
}
},
"PortInfoList":{
"type":"list",
"member":{"shape":"PortInfo"}
},
"PortState":{
"type":"string",
"enum":[
@ -1950,9 +1986,22 @@
"closed"
]
},
"PortStateList":{
"type":"list",
"member":{"shape":"PortState"}
"PutInstancePublicPortsRequest":{
"type":"structure",
"required":[
"portInfos",
"instanceName"
],
"members":{
"portInfos":{"shape":"PortInfoList"},
"instanceName":{"shape":"ResourceName"}
}
},
"PutInstancePublicPortsResult":{
"type":"structure",
"members":{
"operation":{"shape":"Operation"}
}
},
"RebootInstanceRequest":{
"type":"structure",
@ -2039,7 +2088,8 @@
"message":{"shape":"string"},
"tip":{"shape":"string"}
},
"exception":true
"exception":true,
"fault":true
},
"StartInstanceRequest":{
"type":"structure",

55
vendor/github.com/aws/aws-sdk-go/models/apis/lightsail/2016-11-28/docs-2.json generated vendored
View File

@ -1,6 +1,6 @@
{
"version": "2.0",
"service": "<p>Amazon Lightsail is the easiest way to get started with AWS for developers who just need virtual private servers. Lightsail includes everything you need to launch your project quickly - a virtual machine, SSD-based storage, data transfer, DNS management, and a static IP - for a low, predictable price. You manage those Lightsail servers through the Lightsail console or by using the API or command-line interface (CLI).</p> <p>For more information about Lightsail concepts and tasks, see the <a href=\"http://lightsail.aws.amazon.com/ls/docs\">Lightsail Dev Guide</a>.</p> <p>To use the Lightsail API or the CLI, you will need to use AWS Identity and Access Management (IAM) to generate access keys. For details about how to set this up, see the <a href=\"http://lightsail.aws.amazon.com/ls/docs/how-to/articles/lightsail-how-to-set-up-access-keys-to-use-sdk-api-cli\">Lightsail Dev Guide</a>.</p>",
"service": "<p>Amazon Lightsail is the easiest way to get started with AWS for developers who just need virtual private servers. Lightsail includes everything you need to launch your project quickly - a virtual machine, SSD-based storage, data transfer, DNS management, and a static IP - for a low, predictable price. You manage those Lightsail servers through the Lightsail console or by using the API or command-line interface (CLI).</p> <p>For more information about Lightsail concepts and tasks, see the <a href=\"https://lightsail.aws.amazon.com/ls/docs/all\">Lightsail Dev Guide</a>.</p> <p>To use the Lightsail API or the CLI, you will need to use AWS Identity and Access Management (IAM) to generate access keys. For details about how to set this up, see the <a href=\"http://lightsail.aws.amazon.com/ls/docs/how-to/article/lightsail-how-to-set-up-access-keys-to-use-sdk-api-cli\">Lightsail Dev Guide</a>.</p>",
"operations": {
"AllocateStaticIp": "<p>Allocates a static IP address.</p>",
"AttachStaticIp": "<p>Attaches a static IP address to a specific Amazon Lightsail instance.</p>",
@ -36,13 +36,14 @@
"GetOperation": "<p>Returns information about a specific operation. Operations include events such as when you create an instance, allocate a static IP, attach a static IP, and so on.</p>",
"GetOperations": "<p>Returns information about all operations.</p> <p>Results are returned from oldest to newest, up to a maximum of 200. Results can be paged by making each subsequent call to <code>GetOperations</code> use the maximum (last) <code>statusChangedAt</code> value from the previous request.</p>",
"GetOperationsForResource": "<p>Gets operations for a specific resource (e.g., an instance or a static IP).</p>",
"GetRegions": "<p>Returns a list of all valid regions for Amazon Lightsail.</p>",
"GetRegions": "<p>Returns a list of all valid regions for Amazon Lightsail. Use the <code>include availability zones</code> parameter to also return the availability zones in a region.</p>",
"GetStaticIp": "<p>Returns information about a specific static IP.</p>",
"GetStaticIps": "<p>Returns information about all static IPs in the user's account.</p>",
"ImportKeyPair": "<p>Imports a public SSH key from a specific key pair.</p>",
"IsVpcPeered": "<p>Returns a Boolean value indicating whether your Lightsail VPC is peered.</p>",
"OpenInstancePublicPorts": "<p>Adds public ports to an Amazon Lightsail instance.</p>",
"PeerVpc": "<p>Tries to peer the Lightsail VPC with the user's default VPC.</p>",
"PutInstancePublicPorts": "<p>Sets the specified open ports for an Amazon Lightsail instance, and closes all ports for every protocol not included in the current request.</p>",
"RebootInstance": "<p>Restarts a specific instance. When your Amazon Lightsail instance is finished rebooting, Lightsail assigns a new public IP address. To use the same IP address after restarting, create a static IP address and attach it to the instance.</p>",
"ReleaseStaticIp": "<p>Deletes a specific static IP from your account.</p>",
"StartInstance": "<p>Starts a specific Amazon Lightsail instance from a stopped state. To restart an instance, use the reboot instance operation.</p>",
@ -96,7 +97,7 @@
"AvailabilityZoneList": {
"base": null,
"refs": {
"Region$availabilityZones": "<p>The Availability Zones.</p>"
"Region$availabilityZones": "<p>The Availability Zones. Follows the format <code>us-east-1a</code> (case-sensitive).</p>"
}
},
"Base64": {
@ -627,6 +628,18 @@
"InstanceNetworking$ports": "<p>An array of key-value pairs containing information about the ports on the instance.</p>"
}
},
"InstancePortState": {
"base": "<p>Describes the port state.</p>",
"refs": {
"InstancePortStateList$member": null
}
},
"InstancePortStateList": {
"base": null,
"refs": {
"GetInstancePortStatesResult$portStates": "<p>Information about the port states resulting from your request.</p>"
}
},
"InstanceSnapshot": {
"base": "<p>Describes the snapshot of the virtual private server, or <i>instance</i>.</p>",
"refs": {
@ -654,7 +667,7 @@
}
},
"InvalidInputException": {
"base": "<p>Lightsail throws this exception when user input does not conform to the validation rules of an input field.</p>",
"base": "<p>Lightsail throws this exception when user input does not conform to the validation rules of an input field.</p> <note> <p>Domain-related APIs are only available in the N. Virginia (us-east-1) Region. Please set your Region configuration to us-east-1 to create, view, or edit these resources.</p> </note>",
"refs": {
}
},
@ -757,14 +770,15 @@
"NetworkProtocol": {
"base": null,
"refs": {
"InstancePortInfo$protocol": "<p>The protocol. </p>",
"InstancePortInfo$protocol": "<p>The protocol being used. Can be one of the following.</p> <ul> <li> <p> <code>tcp</code> - Transmission Control Protocol (TCP) provides reliable, ordered, and error-checked delivery of streamed data between applications running on hosts communicating by an IP network. If you have an application that doesn't require reliable data stream service, use UDP instead.</p> </li> <li> <p> <code>all</code> - All transport layer protocol types. For more general information, see <a href=\"https://en.wikipedia.org/wiki/Transport_layer\">Transport layer</a> on Wikipedia.</p> </li> <li> <p> <code>udp</code> - With User Datagram Protocol (UDP), computer applications can send messages (or datagrams) to other hosts on an Internet Protocol (IP) network. Prior communications are not required to set up transmission channels or data paths. Applications that don't require reliable data stream service can use UDP, which provides a connectionless datagram service that emphasizes reduced latency over reliability. If you do require reliable data stream service, use TCP instead.</p> </li> </ul>",
"InstancePortState$protocol": "<p>The protocol being used. Can be one of the following.</p> <ul> <li> <p> <code>tcp</code> - Transmission Control Protocol (TCP) provides reliable, ordered, and error-checked delivery of streamed data between applications running on hosts communicating by an IP network. If you have an application that doesn't require reliable data stream service, use UDP instead.</p> </li> <li> <p> <code>all</code> - All transport layer protocol types. For more general information, see <a href=\"https://en.wikipedia.org/wiki/Transport_layer\">Transport layer</a> on Wikipedia.</p> </li> <li> <p> <code>udp</code> - With User Datagram Protocol (UDP), computer applications can send messages (or datagrams) to other hosts on an Internet Protocol (IP) network. Prior communications are not required to set up transmission channels or data paths. Applications that don't require reliable data stream service can use UDP, which provides a connectionless datagram service that emphasizes reduced latency over reliability. If you do require reliable data stream service, use TCP instead.</p> </li> </ul>",
"PortInfo$protocol": "<p>The protocol. </p>"
}
},
"NonEmptyString": {
"base": null,
"refs": {
"AvailabilityZone$zoneName": "<p>The name of the Availability Zone.</p>",
"AvailabilityZone$zoneName": "<p>The name of the Availability Zone. The format is <code>us-east-1a</code> (case-sensitive).</p>",
"AvailabilityZone$state": "<p>The state of the Availability Zone.</p>",
"Blueprint$blueprintId": "<p>The ID for the virtual private server image (e.g., <code>app_wordpress_4_4</code> or <code>app_lamp_7_0</code>).</p>",
"Blueprint$group": "<p>The group name of the blueprint (e.g., <code>amazon-linux</code>).</p>",
@ -818,6 +832,7 @@
"OpenInstancePublicPortsResult$operation": "<p>An array of key-value pairs containing information about the request operation.</p>",
"OperationList$member": null,
"PeerVpcResult$operation": "<p>An array of key-value pairs containing information about the request operation.</p>",
"PutInstancePublicPortsResult$operation": "<p>Describes metadata about the operation you just executed.</p>",
"UnpeerVpcResult$operation": "<p>An array of key-value pairs containing information about the request operation.</p>"
}
},
@ -873,6 +888,8 @@
"refs": {
"InstancePortInfo$fromPort": "<p>The first port in the range.</p>",
"InstancePortInfo$toPort": "<p>The last port in the range.</p>",
"InstancePortState$fromPort": "<p>The first port in the range.</p>",
"InstancePortState$toPort": "<p>The last port in the range.</p>",
"PortInfo$fromPort": "<p>The first port in the range.</p>",
"PortInfo$toPort": "<p>The last port in the range.</p>"
}
@ -887,19 +904,30 @@
"base": "<p>Describes information about the ports on your virtual private server (or <i>instance</i>).</p>",
"refs": {
"CloseInstancePublicPortsRequest$portInfo": "<p>Information about the public port you are trying to close.</p>",
"OpenInstancePublicPortsRequest$portInfo": "<p>An array of key-value pairs containing information about the port mappings.</p>"
"OpenInstancePublicPortsRequest$portInfo": "<p>An array of key-value pairs containing information about the port mappings.</p>",
"PortInfoList$member": null
}
},
"PortInfoList": {
"base": null,
"refs": {
"PutInstancePublicPortsRequest$portInfos": "<p>Specifies information about the public port(s).</p>"
}
},
"PortState": {
"base": null,
"refs": {
"PortStateList$member": null
"InstancePortState$state": "<p>Specifies whether the instance port is <code>open</code> or <code>closed</code>.</p>"
}
},
"PortStateList": {
"PutInstancePublicPortsRequest": {
"base": null,
"refs": {
}
},
"PutInstancePublicPortsResult": {
"base": null,
"refs": {
"GetInstancePortStatesResult$portStates": "<p>Information about the port states resulting from your request.</p>"
}
},
"RebootInstanceRequest": {
@ -992,6 +1020,7 @@
"KeyPair$name": "<p>The friendly name of the SSH key pair.</p>",
"OpenInstancePublicPortsRequest$instanceName": "<p>The name of the instance for which you want to open the public ports.</p>",
"Operation$resourceName": "<p>The resource name.</p>",
"PutInstancePublicPortsRequest$instanceName": "<p>The Lightsail instance name of the public port(s) you are setting.</p>",
"RebootInstanceRequest$instanceName": "<p>The name of the instance to reboot.</p>",
"ReleaseStaticIpRequest$staticIpName": "<p>The name of the static IP to delete.</p>",
"StartInstanceRequest$instanceName": "<p>The name of the instance (a virtual private server) to start.</p>",
@ -1152,9 +1181,9 @@
"Blueprint$licenseUrl": "<p>The end-user license agreement URL for the image or blueprint.</p>",
"Bundle$instanceType": "<p>The Amazon EC2 instance type (e.g., <code>t2.micro</code>).</p>",
"Bundle$name": "<p>A friendly name for the bundle (e.g., <code>Micro</code>).</p>",
"CreateInstancesFromSnapshotRequest$availabilityZone": "<p>The Availability Zone where you want to create your instances. Use the following formatting: <code>us-east-1a</code> (case sensitive).</p>",
"CreateInstancesFromSnapshotRequest$availabilityZone": "<p>The Availability Zone where you want to create your instances. Use the following formatting: <code>us-east-1a</code> (case sensitive). You can get a list of availability zones by using the <a href=\"http://docs.aws.amazon.com/lightsail/2016-11-28/api-reference/API_GetRegions.html\">get regions</a> operation. Be sure to add the <code>include availability zones</code> parameter to your request.</p>",
"CreateInstancesFromSnapshotRequest$userData": "<p>You can create a launch script that configures a server with additional user data. For example, <code>apt-get –y update</code>.</p> <note> <p>Depending on the machine image you choose, the command to get software on your instance varies. Amazon Linux and CentOS use <code>yum</code>, Debian and Ubuntu use <code>apt-get</code>, and FreeBSD uses <code>pkg</code>. For a complete list, see the <a href=\"http://lightsail.aws.amazon.com/ls/docs/getting-started/articles/pre-installed-apps\">Dev Guide</a>.</p> </note>",
"CreateInstancesRequest$availabilityZone": "<p>The Availability Zone in which to create your instance. Use the following format: <code>us-east-1a</code> (case sensitive).</p>",
"CreateInstancesRequest$availabilityZone": "<p>The Availability Zone in which to create your instance. Use the following format: <code>us-east-1a</code> (case sensitive). You can get a list of availability zones by using the <a href=\"http://docs.aws.amazon.com/lightsail/2016-11-28/api-reference/API_GetRegions.html\">get regions</a> operation. Be sure to add the <code>include availability zones</code> parameter to your request.</p>",
"CreateInstancesRequest$userData": "<p>A launch script you can create that configures a server with additional user data. For example, you might want to run <code>apt-get –y update</code>.</p> <note> <p>Depending on the machine image you choose, the command to get software on your instance varies. Amazon Linux and CentOS use <code>yum</code>, Debian and Ubuntu use <code>apt-get</code>, and FreeBSD uses <code>pkg</code>. For a complete list, see the <a href=\"http://lightsail.aws.amazon.com/ls/docs/getting-started/articles/pre-installed-apps\">Dev Guide</a>.</p> </note>",
"Disk$supportCode": "<p>The support code. Include this code in your email to support when you have questions about an instance or another resource in Lightsail. This code enables our support team to look up your Lightsail information more easily.</p>",
"Disk$path": "<p>The disk path.</p>",
@ -1214,7 +1243,7 @@
"Region$continentCode": "<p>The continent code (e.g., <code>NA</code>, meaning North America).</p>",
"Region$description": "<p>The description of the AWS Region (e.g., <code>This region is recommended to serve users in the eastern United States and eastern Canada</code>).</p>",
"Region$displayName": "<p>The display name (e.g., <code>Virginia</code>).</p>",
"ResourceLocation$availabilityZone": "<p>The Availability Zone.</p>",
"ResourceLocation$availabilityZone": "<p>The Availability Zone. Follows the format <code>us-east-1a</code> (case-sensitive).</p>",
"ServiceException$code": null,
"ServiceException$docs": null,
"ServiceException$message": null,

4
vendor/github.com/aws/aws-sdk-go/models/apis/lightsail/2016-11-28/paginators-1.json generated vendored Normal file
View File

@ -0,0 +1,4 @@
{
"pagination": {
}
}

28
vendor/github.com/aws/aws-sdk-go/models/apis/logs/2014-03-28/docs-2.json generated vendored
View File

@ -26,7 +26,7 @@
"PutLogEvents": "<p>Uploads a batch of log events to the specified log stream.</p> <p>You must include the sequence token obtained from the response of the previous call. An upload in a newly created log stream does not require a sequence token. You can also get the sequence token using <a>DescribeLogStreams</a>.</p> <p>The batch of events must satisfy the following constraints:</p> <ul> <li> <p>The maximum batch size is 1,048,576 bytes, and this size is calculated as the sum of all event messages in UTF-8, plus 26 bytes for each log event.</p> </li> <li> <p>None of the log events in the batch can be more than 2 hours in the future.</p> </li> <li> <p>None of the log events in the batch can be older than 14 days or the retention period of the log group.</p> </li> <li> <p>The log events in the batch must be in chronological ordered by their timestamp (the time the event occurred, expressed as the number of milliseconds since Jan 1, 1970 00:00:00 UTC).</p> </li> <li> <p>The maximum number of log events in a batch is 10,000.</p> </li> <li> <p>A batch of log events in a single request cannot span more than 24 hours. Otherwise, the operation fails.</p> </li> </ul>",
"PutMetricFilter": "<p>Creates or updates a metric filter and associates it with the specified log group. Metric filters allow you to configure rules to extract metric data from log events ingested through <a>PutLogEvents</a>.</p> <p>The maximum number of metric filters that can be associated with a log group is 100.</p>",
"PutRetentionPolicy": "<p>Sets the retention of the specified log group. A retention policy allows you to configure the number of days you want to retain log events in the specified log group.</p>",
"PutSubscriptionFilter": "<p>Creates or updates a subscription filter and associates it with the specified log group. Subscription filters allow you to subscribe to a real-time stream of log events ingested through <a>PutLogEvents</a> and have them delivered to a specific destination. Currently, the supported destinations are:</p> <ul> <li> <p>An Amazon Kinesis stream belonging to the same account as the subscription filter, for same-account delivery.</p> </li> <li> <p>A logical destination that belongs to a different account, for cross-account delivery.</p> </li> <li> <p>An Amazon Kinesis Firehose stream that belongs to the same account as the subscription filter, for same-account delivery.</p> </li> <li> <p>An AWS Lambda function that belongs to the same account as the subscription filter, for same-account delivery.</p> </li> </ul> <p>There can only be one subscription filter associated with a log group.</p>",
"PutSubscriptionFilter": "<p>Creates or updates a subscription filter and associates it with the specified log group. Subscription filters allow you to subscribe to a real-time stream of log events ingested through <a>PutLogEvents</a> and have them delivered to a specific destination. Currently, the supported destinations are:</p> <ul> <li> <p>An Amazon Kinesis stream belonging to the same account as the subscription filter, for same-account delivery.</p> </li> <li> <p>A logical destination that belongs to a different account, for cross-account delivery.</p> </li> <li> <p>An Amazon Kinesis Firehose stream that belongs to the same account as the subscription filter, for same-account delivery.</p> </li> <li> <p>An AWS Lambda function that belongs to the same account as the subscription filter, for same-account delivery.</p> </li> </ul> <p>There can only be one subscription filter associated with a log group. If you are updating an existing filter, you must specify the correct name in <code>filterName</code>. Otherwise, the call will fail because you cannot associate a second filter with a log group.</p>",
"TagLogGroup": "<p>Adds or updates the specified tags for the specified log group.</p> <p>To list the tags for a log group, use <a>ListTagsLogGroup</a>. To remove tags, use <a>UntagLogGroup</a>.</p> <p>For more information about tags, see <a href=\"http://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/log-group-tagging.html\">Tag Log Groups in Amazon CloudWatch Logs</a> in the <i>Amazon CloudWatch Logs User Guide</i>.</p>",
"TestMetricFilter": "<p>Tests the filter pattern of a metric filter against a sample of log event messages. You can use this operation to validate the correctness of a metric filter pattern.</p>",
"UntagLogGroup": "<p>Removes the specified tags from the specified log group.</p> <p>To list the tags for a log group, use <a>ListTagsLogGroup</a>. To add tags, use <a>UntagLogGroup</a>.</p>"
@ -361,7 +361,7 @@
"DescribeSubscriptionFiltersRequest$filterNamePrefix": "<p>The prefix to match. If you don't specify a value, no prefix filter is applied.</p>",
"MetricFilter$filterName": "<p>The name of the metric filter.</p>",
"PutMetricFilterRequest$filterName": "<p>A name for the metric filter.</p>",
"PutSubscriptionFilterRequest$filterName": "<p>A name for the subscription filter.</p>",
"PutSubscriptionFilterRequest$filterName": "<p>A name for the subscription filter. If you are updating an existing filter, you must specify the correct name in <code>filterName</code>. Otherwise, the call will fail because you cannot associate a second filter with a log group. To find the name of the filter currently associated with a log group, use <a>DescribeSubscriptionFilters</a>.</p>",
"SubscriptionFilter$filterName": "<p>The name of the subscription filter.</p>"
}
},
@ -622,7 +622,7 @@
"OrderBy": {
"base": null,
"refs": {
"DescribeLogStreamsRequest$orderBy": "<p>If the value is <code>LogStreamName</code>, the results are ordered by log stream name. If the value is <code>LastEventTime</code>, the results are ordered by the event time. The default value is <code>LogStreamName</code>.</p> <p>If you order the results by event time, you cannot specify the <code>logStreamNamePrefix</code> parameter.</p>"
"DescribeLogStreamsRequest$orderBy": "<p>If the value is <code>LogStreamName</code>, the results are ordered by log stream name. If the value is <code>LastEventTime</code>, the results are ordered by the event time. The default value is <code>LogStreamName</code>.</p> <p>If you order the results by event time, you cannot specify the <code>logStreamNamePrefix</code> parameter.</p> <p>lastEventTimestamp represents the time of the most recent log event in the log stream in CloudWatch Logs. This number is expressed as the number of milliseconds since Jan 1, 1970 00:00:00 UTC. lastEventTimeStamp updates on an eventual consistency basis. It typically updates in less than an hour from ingestion, but may take longer in some rare situations.</p>"
}
},
"OutputLogEvent": {
@ -814,27 +814,27 @@
"refs": {
"CreateExportTaskRequest$from": "<p>The start time of the range for the request, expressed as the number of milliseconds since Jan 1, 1970 00:00:00 UTC. Events with a timestamp earlier than this time are not exported.</p>",
"CreateExportTaskRequest$to": "<p>The end time of the range for the request, expressed as the number of milliseconds since Jan 1, 1970 00:00:00 UTC. Events with a timestamp later than this time are not exported.</p>",
"Destination$creationTime": "<p>The creation time of the destination.</p>",
"Destination$creationTime": "<p>The creation time of the destination, expressed as the number of milliseconds since Jan 1, 1970 00:00:00 UTC.</p>",
"ExportTask$from": "<p>The start time, expressed as the number of milliseconds since Jan 1, 1970 00:00:00 UTC. Events with a timestamp prior to this time are not exported.</p>",
"ExportTask$to": "<p>The end time, expressed as the number of milliseconds since Jan 1, 1970 00:00:00 UTC. Events with a timestamp later than this time are not exported.</p>",
"ExportTaskExecutionInfo$creationTime": "<p>The creation time of the export task.</p>",
"ExportTaskExecutionInfo$completionTime": "<p>The completion time of the export task.</p>",
"ExportTaskExecutionInfo$creationTime": "<p>The creation time of the export task, expressed as the number of milliseconds since Jan 1, 1970 00:00:00 UTC.</p>",
"ExportTaskExecutionInfo$completionTime": "<p>The completion time of the export task, expressed as the number of milliseconds since Jan 1, 1970 00:00:00 UTC.</p>",
"FilterLogEventsRequest$startTime": "<p>The start of the time range, expressed as the number of milliseconds since Jan 1, 1970 00:00:00 UTC. Events with a timestamp prior to this time are not returned.</p>",
"FilterLogEventsRequest$endTime": "<p>The end of the time range, expressed as the number of milliseconds since Jan 1, 1970 00:00:00 UTC. Events with a timestamp later than this time are not returned.</p>",
"FilteredLogEvent$timestamp": "<p>The time the event occurred, expressed as the number of milliseconds since Jan 1, 1970 00:00:00 UTC.</p>",
"FilteredLogEvent$ingestionTime": "<p>The time the event was ingested.</p>",
"FilteredLogEvent$ingestionTime": "<p>The time the event was ingested, expressed as the number of milliseconds since Jan 1, 1970 00:00:00 UTC.</p>",
"GetLogEventsRequest$startTime": "<p>The start of the time range, expressed as the number of milliseconds since Jan 1, 1970 00:00:00 UTC. Events with a timestamp earlier than this time are not included.</p>",
"GetLogEventsRequest$endTime": "<p>The end of the time range, expressed as the number of milliseconds since Jan 1, 1970 00:00:00 UTC. Events with a timestamp later than this time are not included.</p>",
"InputLogEvent$timestamp": "<p>The time the event occurred, expressed as the number of milliseconds since Jan 1, 1970 00:00:00 UTC.</p>",
"LogGroup$creationTime": "<p>The creation time of the log group.</p>",
"LogStream$creationTime": "<p>The creation time of the stream.</p>",
"LogGroup$creationTime": "<p>The creation time of the log group, expressed as the number of milliseconds since Jan 1, 1970 00:00:00 UTC.</p>",
"LogStream$creationTime": "<p>The creation time of the stream, expressed as the number of milliseconds since Jan 1, 1970 00:00:00 UTC.</p>",
"LogStream$firstEventTimestamp": "<p>The time of the first event, expressed as the number of milliseconds since Jan 1, 1970 00:00:00 UTC.</p>",
"LogStream$lastEventTimestamp": "<p>The time of the last event, expressed as the number of milliseconds since Jan 1, 1970 00:00:00 UTC.</p>",
"LogStream$lastIngestionTime": "<p>The ingestion time.</p>",
"MetricFilter$creationTime": "<p>The creation time of the metric filter.</p>",
"LogStream$lastEventTimestamp": "<p> the time of the most recent log event in the log stream in CloudWatch Logs. This number is expressed as the number of milliseconds since Jan 1, 1970 00:00:00 UTC. lastEventTime updates on an eventual consistency basis. It typically updates in less than an hour from ingestion, but may take longer in some rare situations.</p>",
"LogStream$lastIngestionTime": "<p>The ingestion time, expressed as the number of milliseconds since Jan 1, 1970 00:00:00 UTC.</p>",
"MetricFilter$creationTime": "<p>The creation time of the metric filter, expressed as the number of milliseconds since Jan 1, 1970 00:00:00 UTC.</p>",
"OutputLogEvent$timestamp": "<p>The time the event occurred, expressed as the number of milliseconds since Jan 1, 1970 00:00:00 UTC.</p>",
"OutputLogEvent$ingestionTime": "<p>The time the event was ingested.</p>",
"SubscriptionFilter$creationTime": "<p>The creation time of the subscription filter.</p>"
"OutputLogEvent$ingestionTime": "<p>The time the event was ingested, expressed as the number of milliseconds since Jan 1, 1970 00:00:00 UTC.</p>",
"SubscriptionFilter$creationTime": "<p>The creation time of the subscription filter, expressed as the number of milliseconds since Jan 1, 1970 00:00:00 UTC.</p>"
}
},
"Token": {

14
vendor/github.com/aws/aws-sdk-go/models/apis/logs/2014-03-28/paginators-1.json generated vendored
View File

@ -2,38 +2,38 @@
"pagination": {
"DescribeDestinations": {
"input_token": "nextToken",
"output_token": "nextToken",
"limit_key": "limit",
"output_token": "nextToken",
"result_key": "destinations"
},
"DescribeLogGroups": {
"input_token": "nextToken",
"output_token": "nextToken",
"limit_key": "limit",
"output_token": "nextToken",
"result_key": "logGroups"
},
"DescribeLogStreams": {
"input_token": "nextToken",
"output_token": "nextToken",
"limit_key": "limit",
"output_token": "nextToken",
"result_key": "logStreams"
},
"DescribeMetricFilters": {
"input_token": "nextToken",
"output_token": "nextToken",
"limit_key": "limit",
"output_token": "nextToken",
"result_key": "metricFilters"
},
"DescribeSubscriptionFilters": {
"input_token": "nextToken",
"output_token": "nextToken",
"limit_key": "limit",
"output_token": "nextToken",
"result_key": "subscriptionFilters"
},
"FilterLogEvents": {
"input_token": "nextToken",
"output_token": "nextToken",
"limit_key": "limit",
"output_token": "nextToken",
"result_key": [
"events",
"searchedLogStreams"
@ -41,8 +41,8 @@
},
"GetLogEvents": {
"input_token": "nextToken",
"output_token": "nextForwardToken",
"limit_key": "limit",
"output_token": "nextForwardToken",
"result_key": "events"
}
}

3
vendor/github.com/aws/aws-sdk-go/models/apis/polly/2016-06-10/api-2.json generated vendored
View File

@ -526,7 +526,8 @@
"Maxim",
"Tatyana",
"Astrid",
"Filiz"
"Filiz",
"Vicki"
]
},
"VoiceList":{

9
vendor/github.com/aws/aws-sdk-go/models/apis/resourcegroupstaggingapi/2017-01-26/api-2.json generated vendored
View File

@ -119,10 +119,10 @@
},
"GetResourcesInput":{
"type":"structure",
"required":["TagsPerPage"],
"members":{
"PaginationToken":{"shape":"PaginationToken"},
"TagFilters":{"shape":"TagFilterList"},
"ResourcesPerPage":{"shape":"ResourcesPerPage"},
"TagsPerPage":{"shape":"TagsPerPage"},
"ResourceTypeFilters":{"shape":"ResourceTypeFilterList"}
}
@ -215,6 +215,7 @@
"type":"list",
"member":{"shape":"AmazonResourceType"}
},
"ResourcesPerPage":{"type":"integer"},
"StatusCode":{"type":"integer"},
"Tag":{
"type":"structure",
@ -298,11 +299,7 @@
"type":"list",
"member":{"shape":"TagValue"}
},
"TagsPerPage":{
"type":"integer",
"max":500,
"min":100
},
"TagsPerPage":{"type":"integer"},
"ThrottledException":{
"type":"structure",
"members":{

8
vendor/github.com/aws/aws-sdk-go/models/apis/resourcegroupstaggingapi/2017-01-26/docs-2.json generated vendored
View File

@ -1,6 +1,6 @@
{
"version": "2.0",
"service": "<fullname>Resource Groups Tagging API</fullname> <p>This guide describes the API operations for the resource groups tagging.</p> <p>A tag is a label that you assign to an AWS resource. A tag consists of a key and a value, both of which you define. For example, if you have two Amazon EC2 instances, you might assign both a tag key of \"Stack.\" But the value of \"Stack\" might be \"Testing\" for one and \"Production\" for the other.</p> <p>Tagging can help you organize your resources and enables you to simplify resource management, access management and cost allocation. For more information about tagging, see <a href=\"http://docs.aws.amazon.com/awsconsolehelpdocs/latest/gsg/tag-editor.html\">Working with Tag Editor</a> and <a href=\"http://docs.aws.amazon.com/awsconsolehelpdocs/latest/gsg/resource-groups.html\">Working with Resource Groups</a>. For more information about permissions you need to use the resource groups tagging APIs, see <a href=\"http://docs.aws.amazon.com/awsconsolehelpdocs/latest/gsg/obtaining-permissions-for-resource-groups.html\">Obtaining Permissions for Resource Groups </a> and <a href=\"http://docs.aws.amazon.com/awsconsolehelpdocs/latest/gsg/obtaining-permissions-for-tagging.html\">Obtaining Permissions for Tagging </a>.</p> <p>You can use the resource groups tagging APIs to complete the following tasks:</p> <ul> <li> <p>Tag and untag supported resources located in the specified region for the AWS account</p> </li> <li> <p>Use tag-based filters to search for resources located in the specified region for the AWS account</p> </li> <li> <p>List all existing tag keys in the specified region for the AWS account</p> </li> <li> <p>List all existing values for the specified key in the specified region for the AWS account</p> </li> </ul> <p>Not all resources can have tags. For a list of resources that support tagging, see <a href=\"http://docs.aws.amazon.com/awsconsolehelpdocs/latest/gsg/supported-resources.html\">Supported Resources</a> in the <i>AWS Resource Groups and Tag Editor User Guide</i>.</p> <p>To make full use of the resource groups tagging APIs, you might need additional IAM permissions, including permission to access the resources of individual services as well as permission to view and apply tags to those resources. For more information, see <a href=\"http://docs.aws.amazon.com/awsconsolehelpdocs/latest/gsg/obtaining-permissions-for-tagging.html\">Obtaining Permissions for Tagging</a> in the <i>AWS Resource Groups and Tag Editor User Guide</i>.</p>",
"service": "<fullname>Resource Groups Tagging API</fullname> <p>This guide describes the API operations for the resource groups tagging.</p> <p>A tag is a label that you assign to an AWS resource. A tag consists of a key and a value, both of which you define. For example, if you have two Amazon EC2 instances, you might assign both a tag key of \"Stack.\" But the value of \"Stack\" might be \"Testing\" for one and \"Production\" for the other.</p> <p>Tagging can help you organize your resources and enables you to simplify resource management, access management and cost allocation. For more information about tagging, see <a href=\"http://docs.aws.amazon.com/awsconsolehelpdocs/latest/gsg/tag-editor.html\">Working with Tag Editor</a> and <a href=\"http://docs.aws.amazon.com/awsconsolehelpdocs/latest/gsg/resource-groups.html\">Working with Resource Groups</a>. For more information about permissions you need to use the resource groups tagging APIs, see <a href=\"http://docs.aws.amazon.com/awsconsolehelpdocs/latest/gsg/obtaining-permissions-for-resource-groups.html\">Obtaining Permissions for Resource Groups </a> and <a href=\"http://docs.aws.amazon.com/awsconsolehelpdocs/latest/gsg/obtaining-permissions-for-tagging.html\">Obtaining Permissions for Tagging </a>.</p> <p>You can use the resource groups tagging APIs to complete the following tasks:</p> <ul> <li> <p>Tag and untag supported resources located in the specified region for the AWS account</p> </li> <li> <p>Use tag-based filters to search for resources located in the specified region for the AWS account</p> </li> <li> <p>List all existing tag keys in the specified region for the AWS account</p> </li> <li> <p>List all existing values for the specified key in the specified region for the AWS account</p> </li> </ul> <p>Not all resources can have tags. For a lists of resources that you can tag, see <a href=\"http://docs.aws.amazon.com/awsconsolehelpdocs/latest/gsg/supported-resources.html\">Supported Resources</a> in the <i>AWS Resource Groups and Tag Editor User Guide</i>.</p> <p>To make full use of the resource groups tagging APIs, you might need additional IAM permissions, including permission to access the resources of individual services as well as permission to view and apply tags to those resources. For more information, see <a href=\"http://docs.aws.amazon.com/awsconsolehelpdocs/latest/gsg/obtaining-permissions-for-tagging.html\">Obtaining Permissions for Tagging</a> in the <i>AWS Resource Groups and Tag Editor User Guide</i>.</p>",
"operations": {
"GetResources": "<p>Returns all the tagged resources that are associated with the specified tags (keys and values) located in the specified region for the AWS account. The tags and the resource types that you specify in the request are known as <i>filters</i>. The response includes all tags that are associated with the requested resources. If no filter is provided, this action returns a paginated resource list with the associated tags.</p>",
"GetTagKeys": "<p>Returns all tag keys in the specified region for the AWS account.</p>",
@ -138,6 +138,12 @@
"GetResourcesInput$ResourceTypeFilters": "<p>The constraints on the resources that you want returned. The format of each resource type is <code>service[:resourceType]</code>. For example, specifying a resource type of <code>ec2</code> returns all tagged Amazon EC2 resources (which includes tagged EC2 instances). Specifying a resource type of <code>ec2:instance</code> returns only EC2 instances. </p> <p>The string for each service name and resource type is the same as that embedded in a resource's Amazon Resource Name (ARN). Consult the <i>AWS General Reference</i> for the following:</p> <ul> <li> <p>For a list of service name strings, see <a href=\"http://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html#genref-aws-service-namespaces\">AWS Service Namespaces</a>.</p> </li> <li> <p>For resource type strings, see <a href=\"http://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html#arns-syntax\">Example ARNs</a>.</p> </li> <li> <p>For more information about ARNs, see <a href=\"http://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html\">Amazon Resource Names (ARNs) and AWS Service Namespaces</a>.</p> </li> </ul>"
}
},
"ResourcesPerPage": {
"base": null,
"refs": {
"GetResourcesInput$ResourcesPerPage": "<p>A limit that restricts the number of resources returned by GetResources in paginated output. You can set ResourcesPerPage to a minimum of 1 item and the maximum of 50 items. </p>"
}
},
"StatusCode": {
"base": null,
"refs": {

16
vendor/github.com/aws/aws-sdk-go/models/apis/resourcegroupstaggingapi/2017-01-26/paginators-1.json generated vendored
View File

@ -1,4 +1,20 @@
{
"pagination": {
"GetResources": {
"input_token": "PaginationToken",
"limit_key": "ResourcesPerPage",
"output_token": "PaginationToken",
"result_key": "ResourceTagMappingList"
},
"GetTagKeys": {
"input_token": "PaginationToken",
"output_token": "PaginationToken",
"result_key": "TagKeys"
},
"GetTagValues": {
"input_token": "PaginationToken",
"output_token": "PaginationToken",
"result_key": "TagValues"
}
}
}

19
vendor/github.com/aws/aws-sdk-go/models/apis/ssm/2014-11-06/api-2.json generated vendored
View File

@ -1071,7 +1071,9 @@
{"shape":"InvalidDocumentVersion"},
{"shape":"AssociationDoesNotExist"},
{"shape":"InvalidUpdate"},
{"shape":"TooManyUpdates"}
{"shape":"TooManyUpdates"},
{"shape":"InvalidDocument"},
{"shape":"InvalidTarget"}
]
},
"UpdateAssociationStatus":{
@ -2744,6 +2746,14 @@
"locationName":"FailedCreateAssociationEntry"
}
},
"FailureDetails":{
"type":"structure",
"members":{
"FailureStage":{"shape":"String"},
"FailureType":{"shape":"String"},
"Details":{"shape":"AutomationParameterMap"}
}
},
"Fault":{
"type":"string",
"enum":[
@ -5014,7 +5024,8 @@
"Inputs":{"shape":"NormalStringMap"},
"Outputs":{"shape":"AutomationParameterMap"},
"Response":{"shape":"String"},
"FailureMessage":{"shape":"String"}
"FailureMessage":{"shape":"String"},
"FailureDetails":{"shape":"FailureDetails"}
}
},
"StepExecutionList":{
@ -5152,7 +5163,9 @@
"Parameters":{"shape":"Parameters"},
"DocumentVersion":{"shape":"DocumentVersion"},
"ScheduleExpression":{"shape":"ScheduleExpression"},
"OutputLocation":{"shape":"InstanceAssociationOutputLocation"}
"OutputLocation":{"shape":"InstanceAssociationOutputLocation"},
"Name":{"shape":"DocumentName"},
"Targets":{"shape":"Targets"}
}
},
"UpdateAssociationResult":{

155
vendor/github.com/aws/aws-sdk-go/models/apis/ssm/2014-11-06/docs-2.json generated vendored
View File

@ -2,7 +2,7 @@
"version": "2.0",
"service": "<fullname>Amazon EC2 Systems Manager</fullname> <p>Amazon EC2 Systems Manager is a collection of capabilities that helps you automate management tasks such as collecting system inventory, applying operating system (OS) patches, automating the creation of Amazon Machine Images (AMIs), and configuring operating systems (OSs) and applications at scale. Systems Manager lets you remotely and securely manage the configuration of your managed instances. A <i>managed instance</i> is any Amazon EC2 instance or on-premises machine in your hybrid environment that has been configured for Systems Manager.</p> <p>This reference is intended to be used with the <a href=\"http://docs.aws.amazon.com/systems-manager/latest/userguide/\">Amazon EC2 Systems Manager User Guide</a>.</p> <p>To get started, verify prerequisites and configure managed instances. For more information, see <a href=\"http://docs.aws.amazon.com/systems-manager/latest/userguide/systems-manager-prereqs.html\">Systems Manager Prerequisites</a>.</p>",
"operations": {
"AddTagsToResource": "<p>Adds or overwrites one or more tags for the specified resource. Tags are metadata that you assign to your managed instances. Tags enable you to categorize your managed instances in different ways, for example, by purpose, owner, or environment. Each tag consists of a key and an optional value, both of which you define. For example, you could define a set of tags for your account's managed instances that helps you track each instance's owner and stack level. For example: Key=Owner and Value=DbAdmin, SysAdmin, or Dev. Or Key=Stack and Value=Production, Pre-Production, or Test. Each resource can have a maximum of 10 tags. </p> <p>We recommend that you devise a set of tag keys that meets your needs for each resource type. Using a consistent set of tag keys makes it easier for you to manage your resources. You can search and filter the resources based on the tags you add. Tags don't have any semantic meaning to Amazon EC2 and are interpreted strictly as a string of characters. </p> <p>For more information about tags, see <a href=\"http://docs.aws.amazon.com/AWSEC2/latest/UserGuide/Using_Tags.html\">Tagging Your Amazon EC2 Resources</a> in the <i>Amazon EC2 User Guide</i>.</p>",
"AddTagsToResource": "<p>Adds or overwrites one or more tags for the specified resource. Tags are metadata that you assign to your managed instances, Maintenance Windows, or Parameter Store parameters. Tags enable you to categorize your resources in different ways, for example, by purpose, owner, or environment. Each tag consists of a key and an optional value, both of which you define. For example, you could define a set of tags for your account's managed instances that helps you track each instance's owner and stack level. For example: Key=Owner and Value=DbAdmin, SysAdmin, or Dev. Or Key=Stack and Value=Production, Pre-Production, or Test.</p> <p>Each resource can have a maximum of 10 tags. </p> <p>We recommend that you devise a set of tag keys that meets your needs for each resource type. Using a consistent set of tag keys makes it easier for you to manage your resources. You can search and filter the resources based on the tags you add. Tags don't have any semantic meaning to Amazon EC2 and are interpreted strictly as a string of characters. </p> <p>For more information about tags, see <a href=\"http://docs.aws.amazon.com/AWSEC2/latest/UserGuide/Using_Tags.html\">Tagging Your Amazon EC2 Resources</a> in the <i>Amazon EC2 User Guide</i>.</p>",
"CancelCommand": "<p>Attempts to cancel the command specified by the Command ID. There is no guarantee that the command will be terminated and the underlying process stopped.</p>",
"CreateActivation": "<p>Registers your on-premises server or virtual machine with Amazon EC2 so that you can manage these resources using Run Command. An on-premises server or virtual machine that has been registered with EC2 is called a managed instance. For more information about activations, see <a href=\"http://docs.aws.amazon.com/systems-manager/latest/userguide/systems-manager-managedinstances.html\">Setting Up Systems Manager in Hybrid Environments</a>.</p>",
"CreateAssociation": "<p>Associates the specified Systems Manager document with the specified instances or targets.</p> <p>When you associate a document with one or more instances using instance IDs or tags, the SSM Agent running on the instance processes the document and configures the instance as specified.</p> <p>If you associate a document with an instance that already has an associated document, the system throws the AssociationAlreadyExists exception.</p>",
@ -16,7 +16,7 @@
"DeleteMaintenanceWindow": "<p>Deletes a Maintenance Window.</p>",
"DeleteParameter": "<p>Delete a parameter from the system.</p>",
"DeletePatchBaseline": "<p>Deletes a patch baseline.</p>",
"DeregisterManagedInstance": "<p>Removes the server or virtual machine from the list of registered servers. You can reregister the instance again at any time. If you don’t plan to use Run Command on the server, we suggest uninstalling the SSM Agent first.</p>",
"DeregisterManagedInstance": "<p>Removes the server or virtual machine from the list of registered servers. You can reregister the instance again at any time. If you don't plan to use Run Command on the server, we suggest uninstalling the SSM Agent first.</p>",
"DeregisterPatchBaselineForPatchGroup": "<p>Removes a patch group from a patch baseline.</p>",
"DeregisterTargetFromMaintenanceWindow": "<p>Removes a target from a Maintenance Window.</p>",
"DeregisterTaskFromMaintenanceWindow": "<p>Removes a task from a Maintenance Window.</p>",
@ -25,7 +25,7 @@
"DescribeAutomationExecutions": "<p>Provides details about all active and terminated Automation executions.</p>",
"DescribeAvailablePatches": "<p>Lists all patches that could possibly be included in a patch baseline.</p>",
"DescribeDocument": "<p>Describes the specified SSM document.</p>",
"DescribeDocumentPermission": "<p>Describes the permissions for a Systems Manager document. If you created the document, you are the owner. If a document is shared, it can either be shared privately (by specifying a user’s AWS account ID) or publicly (<i>All</i>). </p>",
"DescribeDocumentPermission": "<p>Describes the permissions for a Systems Manager document. If you created the document, you are the owner. If a document is shared, it can either be shared privately (by specifying a user's AWS account ID) or publicly (<i>All</i>). </p>",
"DescribeEffectiveInstanceAssociations": "<p>All associations for the instance(s).</p>",
"DescribeEffectivePatchesForPatchBaseline": "<p>Retrieves the current effective patches (the patch and the approval state) for the specified patch baseline.</p>",
"DescribeInstanceAssociationsStatus": "<p>The status of the associations for the instance(s).</p>",
@ -114,7 +114,7 @@
"base": null,
"refs": {
"Activation$Description": "<p>A user defined description of the activation.</p>",
"CreateActivationRequest$Description": "<p>A user-defined description of the resource that you want to register with Amazon EC2. </p>"
"CreateActivationRequest$Description": "<p>A userdefined description of the resource that you want to register with Amazon EC2. </p>"
}
},
"ActivationId": {
@ -338,7 +338,7 @@
"refs": {
"AutomationExecution$AutomationExecutionId": "<p>The execution ID.</p>",
"AutomationExecutionMetadata$AutomationExecutionId": "<p>The execution ID.</p>",
"GetAutomationExecutionRequest$AutomationExecutionId": "<p>The unique identifier for an existing automation execution to examine. The execution ID is returned by <code>StartAutomationExecution</code> when the execution of an Automation document is initiated.</p>",
"GetAutomationExecutionRequest$AutomationExecutionId": "<p>The unique identifier for an existing automation execution to examine. The execution ID is returned by StartAutomationExecution when the execution of an Automation document is initiated.</p>",
"StartAutomationExecutionResult$AutomationExecutionId": "<p>The unique ID of a newly scheduled automation execution.</p>",
"StopAutomationExecutionRequest$AutomationExecutionId": "<p>The execution ID of the Automation to stop.</p>"
}
@ -370,7 +370,7 @@
"refs": {
"AutomationExecution$AutomationExecutionStatus": "<p>The execution status of the Automation.</p>",
"AutomationExecutionMetadata$AutomationExecutionStatus": "<p>The status of the execution. Valid values include: Running, Succeeded, Failed, Timed out, or Cancelled.</p>",
"StepExecution$StepStatus": "<p>The execution status for this step. Valid values include: <code>Pending</code>, <code>InProgress</code>, <code>Success</code>, <code>Cancelled</code>, <code>Failed</code>, and <code>TimedOut</code>.</p>"
"StepExecution$StepStatus": "<p>The execution status for this step. Valid values include: Pending, InProgress, Success, Cancelled, Failed, and TimedOut.</p>"
}
},
"AutomationParameterKey": {
@ -382,9 +382,10 @@
"AutomationParameterMap": {
"base": null,
"refs": {
"AutomationExecution$Parameters": "<p>The key-value map of execution parameters, which were supplied when calling <code>StartAutomationExecution</code>.</p>",
"AutomationExecution$Parameters": "<p>The key-value map of execution parameters, which were supplied when calling StartAutomationExecution.</p>",
"AutomationExecution$Outputs": "<p>The list of execution outputs as defined in the automation document.</p>",
"AutomationExecutionMetadata$Outputs": "<p>The list of execution outputs as defined in the Automation document.</p>",
"FailureDetails$Details": "<p>Detailed information about the Automation step failure.</p>",
"StartAutomationExecutionRequest$Parameters": "<p>A key-value map of execution parameters, which match the declared parameters in the Automation document.</p>",
"StepExecution$Outputs": "<p>Returned values from the execution of the step.</p>"
}
@ -476,7 +477,7 @@
"base": null,
"refs": {
"CreateMaintenanceWindowRequest$ClientToken": "<p>User-provided idempotency token.</p>",
"CreatePatchBaselineRequest$ClientToken": "<p>Caller-provided idempotency token.</p>",
"CreatePatchBaselineRequest$ClientToken": "<p>User-provided idempotency token.</p>",
"RegisterTargetWithMaintenanceWindowRequest$ClientToken": "<p>User-provided idempotency token.</p>",
"RegisterTaskWithMaintenanceWindowRequest$ClientToken": "<p>User-provided idempotency token.</p>"
}
@ -541,7 +542,7 @@
"base": null,
"refs": {
"CommandInvocation$Status": "<p>Whether or not the invocation succeeded, failed, or is pending.</p>",
"GetCommandInvocationResult$Status": "<p>The status of the parent command for this invocation. This status can be different than <code>StatusDetails</code>.</p>"
"GetCommandInvocationResult$Status": "<p>The status of the parent command for this invocation. This status can be different than StatusDetails.</p>"
}
},
"CommandList": {
@ -607,7 +608,7 @@
"CompletedCount": {
"base": null,
"refs": {
"Command$CompletedCount": "<p>The number of targets for which the command invocation reached a terminal state. Terminal states include the following: <code>Success</code>, <code>Failed</code>, <code>Execution Timed Out</code>, <code>Delivery Timed Out</code>, <code>Canceled</code>, <code>Terminated</code>, or <code>Undeliverable</code>.</p>"
"Command$CompletedCount": "<p>The number of targets for which the command invocation reached a terminal state. Terminal states include the following: Success, Failed, Execution Timed Out, Delivery Timed Out, Canceled, Terminated, or Undeliverable.</p>"
}
},
"ComputerName": {
@ -638,7 +639,7 @@
}
},
"CreateAssociationBatchRequestEntry": {
"base": "<p> Describes the association of a Systems Manager document and an instance.</p>",
"base": "<p>Describes the association of a Systems Manager document and an instance.</p>",
"refs": {
"CreateAssociationBatchRequestEntries$member": null,
"FailedCreateAssociation$Entry": "<p>The association.</p>"
@ -718,7 +719,7 @@
"CommandInvocation$RequestedDateTime": "<p>The time and date the request was sent to this instance.</p>",
"CommandPlugin$ResponseStartDateTime": "<p>The time the plugin started executing. </p>",
"CommandPlugin$ResponseFinishDateTime": "<p>The time the plugin stopped executing. Could stop prematurely if, for example, a cancel command was sent. </p>",
"DocumentDescription$CreatedDate": "<p> The date when the document was created.</p>",
"DocumentDescription$CreatedDate": "<p>The date when the document was created.</p>",
"DocumentVersionInfo$CreatedDate": "<p>The date the document was created.</p>",
"GetMaintenanceWindowExecutionResult$StartTime": "<p>The time the Maintenance Window started executing.</p>",
"GetMaintenanceWindowExecutionResult$EndTime": "<p>The time the Maintenance Window finished executing.</p>",
@ -743,7 +744,7 @@
"ParameterMetadata$LastModifiedDate": "<p>Date the parameter was last changed or updated.</p>",
"Patch$ReleaseDate": "<p>The date the patch was released.</p>",
"PatchStatus$ApprovalDate": "<p>The date the patch was approved (or will be approved if the status is PENDING_APPROVAL).</p>",
"StepExecution$ExecutionStartTime": "<p>If a step has begun execution, this contains the time the step started. If the step is in <code>Pending</code> status, this field is not populated.</p>",
"StepExecution$ExecutionStartTime": "<p>If a step has begun execution, this contains the time the step started. If the step is in Pending status, this field is not populated.</p>",
"StepExecution$ExecutionEndTime": "<p>If a step has finished execution, this contains the time the execution ended. If the step has not yet concluded, this field is not populated.</p>",
"UpdatePatchBaselineResult$CreatedDate": "<p>The date when the patch baseline was created.</p>",
"UpdatePatchBaselineResult$ModifiedDate": "<p>The date when the patch baseline was last modified.</p>"
@ -1113,7 +1114,7 @@
"DescriptionInDocument": {
"base": null,
"refs": {
"DocumentDescription$Description": "<p> A description of the document. </p>"
"DocumentDescription$Description": "<p>A description of the document. </p>"
}
},
"DocumentARN": {
@ -1149,7 +1150,7 @@
}
},
"DocumentDescription": {
"base": "<p> Describes an SSM document. </p>",
"base": "<p>Describes an SSM document. </p>",
"refs": {
"CreateDocumentResult$DocumentDescription": "<p>Information about the Systems Manager document.</p>",
"DescribeDocumentResult$Document": "<p>Information about the SSM document.</p>",
@ -1220,7 +1221,7 @@
"AutomationExecutionMetadata$DocumentName": "<p>The name of the Automation document used during execution.</p>",
"Command$DocumentName": "<p>The name of the document requested for execution.</p>",
"CommandInvocation$DocumentName": "<p>The document name that was requested for execution.</p>",
"CreateAssociationBatchRequestEntry$Name": "<p> The name of the configuration document. </p>",
"CreateAssociationBatchRequestEntry$Name": "<p>The name of the configuration document. </p>",
"CreateAssociationRequest$Name": "<p>The name of the Systems Manager document.</p>",
"CreateDocumentRequest$Name": "<p>A name for the Systems Manager document.</p>",
"DeleteAssociationRequest$Name": "<p>The name of the Systems Manager document.</p>",
@ -1233,6 +1234,7 @@
"InstanceAssociationStatusInfo$Name": "<p>The name of the association.</p>",
"ListDocumentVersionsRequest$Name": "<p>The name of the document about which you want version information.</p>",
"ModifyDocumentPermissionRequest$Name": "<p>The name of the document that you want to share.</p>",
"UpdateAssociationRequest$Name": "<p>The name of the association document.</p>",
"UpdateAssociationStatusRequest$Name": "<p>The name of the SSM document.</p>",
"UpdateDocumentDefaultVersionRequest$Name": "<p>The name of a custom document that you want to set as the default version.</p>",
"UpdateDocumentRequest$Name": "<p>The name of the document that you want to update.</p>"
@ -1278,7 +1280,7 @@
"DocumentParameterType": {
"base": null,
"refs": {
"DocumentParameter$Type": "<p>The type of parameter. The type can be either “String” or “StringList”.</p>"
"DocumentParameter$Type": "<p>The type of parameter. The type can be either String or StringList.</p>"
}
},
"DocumentPermissionLimit": {
@ -1369,7 +1371,7 @@
}
},
"DoesNotExistException": {
"base": "<p>Error returned when the ID specified for a resource (e.g. a Maintenance Window) doesn’t exist.</p>",
"base": "<p>Error returned when the ID specified for a resource (e.g. a Maintenance Window) doesn't exist.</p>",
"refs": {
}
},
@ -1404,7 +1406,7 @@
"ErrorCount": {
"base": null,
"refs": {
"Command$ErrorCount": "<p>The number of targets for which the status is <code>Failed</code> or <code>Execution Timed Out</code>.</p>"
"Command$ErrorCount": "<p>The number of targets for which the status is Failed or Execution Timed Out.</p>"
}
},
"ExpirationDate": {
@ -1426,6 +1428,12 @@
"CreateAssociationBatchResult$Failed": "<p>Information about the associations that failed.</p>"
}
},
"FailureDetails": {
"base": "<p>Information about an Automation failure.</p>",
"refs": {
"StepExecution$FailureDetails": "<p>Information about the Automation failure.</p>"
}
},
"Fault": {
"base": null,
"refs": {
@ -1594,7 +1602,7 @@
}
},
"IdempotentParameterMismatch": {
"base": "<p>Error returned when an idempotent operation is retried and the parameters don’t match the original call to the API with the same idempotency token. </p>",
"base": "<p>Error returned when an idempotent operation is retried and the parameters don't match the original call to the API with the same idempotency token. </p>",
"refs": {
}
},
@ -1627,8 +1635,8 @@
"refs": {
"AssociationDescription$OutputLocation": "<p>An Amazon S3 bucket where you want to store the output details of the request.</p>",
"CreateAssociationBatchRequestEntry$OutputLocation": "<p>An Amazon S3 bucket where you want to store the results of this request.</p>",
"CreateAssociationRequest$OutputLocation": "<p>An Amazon S3 bucket where you want to store the output details of the request. For example:</p> <p> <code>\"{ \\\"S3Location\\\": { \\\"OutputS3Region\\\": \\\"&lt;region&gt;\\\", \\\"OutputS3BucketName\\\": \\\"bucket name\\\", \\\"OutputS3KeyPrefix\\\": \\\"folder name\\\" } }\"</code> </p>",
"UpdateAssociationRequest$OutputLocation": "<p>An Amazon S3 bucket where you want to store the results of this request.</p> <p> <code>\"{ \\\"S3Location\\\": { \\\"OutputS3Region\\\": \\\"&lt;region&gt;\\\", \\\"OutputS3BucketName\\\": \\\"bucket name\\\", \\\"OutputS3KeyPrefix\\\": \\\"folder name\\\" } }\"</code> </p>"
"CreateAssociationRequest$OutputLocation": "<p>An Amazon S3 bucket where you want to store the output details of the request.</p>",
"UpdateAssociationRequest$OutputLocation": "<p>An Amazon S3 bucket where you want to store the results of this request.</p>"
}
},
"InstanceAssociationOutputUrl": {
@ -1668,7 +1676,7 @@
"Association$InstanceId": "<p>The ID of the instance.</p>",
"AssociationDescription$InstanceId": "<p>The ID of the instance.</p>",
"CommandInvocation$InstanceId": "<p>The instance ID in which this invocation was requested.</p>",
"CreateAssociationBatchRequestEntry$InstanceId": "<p> The ID of the instance. </p>",
"CreateAssociationBatchRequestEntry$InstanceId": "<p>The ID of the instance. </p>",
"CreateAssociationRequest$InstanceId": "<p>The instance ID.</p>",
"DeleteAssociationRequest$InstanceId": "<p>The ID of the instance.</p>",
"DescribeAssociationRequest$InstanceId": "<p>The instance ID.</p>",
@ -1698,7 +1706,7 @@
"CancelCommandRequest$InstanceIds": "<p>(Optional) A list of instance IDs on which you want to cancel the command. If not provided, the command is canceled on every instance on which it was requested.</p>",
"Command$InstanceIds": "<p>The instance IDs against which this command was requested.</p>",
"DescribeInstancePatchStatesRequest$InstanceIds": "<p>The ID of the instance whose patch state information should be retrieved.</p>",
"SendCommandRequest$InstanceIds": "<p>Required. The instance IDs where the command should execute. You can specify a maximum of 50 IDs.</p>"
"SendCommandRequest$InstanceIds": "<p>The instance IDs where the command should execute. You can specify a maximum of 50 IDs. If you prefer not to list individual instance IDs, you can instead send commands to a fleet of instances using the Targets parameter, which accepts EC2 tags.</p>"
}
},
"InstanceInformation": {
@ -1753,7 +1761,7 @@
"InstanceInformationStringFilterKey": {
"base": null,
"refs": {
"InstanceInformationStringFilter$Key": "<p>The filter key name to describe your instances. For example:</p> <p>\"InstanceIds\"|\"AgentVersion\"|\"PingStatus\"|\"PlatformTypes\"|\"ActivationIds\"|\"IamRole\"|\"ResourceType\"|”AssociationStatus”|”Tag Key”</p>"
"InstanceInformationStringFilter$Key": "<p>The filter key name to describe your instances. For example:</p> <p>\"InstanceIds\"|\"AgentVersion\"|\"PingStatus\"|\"PlatformTypes\"|\"ActivationIds\"|\"IamRole\"|\"ResourceType\"|\"AssociationStatus\"|\"Tag Key\"</p>"
}
},
"InstanceInformationStringFilterList": {
@ -1784,7 +1792,7 @@
"InstancePatchStateFilterList": {
"base": null,
"refs": {
"DescribeInstancePatchStatesForPatchGroupRequest$Filters": "<p>Each entry in the array is a structure containing:</p> <p>Key (string 1 ≤ length ≤ 200)</p> <p> Values (array containing a single string)</p> <p> Type (string “Equal”, “NotEqual”, “LessThan”, “GreaterThan”)</p>"
"DescribeInstancePatchStatesForPatchGroupRequest$Filters": "<p>Each entry in the array is a structure containing:</p> <p>Key (string between 1 and 200 characters)</p> <p> Values (array containing a single string)</p> <p> Type (string \"Equal\", \"NotEqual\", \"LessThan\", \"GreaterThan\")</p>"
}
},
"InstancePatchStateFilterValue": {
@ -1820,7 +1828,7 @@
"InstanceTagName": {
"base": null,
"refs": {
"CommandInvocation$InstanceName": "<p>The name of the invocation target. For Amazon EC2 instances this is the value for the <code>aws:Name</code> tag. For on-premises instances, this is the name of the instance.</p>"
"CommandInvocation$InstanceName": "<p>The name of the invocation target. For Amazon EC2 instances this is the value for the aws:Name tag. For on-premises instances, this is the name of the instance.</p>"
}
},
"Integer": {
@ -1828,10 +1836,10 @@
"refs": {
"DescribePatchGroupStateResult$Instances": "<p>The number of instances in the patch group.</p>",
"DescribePatchGroupStateResult$InstancesWithInstalledPatches": "<p>The number of instances with installed patches.</p>",
"DescribePatchGroupStateResult$InstancesWithInstalledOtherPatches": "<p>The number of instances with patches installed that aren’t defined in the patch baseline.</p>",
"DescribePatchGroupStateResult$InstancesWithInstalledOtherPatches": "<p>The number of instances with patches installed that aren't defined in the patch baseline.</p>",
"DescribePatchGroupStateResult$InstancesWithMissingPatches": "<p>The number of instances with missing patches from the patch baseline.</p>",
"DescribePatchGroupStateResult$InstancesWithFailedPatches": "<p>The number of instances with patches from the patch baseline that failed to install.</p>",
"DescribePatchGroupStateResult$InstancesWithNotApplicablePatches": "<p>The number of instances with patches that aren’t applicable.</p>"
"DescribePatchGroupStateResult$InstancesWithNotApplicablePatches": "<p>The number of instances with patches that aren't applicable.</p>"
}
},
"InternalServerError": {
@ -2066,8 +2074,8 @@
"InventoryItemContentHash": {
"base": null,
"refs": {
"InventoryItem$ContentHash": "<p>MD5 hash of the inventory item type contents. The content hash is used to determine whether to update inventory information. The <code>PutInventory</code> API does not update the inventory item type contents if the MD5 hash has not changed since last update. </p>",
"InventoryResultItem$ContentHash": "<p>MD5 hash of the inventory item type contents. The content hash is used to determine whether to update inventory information. The <code>PutInventory</code> API does not update the inventory item type contents if the MD5 hash has not changed since last update. </p>"
"InventoryItem$ContentHash": "<p>MD5 hash of the inventory item type contents. The content hash is used to determine whether to update inventory information. The PutInventory API does not update the inventory item type contents if the MD5 hash has not changed since last update. </p>",
"InventoryResultItem$ContentHash": "<p>MD5 hash of the inventory item type contents. The content hash is used to determine whether to update inventory information. The PutInventory API does not update the inventory item type contents if the MD5 hash has not changed since last update. </p>"
}
},
"InventoryItemEntry": {
@ -2115,14 +2123,14 @@
"base": null,
"refs": {
"InvalidItemContentException$TypeName": null,
"InventoryItem$TypeName": "<p>The name of the inventory type. Default inventory item type names start with <code>AWS</code>. Custom inventory type names will start with <code>Custom</code>. Default inventory item types include the following: <code>AWS:AWSComponent</code>, <code>AWS:Application</code>, <code>AWS:InstanceInformation</code>, <code>AWS:Network</code>, and <code>AWS:WindowsUpdate</code>.</p>",
"InventoryItemSchema$TypeName": "<p>The name of the inventory type. Default inventory item type names start with <code>AWS</code>. Custom inventory type names will start with <code>Custom</code>. Default inventory item types include the following: <code>AWS:AWSComponent</code>, <code>AWS:Application</code>, <code>AWS:InstanceInformation</code>, <code>AWS:Network</code>, and <code>AWS:WindowsUpdate</code>.</p>",
"InventoryItem$TypeName": "<p>The name of the inventory type. Default inventory item type names start with AWS. Custom inventory type names will start with Custom. Default inventory item types include the following: AWS:AWSComponent, AWS:Application, AWS:InstanceInformation, AWS:Network, and AWS:WindowsUpdate.</p>",
"InventoryItemSchema$TypeName": "<p>The name of the inventory type. Default inventory item type names start with AWS. Custom inventory type names will start with Custom. Default inventory item types include the following: AWS:AWSComponent, AWS:Application, AWS:InstanceInformation, AWS:Network, and AWS:WindowsUpdate.</p>",
"InventoryResultItem$TypeName": "<p>The name of the inventory result item type.</p>",
"ItemContentMismatchException$TypeName": null,
"ItemSizeLimitExceededException$TypeName": null,
"ListInventoryEntriesRequest$TypeName": "<p>The type of inventory item for which you want information.</p>",
"ListInventoryEntriesResult$TypeName": "<p>The type of inventory item returned by the request.</p>",
"ResultAttribute$TypeName": "<p>Name of the inventory item type. Valid value: “AWS:InstanceInformation”. Default Value: “AWS:InstanceInformation”.</p>"
"ResultAttribute$TypeName": "<p>Name of the inventory item type. Valid value: AWS:InstanceInformation. Default Value: AWS:InstanceInformation.</p>"
}
},
"InventoryItemTypeNameFilter": {
@ -2437,10 +2445,10 @@
"refs": {
"DescribeMaintenanceWindowExecutionTaskInvocationsRequest$Filters": "<p>Optional filters used to scope down the returned task invocations. The supported filter key is STATUS with the corresponding values PENDING, IN_PROGRESS, SUCCESS, FAILED, TIMED_OUT, CANCELLING, and CANCELLED.</p>",
"DescribeMaintenanceWindowExecutionTasksRequest$Filters": "<p>Optional filters used to scope down the returned tasks. The supported filter key is STATUS with the corresponding values PENDING, IN_PROGRESS, SUCCESS, FAILED, TIMED_OUT, CANCELLING, and CANCELLED. </p>",
"DescribeMaintenanceWindowExecutionsRequest$Filters": "<p>Each entry in the array is a structure containing:</p> <p>Key (string, 1 ≤ length ≤ 128)</p> <p>Values (array of strings 1 ≤ length ≤ 256)</p> <p>The supported Keys are <code>ExecutedBefore</code> and <code>ExecutedAfter</code> with the value being a date/time string such as 2016-11-04T05:00:00Z.</p>",
"DescribeMaintenanceWindowTargetsRequest$Filters": "<p>Optional filters that can be used to narrow down the scope of the returned window targets. The supported filter keys are <code>Type</code>, <code>WindowTargetId</code> and <code>OwnerInformation</code>.</p>",
"DescribeMaintenanceWindowTasksRequest$Filters": "<p>Optional filters used to narrow down the scope of the returned tasks. The supported filter keys are <code>WindowTaskId</code>, <code>TaskArn</code>, <code>Priority</code>, and <code>TaskType</code>.</p>",
"DescribeMaintenanceWindowsRequest$Filters": "<p>Optional filters used to narrow down the scope of the returned Maintenance Windows. Supported filter keys are <code>Name</code> and <code>Enabled</code>.</p>"
"DescribeMaintenanceWindowExecutionsRequest$Filters": "<p>Each entry in the array is a structure containing:</p> <p>Key (string, between 1 and 128 characters)</p> <p>Values (array of strings, each string is between 1 and 256 characters)</p> <p>The supported Keys are ExecutedBefore and ExecutedAfter with the value being a date/time string such as 2016-11-04T05:00:00Z.</p>",
"DescribeMaintenanceWindowTargetsRequest$Filters": "<p>Optional filters that can be used to narrow down the scope of the returned window targets. The supported filter keys are Type, WindowTargetId and OwnerInformation.</p>",
"DescribeMaintenanceWindowTasksRequest$Filters": "<p>Optional filters used to narrow down the scope of the returned tasks. The supported filter keys are WindowTaskId, TaskArn, Priority, and TaskType.</p>",
"DescribeMaintenanceWindowsRequest$Filters": "<p>Optional filters used to narrow down the scope of the returned Maintenance Windows. Supported filter keys are Name and Enabled.</p>"
}
},
"MaintenanceWindowFilterValue": {
@ -2615,7 +2623,7 @@
"MaintenanceWindowTaskParametersList": {
"base": null,
"refs": {
"GetMaintenanceWindowExecutionTaskResult$TaskParameters": "<p>The parameters passed to the task when it was executed. The map has the following format:</p> <p>Key: string, 1 ≤ length ≤ 255</p> <p>Value: an array of strings where each string 1 ≤ length ≤ 255</p>"
"GetMaintenanceWindowExecutionTaskResult$TaskParameters": "<p>The parameters passed to the task when it was executed. The map has the following format:</p> <p>Key: string, between 1 and 255 characters</p> <p>Value: an array of strings, each string is between 1 and 255 characters</p>"
}
},
"MaintenanceWindowTaskPriority": {
@ -2651,11 +2659,11 @@
"MaxConcurrency": {
"base": null,
"refs": {
"Command$MaxConcurrency": "<p>The maximum number of instances that are allowed to execute the command at the same time. You can specify a number of instances, such as 10, or a percentage of instances, such as 10%. The default value is 50. For more information about how to use <code>MaxConcurrency</code>, see <a href=\"http://docs.aws.amazon.com/systems-manager/latest/userguide/run-command.html\">Executing a Command Using Systems Manager Run Command</a>.</p>",
"Command$MaxConcurrency": "<p>The maximum number of instances that are allowed to execute the command at the same time. You can specify a number of instances, such as 10, or a percentage of instances, such as 10%. The default value is 50. For more information about how to use MaxConcurrency, see <a href=\"http://docs.aws.amazon.com/systems-manager/latest/userguide/run-command.html\">Executing a Command Using Systems Manager Run Command</a>.</p>",
"GetMaintenanceWindowExecutionTaskResult$MaxConcurrency": "<p>The defined maximum number of task executions that could be run in parallel.</p>",
"MaintenanceWindowTask$MaxConcurrency": "<p>The maximum number of targets this task can be run for in parallel.</p>",
"RegisterTaskWithMaintenanceWindowRequest$MaxConcurrency": "<p>The maximum number of targets this task can be run for in parallel.</p>",
"SendCommandRequest$MaxConcurrency": "<p>(Optional) The maximum number of instances that are allowed to execute the command at the same time. You can specify a number such as “10” or a percentage such as “10%”. The default value is 50. For more information about how to use <code>MaxConcurrency</code>, see <a href=\"http://docs.aws.amazon.com/systems-manager/latest/userguide/run-command.html\">Executing a Command Using Systems Manager Run Command</a>.</p>"
"SendCommandRequest$MaxConcurrency": "<p>(Optional) The maximum number of instances that are allowed to execute the command at the same time. You can specify a number such as 10 or a percentage such as 10%. The default value is 50. For more information about how to use MaxConcurrency, see <a href=\"http://docs.aws.amazon.com/systems-manager/latest/userguide/run-command.html\">Executing a Command Using Systems Manager Run Command</a>.</p>"
}
},
"MaxDocumentSizeExceeded": {
@ -2666,11 +2674,11 @@
"MaxErrors": {
"base": null,
"refs": {
"Command$MaxErrors": "<p>The maximum number of errors allowed before the system stops sending the command to additional targets. You can specify a number of errors, such as 10, or a percentage or errors, such as 10%. The default value is 50. For more information about how to use <code>MaxErrors</code>, see <a href=\"http://docs.aws.amazon.com/systems-manager/latest/userguide/run-command.html\">Executing a Command Using Systems Manager Run Command</a>.</p>",
"Command$MaxErrors": "<p>The maximum number of errors allowed before the system stops sending the command to additional targets. You can specify a number of errors, such as 10, or a percentage or errors, such as 10%. The default value is 50. For more information about how to use MaxErrors, see <a href=\"http://docs.aws.amazon.com/systems-manager/latest/userguide/run-command.html\">Executing a Command Using Systems Manager Run Command</a>.</p>",
"GetMaintenanceWindowExecutionTaskResult$MaxErrors": "<p>The defined maximum number of task execution errors allowed before scheduling of the task execution would have been stopped.</p>",
"MaintenanceWindowTask$MaxErrors": "<p>The maximum number of errors allowed before this task stops being scheduled.</p>",
"RegisterTaskWithMaintenanceWindowRequest$MaxErrors": "<p>The maximum number of errors allowed before this task stops being scheduled.</p>",
"SendCommandRequest$MaxErrors": "<p>The maximum number of errors allowed without the command failing. When the command fails one more time beyond the value of <code>MaxErrors</code>, the systems stops sending the command to additional targets. You can specify a number like “10” or a percentage like “10%”. The default value is 50. For more information about how to use <code>MaxErrors</code>, see <a href=\"http://docs.aws.amazon.com/systems-manager/latest/userguide/run-command.html\">Executing a Command Using Systems Manager Run Command</a>.</p>"
"SendCommandRequest$MaxErrors": "<p>The maximum number of errors allowed without the command failing. When the command fails one more time beyond the value of MaxErrors, the systems stops sending the command to additional targets. You can specify a number like 10 or a percentage like 10%. The default value is 50. For more information about how to use MaxErrors, see <a href=\"http://docs.aws.amazon.com/systems-manager/latest/userguide/run-command.html\">Executing a Command Using Systems Manager Run Command</a>.</p>"
}
},
"MaxResults": {
@ -3019,7 +3027,7 @@
"PatchComplianceDataList": {
"base": null,
"refs": {
"DescribeInstancePatchesResult$Patches": "<p>Each entry in the array is a structure containing:</p> <p>Title (string)</p> <p>KBId (string)</p> <p>Classification (string)</p> <p>Severity (string)</p> <p>State (string – “INSTALLED”, “INSTALLED_OTHER”, “MISSING”, “NOT_APPLICABLE”, “FAILED”)</p> <p>InstalledTime (DateTime)</p> <p>InstalledBy (string)</p>"
"DescribeInstancePatchesResult$Patches": "<p>Each entry in the array is a structure containing:</p> <p>Title (string)</p> <p>KBId (string)</p> <p>Classification (string)</p> <p>Severity (string)</p> <p>State (string: \"INSTALLED\", \"INSTALLED OTHER\", \"MISSING\", \"NOT APPLICABLE\", \"FAILED\")</p> <p>InstalledTime (DateTime)</p> <p>InstalledBy (string)</p>"
}
},
"PatchComplianceDataState": {
@ -3131,7 +3139,7 @@
"PatchGroupPatchBaselineMappingList": {
"base": null,
"refs": {
"DescribePatchGroupsResult$Mappings": "<p>Each entry in the array contains:</p> <p>PatchGroup: string (1 ≤ length ≤ 256, Regex: ^([\\p{L}\\p{Z}\\p{N}_.:/=+\\-@]*)$)</p> <p>PatchBaselineIdentity: A PatchBaselineIdentity element. </p>"
"DescribePatchGroupsResult$Mappings": "<p>Each entry in the array contains:</p> <p>PatchGroup: string (between 1 and 256 characters, Regex: ^([\\p{L}\\p{Z}\\p{N}_.:/=+\\-@]*)$)</p> <p>PatchBaselineIdentity: A PatchBaselineIdentity element. </p>"
}
},
"PatchId": {
@ -3182,7 +3190,7 @@
"PatchLanguage": {
"base": null,
"refs": {
"Patch$Language": "<p>The language of the patch if it’s language-specific.</p>"
"Patch$Language": "<p>The language of the patch if it's language-specific.</p>"
}
},
"PatchList": {
@ -3194,7 +3202,7 @@
"PatchMissingCount": {
"base": null,
"refs": {
"InstancePatchState$MissingCount": "<p>The number of patches from the patch baseline that are applicable for the instance but aren’t currently installed.</p>"
"InstancePatchState$MissingCount": "<p>The number of patches from the patch baseline that are applicable for the instance but aren't currently installed.</p>"
}
},
"PatchMsrcNumber": {
@ -3212,7 +3220,7 @@
"PatchNotApplicableCount": {
"base": null,
"refs": {
"InstancePatchState$NotApplicableCount": "<p>The number of patches from the patch baseline that aren’t applicable for the instance and hence aren’t installed on the instance.</p>"
"InstancePatchState$NotApplicableCount": "<p>The number of patches from the patch baseline that aren't applicable for the instance and hence aren't installed on the instance.</p>"
}
},
"PatchOperationEndTime": {
@ -3249,8 +3257,8 @@
"base": null,
"refs": {
"DescribeAvailablePatchesRequest$Filters": "<p>Filters used to scope down the returned patches.</p>",
"DescribeInstancePatchesRequest$Filters": "<p>Each entry in the array is a structure containing:</p> <p>Key (string, 1 ≤ length ≤ 128)</p> <p>Values (array of strings 1 ≤ length ≤ 256)</p>",
"DescribePatchBaselinesRequest$Filters": "<p>Each element in the array is a structure containing: </p> <p>Key: (string, “NAME_PREFIX” or “OWNER”)</p> <p>Value: (array of strings, exactly 1 entry, 1 ≤ length ≤ 255)</p>"
"DescribeInstancePatchesRequest$Filters": "<p>Each entry in the array is a structure containing:</p> <p>Key (string, between 1 and 128 characters)</p> <p>Values (array of strings, each string between 1 and 256 characters)</p>",
"DescribePatchBaselinesRequest$Filters": "<p>Each element in the array is a structure containing: </p> <p>Key: (string, \"NAME_PREFIX\" or \"OWNER\")</p> <p>Value: (array of strings, exactly 1 entry, between 1 and 255 characters)</p>"
}
},
"PatchOrchestratorFilterValue": {
@ -3462,7 +3470,7 @@
"base": null,
"refs": {
"CommandPlugin$ResponseCode": "<p>A numeric response code generated after executing the plugin. </p>",
"GetCommandInvocationResult$ResponseCode": "<p>The error level response code for the plugin script. If the response code is <code>-1</code>, then the command has not started executing on the instance, or it was not received by the instance.</p>"
"GetCommandInvocationResult$ResponseCode": "<p>The error level response code for the plugin script. If the response code is -1, then the command has not started executing on the instance, or it was not received by the instance.</p>"
}
},
"ResultAttribute": {
@ -3481,7 +3489,7 @@
"base": null,
"refs": {
"Command$OutputS3BucketName": "<p>The S3 bucket where the responses to the command executions should be stored. This was requested when issuing the command.</p>",
"CommandPlugin$OutputS3BucketName": "<p>The S3 bucket where the responses to the command executions should be stored. This was requested when issuing the command. For example, in the following response:</p> <p> <code>test_folder/ab19cb99-a030-46dd-9dfc-8eSAMPLEPre-Fix/i-1234567876543/awsrunShellScript</code> </p> <p> <code>test_folder</code> is the name of the Amazon S3 bucket;</p> <p> <code>ab19cb99-a030-46dd-9dfc-8eSAMPLEPre-Fix</code> is the name of the S3 prefix;</p> <p> <code>i-1234567876543</code> is the instance ID;</p> <p> <code>awsrunShellScript</code> is the name of the plugin.</p>",
"CommandPlugin$OutputS3BucketName": "<p>The S3 bucket where the responses to the command executions should be stored. This was requested when issuing the command. For example, in the following response:</p> <p> test_folder/ab19cb99-a030-46dd-9dfc-8eSAMPLEPre-Fix/i-1234567876543/awsrunShellScript </p> <p>test_folder is the name of the Amazon S3 bucket;</p> <p> ab19cb99-a030-46dd-9dfc-8eSAMPLEPre-Fix is the name of the S3 prefix;</p> <p>i-1234567876543 is the instance ID;</p> <p>awsrunShellScript is the name of the plugin.</p>",
"LoggingInfo$S3BucketName": "<p>The name of an Amazon S3 bucket where execution logs are stored .</p>",
"S3OutputLocation$OutputS3BucketName": "<p>The name of the Amazon S3 bucket.</p>",
"SendCommandRequest$OutputS3BucketName": "<p>The name of the S3 bucket where command execution responses should be stored.</p>"
@ -3491,7 +3499,7 @@
"base": null,
"refs": {
"Command$OutputS3KeyPrefix": "<p>The S3 directory path inside the bucket where the responses to the command executions should be stored. This was requested when issuing the command.</p>",
"CommandPlugin$OutputS3KeyPrefix": "<p>The S3 directory path inside the bucket where the responses to the command executions should be stored. This was requested when issuing the command. For example, in the following response:</p> <p> <code>test_folder/ab19cb99-a030-46dd-9dfc-8eSAMPLEPre-Fix/i-1234567876543/awsrunShellScript</code> </p> <p> <code>test_folder</code> is the name of the Amazon S3 bucket;</p> <p> <code>ab19cb99-a030-46dd-9dfc-8eSAMPLEPre-Fix</code> is the name of the S3 prefix;</p> <p> <code>i-1234567876543</code> is the instance ID;</p> <p> <code>awsrunShellScript</code> is the name of the plugin.</p>",
"CommandPlugin$OutputS3KeyPrefix": "<p>The S3 directory path inside the bucket where the responses to the command executions should be stored. This was requested when issuing the command. For example, in the following response:</p> <p> test_folder/ab19cb99-a030-46dd-9dfc-8eSAMPLEPre-Fix/i-1234567876543/awsrunShellScript </p> <p>test_folder is the name of the Amazon S3 bucket;</p> <p> ab19cb99-a030-46dd-9dfc-8eSAMPLEPre-Fix is the name of the S3 prefix;</p> <p>i-1234567876543 is the instance ID;</p> <p>awsrunShellScript is the name of the plugin.</p>",
"LoggingInfo$S3KeyPrefix": "<p>(Optional) The Amazon S3 bucket subfolder. </p>",
"S3OutputLocation$OutputS3KeyPrefix": "<p>The Amazon S3 bucket subfolder.</p>",
"SendCommandRequest$OutputS3KeyPrefix": "<p>The directory structure within the S3 bucket where the responses should be stored.</p>"
@ -3525,8 +3533,8 @@
"Association$ScheduleExpression": "<p>A cron expression that specifies a schedule when the association runs.</p>",
"AssociationDescription$ScheduleExpression": "<p>A cron expression that specifies a schedule when the association runs.</p>",
"CreateAssociationBatchRequestEntry$ScheduleExpression": "<p>A cron expression that specifies a schedule when the association runs.</p>",
"CreateAssociationRequest$ScheduleExpression": "<p>A cron expression when the association will be applied to the target(s). Supported expressions are every half, 1, 2, 4, 8 or 12 hour(s); every specified day and time of the week. For example: cron(0 0/30 * 1/1 * ? *) to run every thirty minutes; cron(0 0 0/4 1/1 * ? *) to run every four hours; and cron(0 0 10 ? * SUN *) to run every Sunday at 10 a.m.</p>",
"UpdateAssociationRequest$ScheduleExpression": "<p>The cron expression used to schedule the association that you want to update. Supported expressions are every half, 1, 2, 4, 8 or 12 hour(s); every specified day and time of the week. For example: cron(0 0/30 * 1/1 * ? *) to run every thirty minutes; cron(0 0 0/4 1/1 * ? *) to run every four hours; and cron(0 0 10 ? * SUN *) to run every Sunday at 10 a.m.</p>"
"CreateAssociationRequest$ScheduleExpression": "<p>A cron expression when the association will be applied to the target(s).</p>",
"UpdateAssociationRequest$ScheduleExpression": "<p>The cron expression used to schedule the association that you want to update.</p>"
}
},
"SendCommandRequest": {
@ -3573,7 +3581,7 @@
"StandardOutputContent": {
"base": null,
"refs": {
"GetCommandInvocationResult$StandardOutputContent": "<p>The first 24,000 characters written by the plugin to stdout. If the command has not finished executing, if <code>ExecutionStatus</code> is neither <code>Succeeded</code> nor <code>Failed</code>, then this string is empty.</p>"
"GetCommandInvocationResult$StandardOutputContent": "<p>The first 24,000 characters written by the plugin to stdout. If the command has not finished executing, if ExecutionStatus is neither Succeeded nor Failed, then this string is empty.</p>"
}
},
"StartAutomationExecutionRequest": {
@ -3595,10 +3603,10 @@
"StatusDetails": {
"base": null,
"refs": {
"Command$StatusDetails": "<p>A detailed status of the command execution. <code>StatusDetails</code> includes more information than <code>Status</code> because it includes states resulting from error and concurrency control parameters. <code>StatusDetails</code> can show different results than <code>Status</code>. For more information about these statuses, see <a href=\"http://docs.aws.amazon.com/systems-manager/latest/userguide/monitor-about-status.html\">Run Command Status</a>. <code>StatusDetails</code> can be one of the following values:</p> <ul> <li> <p>Pending – The command has not been sent to any instances.</p> </li> <li> <p>In Progress – The command has been sent to at least one instance but has not reached a final state on all instances.</p> </li> <li> <p>Success – The command successfully executed on all invocations. This is a terminal state.</p> </li> <li> <p>Delivery Timed Out – The value of <code>MaxErrors</code> or more command invocations shows a status of <code>Delivery Timed Out</code>. This is a terminal state.</p> </li> <li> <p>Execution Timed Out – The value of <code>MaxErrors</code> or more command invocations shows a status of <code>Execution Timed Out</code>. This is a terminal state.</p> </li> <li> <p>Failed – The value of <code>MaxErrors</code> or more command invocations shows a status of <code>Failed</code>. This is a terminal state.</p> </li> <li> <p>Incomplete – The command was attempted on all instances and one or more invocations does not have a value of <code>Success</code> but not enough invocations failed for the status to be <code>Failed</code>. This is a terminal state.</p> </li> <li> <p>Canceled – The command was terminated before it was completed. This is a terminal state.</p> </li> <li> <p>Rate Exceeded – The number of instances targeted by the command exceeded the account limit for pending invocations. The system has canceled the command before executing it on any instance. This is a terminal state.</p> </li> </ul>",
"CommandInvocation$StatusDetails": "<p>A detailed status of the command execution for each invocation (each instance targeted by the command). <code>StatusDetails</code> includes more information than <code>Status</code> because it includes states resulting from error and concurrency control parameters. <code>StatusDetails</code> can show different results than <code>Status</code>. For more information about these statuses, see <a href=\"http://docs.aws.amazon.com/systems-manager/latest/userguide/monitor-about-status.html\">Run Command Status</a>. <code>StatusDetails</code> can be one of the following values:</p> <ul> <li> <p>Pending – The command has not been sent to the instance.</p> </li> <li> <p>In Progress – The command has been sent to the instance but has not reached a terminal state.</p> </li> <li> <p>Success – The execution of the command or plugin was successfully completed. This is a terminal state.</p> </li> <li> <p>Delivery Timed Out – The command was not delivered to the instance before the delivery timeout expired. Delivery timeouts do not count against the parent command’s <code>MaxErrors</code> limit, but they do contribute to whether the parent command status is <code>Success</code> or <code>Incomplete</code>. This is a terminal state.</p> </li> <li> <p>Execution Timed Out – Command execution started on the instance, but the execution was not complete before the execution timeout expired. Execution timeouts count against the <code>MaxErrors</code> limit of the parent command. This is a terminal state.</p> </li> <li> <p>Failed – The command was not successful on the instance. For a plugin, this indicates that the result code was not zero. For a command invocation, this indicates that the result code for one or more plugins was not zero. Invocation failures count against the <code>MaxErrors</code> limit of the parent command. This is a terminal state.</p> </li> <li> <p>Canceled – The command was terminated before it was completed. This is a terminal state.</p> </li> <li> <p>Undeliverable – The command can't be delivered to the instance. The instance might not exist or might not be responding. Undeliverable invocations don't count against the parent command’s <code>MaxErrors</code> limit and don't contribute to whether the parent command status is <code>Success</code> or <code>Incomplete</code>. This is a terminal state.</p> </li> <li> <p>Terminated – The parent command exceeded its <code>MaxErrors</code> limit and subsequent command invocations were canceled by the system. This is a terminal state.</p> </li> </ul>",
"CommandPlugin$StatusDetails": "<p>A detailed status of the plugin execution. <code>StatusDetails</code> includes more information than <code>Status</code> because it includes states resulting from error and concurrency control parameters. <code>StatusDetails</code> can show different results than <code>Status</code>. For more information about these statuses, see <a href=\"http://docs.aws.amazon.com/systems-manager/latest/userguide/monitor-about-status.html\">Run Command Status</a>. <code>StatusDetails</code> can be one of the following values:</p> <ul> <li> <p>Pending – The command has not been sent to the instance.</p> </li> <li> <p>In Progress – The command has been sent to the instance but has not reached a terminal state.</p> </li> <li> <p>Success – The execution of the command or plugin was successfully completed. This is a terminal state.</p> </li> <li> <p>Delivery Timed Out – The command was not delivered to the instance before the delivery timeout expired. Delivery timeouts do not count against the parent command’s <code>MaxErrors</code> limit, but they do contribute to whether the parent command status is <code>Success</code> or <code>Incomplete</code>. This is a terminal state.</p> </li> <li> <p>Execution Timed Out – Command execution started on the instance, but the execution was not complete before the execution timeout expired. Execution timeouts count against the <code>MaxErrors</code> limit of the parent command. This is a terminal state.</p> </li> <li> <p>Failed – The command was not successful on the instance. For a plugin, this indicates that the result code was not zero. For a command invocation, this indicates that the result code for one or more plugins was not zero. Invocation failures count against the <code>MaxErrors</code> limit of the parent command. This is a terminal state.</p> </li> <li> <p>Canceled – The command was terminated before it was completed. This is a terminal state.</p> </li> <li> <p>Undeliverable – The command can't be delivered to the instance. The instance might not exist, or it might not be responding. Undeliverable invocations don't count against the parent command’s <code>MaxErrors</code> limit, and they don't contribute to whether the parent command status is <code>Success</code> or <code>Incomplete</code>. This is a terminal state.</p> </li> <li> <p>Terminated – The parent command exceeded its <code>MaxErrors</code> limit and subsequent command invocations were canceled by the system. This is a terminal state.</p> </li> </ul>",
"GetCommandInvocationResult$StatusDetails": "<p>A detailed status of the command execution for an invocation. <code>StatusDetails</code> includes more information than <code>Status</code> because it includes states resulting from error and concurrency control parameters. <code>StatusDetails</code> can show different results than <code>Status</code>. For more information about these statuses, see <a href=\"http://docs.aws.amazon.com/systems-manager/latest/userguide/monitor-about-status.html\">Run Command Status</a>. <code>StatusDetails</code> can be one of the following values:</p> <ul> <li> <p>Pending – The command has not been sent to the instance.</p> </li> <li> <p>In Progress – The command has been sent to the instance but has not reached a terminal state.</p> </li> <li> <p>Delayed – The system attempted to send the command to the target, but the target was not available. The instance might not be available because of network issues, the instance was stopped, etc. The system will try to deliver the command again.</p> </li> <li> <p>Success – The command or plugin was executed successfully. This is a terminal state.</p> </li> <li> <p>Delivery Timed Out – The command was not delivered to the instance before the delivery timeout expired. Delivery timeouts do not count against the parent command’s <code>MaxErrors</code> limit, but they do contribute to whether the parent command status is <code>Success</code> or <code>Incomplete</code>. This is a terminal state.</p> </li> <li> <p>Execution Timed Out – The command started to execute on the instance, but the execution was not complete before the timeout expired. Execution timeouts count against the <code>MaxErrors</code> limit of the parent command. This is a terminal state.</p> </li> <li> <p>Failed – The command wasn't executed successfully on the instance. For a plugin, this indicates that the result code was not zero. For a command invocation, this indicates that the result code for one or more plugins was not zero. Invocation failures count against the <code>MaxErrors</code> limit of the parent command. This is a terminal state.</p> </li> <li> <p>Canceled – The command was terminated before it was completed. This is a terminal state.</p> </li> <li> <p>Undeliverable – The command can't be delivered to the instance. The instance might not exist or might not be responding. Undeliverable invocations don't count against the parent command’s <code>MaxErrors</code> limit and don't contribute to whether the parent command status is <code>Success</code> or <code>Incomplete</code>. This is a terminal state.</p> </li> <li> <p>Terminated – The parent command exceeded its <code>MaxErrors</code> limit and subsequent command invocations were canceled by the system. This is a terminal state.</p> </li> </ul>"
"Command$StatusDetails": "<p>A detailed status of the command execution. StatusDetails includes more information than Status because it includes states resulting from error and concurrency control parameters. StatusDetails can show different results than Status. For more information about these statuses, see <a href=\"http://docs.aws.amazon.com/systems-manager/latest/userguide/monitor-about-status.html\">Run Command Status</a>. StatusDetails can be one of the following values:</p> <ul> <li> <p>Pending: The command has not been sent to any instances.</p> </li> <li> <p>In Progress: The command has been sent to at least one instance but has not reached a final state on all instances.</p> </li> <li> <p>Success: The command successfully executed on all invocations. This is a terminal state.</p> </li> <li> <p>Delivery Timed Out: The value of MaxErrors or more command invocations shows a status of Delivery Timed Out. This is a terminal state.</p> </li> <li> <p>Execution Timed Out: The value of MaxErrors or more command invocations shows a status of Execution Timed Out. This is a terminal state.</p> </li> <li> <p>Failed: The value of MaxErrors or more command invocations shows a status of Failed. This is a terminal state.</p> </li> <li> <p>Incomplete: The command was attempted on all instances and one or more invocations does not have a value of Success but not enough invocations failed for the status to be Failed. This is a terminal state.</p> </li> <li> <p>Canceled: The command was terminated before it was completed. This is a terminal state.</p> </li> <li> <p>Rate Exceeded: The number of instances targeted by the command exceeded the account limit for pending invocations. The system has canceled the command before executing it on any instance. This is a terminal state.</p> </li> </ul>",
"CommandInvocation$StatusDetails": "<p>A detailed status of the command execution for each invocation (each instance targeted by the command). StatusDetails includes more information than Status because it includes states resulting from error and concurrency control parameters. StatusDetails can show different results than Status. For more information about these statuses, see <a href=\"http://docs.aws.amazon.com/systems-manager/latest/userguide/monitor-about-status.html\">Run Command Status</a>. StatusDetails can be one of the following values:</p> <ul> <li> <p>Pending: The command has not been sent to the instance.</p> </li> <li> <p>In Progress: The command has been sent to the instance but has not reached a terminal state.</p> </li> <li> <p>Success: The execution of the command or plugin was successfully completed. This is a terminal state.</p> </li> <li> <p>Delivery Timed Out: The command was not delivered to the instance before the delivery timeout expired. Delivery timeouts do not count against the parent command's MaxErrors limit, but they do contribute to whether the parent command status is Success or Incomplete. This is a terminal state.</p> </li> <li> <p>Execution Timed Out: Command execution started on the instance, but the execution was not complete before the execution timeout expired. Execution timeouts count against the MaxErrors limit of the parent command. This is a terminal state.</p> </li> <li> <p>Failed: The command was not successful on the instance. For a plugin, this indicates that the result code was not zero. For a command invocation, this indicates that the result code for one or more plugins was not zero. Invocation failures count against the MaxErrors limit of the parent command. This is a terminal state.</p> </li> <li> <p>Canceled: The command was terminated before it was completed. This is a terminal state.</p> </li> <li> <p>Undeliverable: The command can't be delivered to the instance. The instance might not exist or might not be responding. Undeliverable invocations don't count against the parent command's MaxErrors limit and don't contribute to whether the parent command status is Success or Incomplete. This is a terminal state.</p> </li> <li> <p>Terminated: The parent command exceeded its MaxErrors limit and subsequent command invocations were canceled by the system. This is a terminal state.</p> </li> </ul>",
"CommandPlugin$StatusDetails": "<p>A detailed status of the plugin execution. StatusDetails includes more information than Status because it includes states resulting from error and concurrency control parameters. StatusDetails can show different results than Status. For more information about these statuses, see <a href=\"http://docs.aws.amazon.com/systems-manager/latest/userguide/monitor-about-status.html\">Run Command Status</a>. StatusDetails can be one of the following values:</p> <ul> <li> <p>Pending: The command has not been sent to the instance.</p> </li> <li> <p>In Progress: The command has been sent to the instance but has not reached a terminal state.</p> </li> <li> <p>Success: The execution of the command or plugin was successfully completed. This is a terminal state.</p> </li> <li> <p>Delivery Timed Out: The command was not delivered to the instance before the delivery timeout expired. Delivery timeouts do not count against the parent command's MaxErrors limit, but they do contribute to whether the parent command status is Success or Incomplete. This is a terminal state.</p> </li> <li> <p>Execution Timed Out: Command execution started on the instance, but the execution was not complete before the execution timeout expired. Execution timeouts count against the MaxErrors limit of the parent command. This is a terminal state.</p> </li> <li> <p>Failed: The command was not successful on the instance. For a plugin, this indicates that the result code was not zero. For a command invocation, this indicates that the result code for one or more plugins was not zero. Invocation failures count against the MaxErrors limit of the parent command. This is a terminal state.</p> </li> <li> <p>Canceled: The command was terminated before it was completed. This is a terminal state.</p> </li> <li> <p>Undeliverable: The command can't be delivered to the instance. The instance might not exist, or it might not be responding. Undeliverable invocations don't count against the parent command's MaxErrors limit, and they don't contribute to whether the parent command status is Success or Incomplete. This is a terminal state.</p> </li> <li> <p>Terminated: The parent command exceeded its MaxErrors limit and subsequent command invocations were canceled by the system. This is a terminal state.</p> </li> </ul>",
"GetCommandInvocationResult$StatusDetails": "<p>A detailed status of the command execution for an invocation. StatusDetails includes more information than Status because it includes states resulting from error and concurrency control parameters. StatusDetails can show different results than Status. For more information about these statuses, see <a href=\"http://docs.aws.amazon.com/systems-manager/latest/userguide/monitor-about-status.html\">Run Command Status</a>. StatusDetails can be one of the following values:</p> <ul> <li> <p>Pending: The command has not been sent to the instance.</p> </li> <li> <p>In Progress: The command has been sent to the instance but has not reached a terminal state.</p> </li> <li> <p>Delayed: The system attempted to send the command to the target, but the target was not available. The instance might not be available because of network issues, the instance was stopped, etc. The system will try to deliver the command again.</p> </li> <li> <p>Success: The command or plugin was executed successfully. This is a terminal state.</p> </li> <li> <p>Delivery Timed Out: The command was not delivered to the instance before the delivery timeout expired. Delivery timeouts do not count against the parent command's MaxErrors limit, but they do contribute to whether the parent command status is Success or Incomplete. This is a terminal state.</p> </li> <li> <p>Execution Timed Out: The command started to execute on the instance, but the execution was not complete before the timeout expired. Execution timeouts count against the MaxErrors limit of the parent command. This is a terminal state.</p> </li> <li> <p>Failed: The command wasn't executed successfully on the instance. For a plugin, this indicates that the result code was not zero. For a command invocation, this indicates that the result code for one or more plugins was not zero. Invocation failures count against the MaxErrors limit of the parent command. This is a terminal state.</p> </li> <li> <p>Canceled: The command was terminated before it was completed. This is a terminal state.</p> </li> <li> <p>Undeliverable: The command can't be delivered to the instance. The instance might not exist or might not be responding. Undeliverable invocations don't count against the parent command's MaxErrors limit and don't contribute to whether the parent command status is Success or Incomplete. This is a terminal state.</p> </li> <li> <p>Terminated: The parent command exceeded its MaxErrors limit and subsequent command invocations were canceled by the system. This is a terminal state.</p> </li> </ul>"
}
},
"StatusMessage": {
@ -3610,7 +3618,7 @@
"StatusName": {
"base": null,
"refs": {
"AssociationOverview$Status": "<p>The status of the association. Status can be: <code>Pending</code>, <code>Success</code>, or <code>Failed</code>.</p>",
"AssociationOverview$Status": "<p>The status of the association. Status can be: Pending, Success, or Failed.</p>",
"AssociationOverview$DetailedStatus": "<p>A detailed status of the association.</p>",
"AssociationStatusAggregatedCount$key": null,
"InstanceAggregatedAssociationOverview$DetailedStatus": "<p>Detailed status information about the aggregated associations.</p>",
@ -3666,6 +3674,8 @@
"DocumentVersionLimitExceeded$Message": null,
"DoesNotExistException$Message": null,
"DuplicateDocumentContent$Message": null,
"FailureDetails$FailureStage": "<p>The stage of the Automation execution when the failure occurred. The stages include the following: InputValidation, PreVerification, Invocation, PostVerification.</p>",
"FailureDetails$FailureType": "<p>The type of Automation failure. Failure types include the following: Action, Permission, Throttling, Verification, Internal.</p>",
"IdempotentParameterMismatch$Message": null,
"InstanceInformation$PlatformName": "<p>The name of the operating system platform running on your instance. </p>",
"InstanceInformation$PlatformVersion": "<p>The version of the OS platform running on your instance. </p>",
@ -3723,7 +3733,7 @@
"base": null,
"refs": {
"GetCommandInvocationResult$ExecutionStartDateTime": "<p>The date and time the plugin started executing. Date and time are written in ISO 8601 format. For example, August 28, 2016 is represented as 2016-08-28. If the plugin has not started to execute, the string is empty.</p>",
"GetCommandInvocationResult$ExecutionElapsedTime": "<p>Duration since <code>ExecutionStartDateTime</code>.</p>",
"GetCommandInvocationResult$ExecutionElapsedTime": "<p>Duration since ExecutionStartDateTime.</p>",
"GetCommandInvocationResult$ExecutionEndDateTime": "<p>The date and time the plugin was finished executing. Date and time are written in ISO 8601 format. For example, August 28, 2016 is represented as 2016-08-28. If the plugin has not started to execute, the string is empty.</p>"
}
},
@ -3760,7 +3770,7 @@
}
},
"Target": {
"base": "<p>An array of search criteria that targets instances using a <code>Key</code>,<code>Value</code> combination that you specify. <code>Targets</code> is required if you don't provide one or more instance IDs in the call.</p>",
"base": "<p>An array of search criteria that targets instances using a Key,Value combination that you specify. Targets is required if you don't provide one or more instance IDs in the call.</p>",
"refs": {
"Targets$member": null
}
@ -3774,7 +3784,7 @@
"TargetKey": {
"base": null,
"refs": {
"Target$Key": "<p>User-defined criteria for sending commands that target instances that meet the criteria. <code>Key</code> can be <code>tag:&lt;Amazon EC2 tag&gt;</code> or <code>InstanceIds</code>. For more information about how to send commands that target instances using <code>Key</code>,<code>Value</code> parameters, see <a href=\"http://docs.aws.amazon.com/systems-manager/latest/userguide/run-command.html\">Executing a Command Using Systems Manager Run Command</a>.</p>"
"Target$Key": "<p>User-defined criteria for sending commands that target instances that meet the criteria. Key can be tag:&lt;Amazon EC2 tag&gt; or InstanceIds. For more information about how to send commands that target instances using Key,Value parameters, see <a href=\"http://docs.aws.amazon.com/systems-manager/latest/userguide/run-command.html\">Executing a Command Using Systems Manager Run Command</a>.</p>"
}
},
"TargetValue": {
@ -3786,7 +3796,7 @@
"TargetValues": {
"base": null,
"refs": {
"Target$Values": "<p>User-defined criteria that maps to <code>Key</code>. For example, if you specified <code>tag:ServerRole</code>, you could specify <code>value:WebServer</code> to execute a command on instances that include Amazon EC2 tags of ServerRole,WebServer. For more information about how to send commands that target instances using <code>Key</code>,<code>Value</code> parameters, see <a href=\"http://docs.aws.amazon.com/systems-manager/latest/userguide/run-command.html\">Executing a Command Using Systems Manager Run Command</a>.</p>"
"Target$Values": "<p>User-defined criteria that maps to Key. For example, if you specified tag:ServerRole, you could specify value:WebServer to execute a command on instances that include Amazon EC2 tags of ServerRole,WebServer. For more information about how to send commands that target instances using Key,Value parameters, see <a href=\"http://docs.aws.amazon.com/systems-manager/latest/userguide/run-command.html\">Executing a Command Using Systems Manager Run Command</a>.</p>"
}
},
"Targets": {
@ -3794,14 +3804,15 @@
"refs": {
"Association$Targets": "<p>The instances targeted by the request to create an association. </p>",
"AssociationDescription$Targets": "<p>The instances targeted by the request. </p>",
"Command$Targets": "<p>An array of search criteria that targets instances using a <code>Key</code>,<code>Value</code> combination that you specify. <code>Targets</code> is required if you don't provide one or more instance IDs in the call.</p>",
"Command$Targets": "<p>An array of search criteria that targets instances using a Key,Value combination that you specify. Targets is required if you don't provide one or more instance IDs in the call.</p>",
"CreateAssociationBatchRequestEntry$Targets": "<p>The instances targeted by the request.</p>",
"CreateAssociationRequest$Targets": "<p>The targets (either instances or tags) for the association. Instances are specified using Key=instanceids,Values=&lt;instanceid1&gt;,&lt;instanceid2&gt;. Tags are specified using Key=&lt;tag name&gt;,Values=&lt;tag value&gt;.</p>",
"CreateAssociationRequest$Targets": "<p>The targets (either instances or tags) for the association.</p>",
"MaintenanceWindowTarget$Targets": "<p>The targets (either instances or tags). Instances are specified using Key=instanceids,Values=&lt;instanceid1&gt;,&lt;instanceid2&gt;. Tags are specified using Key=&lt;tag name&gt;,Values=&lt;tag value&gt;.</p>",
"MaintenanceWindowTask$Targets": "<p>The targets (either instances or tags). Instances are specified using Key=instanceids,Values=&lt;instanceid1&gt;,&lt;instanceid2&gt;. Tags are specified using Key=&lt;tag name&gt;,Values=&lt;tag value&gt;.</p>",
"RegisterTargetWithMaintenanceWindowRequest$Targets": "<p>The targets (either instances or tags). Instances are specified using Key=instanceids,Values=&lt;instanceid1&gt;,&lt;instanceid2&gt;. Tags are specified using Key=&lt;tag name&gt;,Values=&lt;tag value&gt;.</p>",
"RegisterTaskWithMaintenanceWindowRequest$Targets": "<p>The targets (either instances or tags). Instances are specified using Key=instanceids,Values=&lt;instanceid1&gt;,&lt;instanceid2&gt;. Tags are specified using Key=&lt;tag name&gt;,Values=&lt;tag value&gt;.</p>",
"SendCommandRequest$Targets": "<p>(Optional) An array of search criteria that targets instances using a <code>Key</code>,<code>Value</code> combination that you specify. <code>Targets</code> is required if you don't provide one or more instance IDs in the call. For more information about how to use <code>Targets</code>, see <a href=\"http://docs.aws.amazon.com/systems-manager/latest/userguide/run-command.html\">Executing a Command Using Systems Manager Run Command</a>.</p>"
"SendCommandRequest$Targets": "<p>(Optional) An array of search criteria that targets instances using a Key,Value combination that you specify. Targets is required if you don't provide one or more instance IDs in the call. For more information about how to use Targets, see <a href=\"http://docs.aws.amazon.com/systems-manager/latest/userguide/run-command.html\">Executing a Command Using Systems Manager Run Command</a>.</p>",
"UpdateAssociationRequest$Targets": "<p>The targets of the association.</p>"
}
},
"TimeoutSeconds": {
@ -3811,7 +3822,7 @@
}
},
"TooManyTagsError": {
"base": "<p>The <code>Targets</code> parameter includes too many tags. Remove one or more tags and try the command again.</p>",
"base": "<p>The Targets parameter includes too many tags. Remove one or more tags and try the command again.</p>",
"refs": {
}
},
@ -3826,7 +3837,7 @@
}
},
"UnsupportedInventorySchemaVersionException": {
"base": "<p>Inventory item type schema version has to match supported versions in the service. Check output of <code>GetInventorySchema</code> to see the available schema version for each type.</p>",
"base": "<p>Inventory item type schema version has to match supported versions in the service. Check output of GetInventorySchema to see the available schema version for each type.</p>",
"refs": {
}
},
@ -3913,8 +3924,8 @@
"Url": {
"base": null,
"refs": {
"CommandInvocation$StandardOutputUrl": "<p>The URL to the plugin’s StdOut file in Amazon S3, if the Amazon S3 bucket was defined for the parent command. For an invocation, <code>StandardOutputUrl</code> is populated if there is just one plugin defined for the command, and the Amazon S3 bucket was defined for the command.</p>",
"CommandInvocation$StandardErrorUrl": "<p>The URL to the plugin’s StdErr file in Amazon S3, if the Amazon S3 bucket was defined for the parent command. For an invocation, <code>StandardErrorUrl</code> is populated if there is just one plugin defined for the command, and the Amazon S3 bucket was defined for the command.</p>",
"CommandInvocation$StandardOutputUrl": "<p>The URL to the plugin's StdOut file in Amazon S3, if the Amazon S3 bucket was defined for the parent command. For an invocation, StandardOutputUrl is populated if there is just one plugin defined for the command, and the Amazon S3 bucket was defined for the command.</p>",
"CommandInvocation$StandardErrorUrl": "<p>The URL to the plugin's StdErr file in Amazon S3, if the Amazon S3 bucket was defined for the parent command. For an invocation, StandardErrorUrl is populated if there is just one plugin defined for the command, and the Amazon S3 bucket was defined for the command.</p>",
"CommandPlugin$StandardOutputUrl": "<p>The URL for the complete text written by the plugin to stdout in Amazon S3. If the Amazon S3 bucket for the command was not specified, then this string is empty.</p>",
"CommandPlugin$StandardErrorUrl": "<p>The URL for the complete text written by the plugin to stderr. If execution is not yet complete, then this string is empty.</p>",
"GetCommandInvocationResult$StandardOutputUrl": "<p>The URL for the complete text written by the plugin to stdout in Amazon S3. If an Amazon S3 bucket was not specified, then this string is empty.</p>",

3594
vendor/github.com/aws/aws-sdk-go/models/endpoints/endpoints.json generated vendored
View File

File diff suppressed because it is too large Load Diff

2749
vendor/github.com/aws/aws-sdk-go/service/athena/api.go generated vendored Normal file
View File

File diff suppressed because it is too large Load Diff

117
vendor/github.com/aws/aws-sdk-go/service/athena/athenaiface/interface.go generated vendored Normal file
View File

@ -0,0 +1,117 @@
// Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT.
// Package athenaiface provides an interface to enable mocking the Amazon Athena service client
// for testing your code.
//
// It is important to note that this interface will have breaking changes
// when the service model is updated and adds new API operations, paginators,
// and waiters.
package athenaiface
import (
"github.com/aws/aws-sdk-go/aws"
"github.com/aws/aws-sdk-go/aws/request"
"github.com/aws/aws-sdk-go/service/athena"
)
// AthenaAPI provides an interface to enable mocking the
// athena.Athena service client's API operation,
// paginators, and waiters. This make unit testing your code that calls out
// to the SDK's service client's calls easier.
//
// The best way to use this interface is so the SDK's service client's calls
// can be stubbed out for unit testing your code with the SDK without needing
// to inject custom request handlers into the the SDK's request pipeline.
//
// // myFunc uses an SDK service client to make a request to
// // Amazon Athena.
// func myFunc(svc athenaiface.AthenaAPI) bool {
// // Make svc.BatchGetNamedQuery request
// }
//
// func main() {
// sess := session.New()
// svc := athena.New(sess)
//
// myFunc(svc)
// }
//
// In your _test.go file:
//
// // Define a mock struct to be used in your unit tests of myFunc.
// type mockAthenaClient struct {
// athenaiface.AthenaAPI
// }
// func (m *mockAthenaClient) BatchGetNamedQuery(input *athena.BatchGetNamedQueryInput) (*athena.BatchGetNamedQueryOutput, error) {
// // mock response/functionality
// }
//
// func TestMyFunc(t *testing.T) {
// // Setup Test
// mockSvc := &mockAthenaClient{}
//
// myfunc(mockSvc)
//
// // Verify myFunc's functionality
// }
//
// It is important to note that this interface will have breaking changes
// when the service model is updated and adds new API operations, paginators,
// and waiters. Its suggested to use the pattern above for testing, or using
// tooling to generate mocks to satisfy the interfaces.
type AthenaAPI interface {
BatchGetNamedQuery(*athena.BatchGetNamedQueryInput) (*athena.BatchGetNamedQueryOutput, error)
BatchGetNamedQueryWithContext(aws.Context, *athena.BatchGetNamedQueryInput, ...request.Option) (*athena.BatchGetNamedQueryOutput, error)
BatchGetNamedQueryRequest(*athena.BatchGetNamedQueryInput) (*request.Request, *athena.BatchGetNamedQueryOutput)
BatchGetQueryExecution(*athena.BatchGetQueryExecutionInput) (*athena.BatchGetQueryExecutionOutput, error)
BatchGetQueryExecutionWithContext(aws.Context, *athena.BatchGetQueryExecutionInput, ...request.Option) (*athena.BatchGetQueryExecutionOutput, error)
BatchGetQueryExecutionRequest(*athena.BatchGetQueryExecutionInput) (*request.Request, *athena.BatchGetQueryExecutionOutput)
CreateNamedQuery(*athena.CreateNamedQueryInput) (*athena.CreateNamedQueryOutput, error)
CreateNamedQueryWithContext(aws.Context, *athena.CreateNamedQueryInput, ...request.Option) (*athena.CreateNamedQueryOutput, error)
CreateNamedQueryRequest(*athena.CreateNamedQueryInput) (*request.Request, *athena.CreateNamedQueryOutput)
DeleteNamedQuery(*athena.DeleteNamedQueryInput) (*athena.DeleteNamedQueryOutput, error)
DeleteNamedQueryWithContext(aws.Context, *athena.DeleteNamedQueryInput, ...request.Option) (*athena.DeleteNamedQueryOutput, error)
DeleteNamedQueryRequest(*athena.DeleteNamedQueryInput) (*request.Request, *athena.DeleteNamedQueryOutput)
GetNamedQuery(*athena.GetNamedQueryInput) (*athena.GetNamedQueryOutput, error)
GetNamedQueryWithContext(aws.Context, *athena.GetNamedQueryInput, ...request.Option) (*athena.GetNamedQueryOutput, error)
GetNamedQueryRequest(*athena.GetNamedQueryInput) (*request.Request, *athena.GetNamedQueryOutput)
GetQueryExecution(*athena.GetQueryExecutionInput) (*athena.GetQueryExecutionOutput, error)
GetQueryExecutionWithContext(aws.Context, *athena.GetQueryExecutionInput, ...request.Option) (*athena.GetQueryExecutionOutput, error)
GetQueryExecutionRequest(*athena.GetQueryExecutionInput) (*request.Request, *athena.GetQueryExecutionOutput)
GetQueryResults(*athena.GetQueryResultsInput) (*athena.GetQueryResultsOutput, error)
GetQueryResultsWithContext(aws.Context, *athena.GetQueryResultsInput, ...request.Option) (*athena.GetQueryResultsOutput, error)
GetQueryResultsRequest(*athena.GetQueryResultsInput) (*request.Request, *athena.GetQueryResultsOutput)
GetQueryResultsPages(*athena.GetQueryResultsInput, func(*athena.GetQueryResultsOutput, bool) bool) error
GetQueryResultsPagesWithContext(aws.Context, *athena.GetQueryResultsInput, func(*athena.GetQueryResultsOutput, bool) bool, ...request.Option) error
ListNamedQueries(*athena.ListNamedQueriesInput) (*athena.ListNamedQueriesOutput, error)
ListNamedQueriesWithContext(aws.Context, *athena.ListNamedQueriesInput, ...request.Option) (*athena.ListNamedQueriesOutput, error)
ListNamedQueriesRequest(*athena.ListNamedQueriesInput) (*request.Request, *athena.ListNamedQueriesOutput)
ListNamedQueriesPages(*athena.ListNamedQueriesInput, func(*athena.ListNamedQueriesOutput, bool) bool) error
ListNamedQueriesPagesWithContext(aws.Context, *athena.ListNamedQueriesInput, func(*athena.ListNamedQueriesOutput, bool) bool, ...request.Option) error
ListQueryExecutions(*athena.ListQueryExecutionsInput) (*athena.ListQueryExecutionsOutput, error)
ListQueryExecutionsWithContext(aws.Context, *athena.ListQueryExecutionsInput, ...request.Option) (*athena.ListQueryExecutionsOutput, error)
ListQueryExecutionsRequest(*athena.ListQueryExecutionsInput) (*request.Request, *athena.ListQueryExecutionsOutput)
ListQueryExecutionsPages(*athena.ListQueryExecutionsInput, func(*athena.ListQueryExecutionsOutput, bool) bool) error
ListQueryExecutionsPagesWithContext(aws.Context, *athena.ListQueryExecutionsInput, func(*athena.ListQueryExecutionsOutput, bool) bool, ...request.Option) error
StartQueryExecution(*athena.StartQueryExecutionInput) (*athena.StartQueryExecutionOutput, error)
StartQueryExecutionWithContext(aws.Context, *athena.StartQueryExecutionInput, ...request.Option) (*athena.StartQueryExecutionOutput, error)
StartQueryExecutionRequest(*athena.StartQueryExecutionInput) (*request.Request, *athena.StartQueryExecutionOutput)
StopQueryExecution(*athena.StopQueryExecutionInput) (*athena.StopQueryExecutionOutput, error)
StopQueryExecutionWithContext(aws.Context, *athena.StopQueryExecutionInput, ...request.Option) (*athena.StopQueryExecutionOutput, error)
StopQueryExecutionRequest(*athena.StopQueryExecutionInput) (*request.Request, *athena.StopQueryExecutionOutput)
}
var _ AthenaAPI = (*athena.Athena)(nil)

91
vendor/github.com/aws/aws-sdk-go/service/athena/doc.go generated vendored Normal file
View File

@ -0,0 +1,91 @@
// Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT.
// Package athena provides the client and types for making API
// requests to Amazon Athena.
//
// Amazon Athena is an interactive query service that lets you use standard
// SQL to analyze data directly in Amazon S3. You can point Athena at your data
// in Amazon S3 and run ad-hoc queries and get results in seconds. Athena is
// serverless, so there is no infrastructure to set up or manage. You pay only
// for the queries you run. Athena scales automatically—executing queries in
// parallel—so results are fast, even with large datasets and complex queries.
// For more information, see What is Amazon Athena (http://docs.aws.amazon.com/athena/latest/ug/what-is.html)
// in the Amazon Athena User Guide.
//
// For code samples using the AWS SDK for Java, see Examples and Code Samples
// (http://docs.aws.amazon.com/athena/latest/ug/code-samples.html) in the Amazon
// Athena User Guide.
//
// See https://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18 for more information on this service.
//
// See athena package documentation for more information.
// https://docs.aws.amazon.com/sdk-for-go/api/service/athena/
//
// Using the Client
//
// To use the client for Amazon Athena you will first need
// to create a new instance of it.
//
// When creating a client for an AWS service you'll first need to have a Session
// already created. The Session provides configuration that can be shared
// between multiple service clients. Additional configuration can be applied to
// the Session and service's client when they are constructed. The aws package's
// Config type contains several fields such as Region for the AWS Region the
// client should make API requests too. The optional Config value can be provided
// as the variadic argument for Sessions and client creation.
//
// Once the service's client is created you can use it to make API requests the
// AWS service. These clients are safe to use concurrently.
//
// // Create a session to share configuration, and load external configuration.
// sess := session.Must(session.NewSession())
//
// // Create the service's client with the session.
// svc := athena.New(sess)
//
// See the SDK's documentation for more information on how to use service clients.
// https://docs.aws.amazon.com/sdk-for-go/api/
//
// See aws package's Config type for more information on configuration options.
// https://docs.aws.amazon.com/sdk-for-go/api/aws/#Config
//
// See the Amazon Athena client Athena for more
// information on creating the service's client.
// https://docs.aws.amazon.com/sdk-for-go/api/service/athena/#New
//
// Once the client is created you can make an API request to the service.
// Each API method takes a input parameter, and returns the service response
// and an error.
//
// The API method will document which error codes the service can be returned
// by the operation if the service models the API operation's errors. These
// errors will also be available as const strings prefixed with "ErrCode".
//
// result, err := svc.BatchGetNamedQuery(params)
// if err != nil {
// // Cast err to awserr.Error to handle specific error codes.
// aerr, ok := err.(awserr.Error)
// if ok && aerr.Code() == <error code to check for> {
// // Specific error code handling
// }
// return err
// }
//
// fmt.Println("BatchGetNamedQuery result:")
// fmt.Println(result)
//
// Using the Client with Context
//
// The service's client also provides methods to make API requests with a Context
// value. This allows you to control the timeout, and cancellation of pending
// requests. These methods also take request Option as variadic parameter to apply
// additional configuration to the API request.
//
// ctx := context.Background()
//
// result, err := svc.BatchGetNamedQueryWithContext(ctx, params)
//
// See the request package documentation for more information on using Context pattern
// with the SDK.
// https://docs.aws.amazon.com/sdk-for-go/api/aws/request/
package athena

26
vendor/github.com/aws/aws-sdk-go/service/athena/errors.go generated vendored Normal file
View File

@ -0,0 +1,26 @@
// Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT.
package athena
const (
// ErrCodeInternalServerException for service response error code
// "InternalServerException".
//
// Indicates a platform issue, which may be due to a transient condition or
// outage.
ErrCodeInternalServerException = "InternalServerException"
// ErrCodeInvalidRequestException for service response error code
// "InvalidRequestException".
//
// Indicates that something is wrong with the input to the request. For example,
// a required parameter may be missing or out of range.
ErrCodeInvalidRequestException = "InvalidRequestException"
// ErrCodeTooManyRequestsException for service response error code
// "TooManyRequestsException".
//
// Indicates that the request was throttled.
ErrCodeTooManyRequestsException = "TooManyRequestsException"
)

272
vendor/github.com/aws/aws-sdk-go/service/athena/examples_test.go generated vendored Normal file
View File

@ -0,0 +1,272 @@
// Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT.
package athena_test
import (
"bytes"
"fmt"
"time"
"github.com/aws/aws-sdk-go/aws"
"github.com/aws/aws-sdk-go/aws/session"
"github.com/aws/aws-sdk-go/service/athena"
)
var _ time.Duration
var _ bytes.Buffer
func ExampleAthena_BatchGetNamedQuery() {
sess := session.Must(session.NewSession())
svc := athena.New(sess)
params := &athena.BatchGetNamedQueryInput{
NamedQueryIds: []*string{ // Required
aws.String("NamedQueryId"), // Required
// More values...
},
}
resp, err := svc.BatchGetNamedQuery(params)
if err != nil {
// Print the error, cast err to awserr.Error to get the Code and
// Message from an error.
fmt.Println(err.Error())
return
}
// Pretty-print the response data.
fmt.Println(resp)
}
func ExampleAthena_BatchGetQueryExecution() {
sess := session.Must(session.NewSession())
svc := athena.New(sess)
params := &athena.BatchGetQueryExecutionInput{
QueryExecutionIds: []*string{ // Required
aws.String("QueryExecutionId"), // Required
// More values...
},
}
resp, err := svc.BatchGetQueryExecution(params)
if err != nil {
// Print the error, cast err to awserr.Error to get the Code and
// Message from an error.
fmt.Println(err.Error())
return
}
// Pretty-print the response data.
fmt.Println(resp)
}
func ExampleAthena_CreateNamedQuery() {
sess := session.Must(session.NewSession())
svc := athena.New(sess)
params := &athena.CreateNamedQueryInput{
Database: aws.String("DatabaseString"), // Required
Name: aws.String("NameString"), // Required
QueryString: aws.String("QueryString"), // Required
ClientRequestToken: aws.String("IdempotencyToken"),
Description: aws.String("DescriptionString"),
}
resp, err := svc.CreateNamedQuery(params)
if err != nil {
// Print the error, cast err to awserr.Error to get the Code and
// Message from an error.
fmt.Println(err.Error())
return
}
// Pretty-print the response data.
fmt.Println(resp)
}
func ExampleAthena_DeleteNamedQuery() {
sess := session.Must(session.NewSession())
svc := athena.New(sess)
params := &athena.DeleteNamedQueryInput{
NamedQueryId: aws.String("NamedQueryId"), // Required
}
resp, err := svc.DeleteNamedQuery(params)
if err != nil {
// Print the error, cast err to awserr.Error to get the Code and
// Message from an error.
fmt.Println(err.Error())
return
}
// Pretty-print the response data.
fmt.Println(resp)
}
func ExampleAthena_GetNamedQuery() {
sess := session.Must(session.NewSession())
svc := athena.New(sess)
params := &athena.GetNamedQueryInput{
NamedQueryId: aws.String("NamedQueryId"), // Required
}
resp, err := svc.GetNamedQuery(params)
if err != nil {
// Print the error, cast err to awserr.Error to get the Code and
// Message from an error.
fmt.Println(err.Error())
return
}
// Pretty-print the response data.
fmt.Println(resp)
}
func ExampleAthena_GetQueryExecution() {
sess := session.Must(session.NewSession())
svc := athena.New(sess)
params := &athena.GetQueryExecutionInput{
QueryExecutionId: aws.String("QueryExecutionId"), // Required
}
resp, err := svc.GetQueryExecution(params)
if err != nil {
// Print the error, cast err to awserr.Error to get the Code and
// Message from an error.
fmt.Println(err.Error())
return
}
// Pretty-print the response data.
fmt.Println(resp)
}
func ExampleAthena_GetQueryResults() {
sess := session.Must(session.NewSession())
svc := athena.New(sess)
params := &athena.GetQueryResultsInput{
QueryExecutionId: aws.String("QueryExecutionId"), // Required
MaxResults: aws.Int64(1),
NextToken: aws.String("Token"),
}
resp, err := svc.GetQueryResults(params)
if err != nil {
// Print the error, cast err to awserr.Error to get the Code and
// Message from an error.
fmt.Println(err.Error())
return
}
// Pretty-print the response data.
fmt.Println(resp)
}
func ExampleAthena_ListNamedQueries() {
sess := session.Must(session.NewSession())
svc := athena.New(sess)
params := &athena.ListNamedQueriesInput{
MaxResults: aws.Int64(1),
NextToken: aws.String("Token"),
}
resp, err := svc.ListNamedQueries(params)
if err != nil {
// Print the error, cast err to awserr.Error to get the Code and
// Message from an error.
fmt.Println(err.Error())
return
}
// Pretty-print the response data.
fmt.Println(resp)
}
func ExampleAthena_ListQueryExecutions() {
sess := session.Must(session.NewSession())
svc := athena.New(sess)
params := &athena.ListQueryExecutionsInput{
MaxResults: aws.Int64(1),
NextToken: aws.String("Token"),
}
resp, err := svc.ListQueryExecutions(params)
if err != nil {
// Print the error, cast err to awserr.Error to get the Code and
// Message from an error.
fmt.Println(err.Error())
return
}
// Pretty-print the response data.
fmt.Println(resp)
}
func ExampleAthena_StartQueryExecution() {
sess := session.Must(session.NewSession())
svc := athena.New(sess)
params := &athena.StartQueryExecutionInput{
QueryString: aws.String("QueryString"), // Required
ResultConfiguration: &athena.ResultConfiguration{ // Required
OutputLocation: aws.String("String"), // Required
EncryptionConfiguration: &athena.EncryptionConfiguration{
EncryptionOption: aws.String("EncryptionOption"), // Required
KmsKey: aws.String("String"),
},
},
ClientRequestToken: aws.String("IdempotencyToken"),
QueryExecutionContext: &athena.QueryExecutionContext{
Database: aws.String("DatabaseString"),
},
}
resp, err := svc.StartQueryExecution(params)
if err != nil {
// Print the error, cast err to awserr.Error to get the Code and
// Message from an error.
fmt.Println(err.Error())
return
}
// Pretty-print the response data.
fmt.Println(resp)
}
func ExampleAthena_StopQueryExecution() {
sess := session.Must(session.NewSession())
svc := athena.New(sess)
params := &athena.StopQueryExecutionInput{
QueryExecutionId: aws.String("QueryExecutionId"), // Required
}
resp, err := svc.StopQueryExecution(params)
if err != nil {
// Print the error, cast err to awserr.Error to get the Code and
// Message from an error.
fmt.Println(err.Error())
return
}
// Pretty-print the response data.
fmt.Println(resp)
}

95
vendor/github.com/aws/aws-sdk-go/service/athena/service.go generated vendored Normal file
View File

@ -0,0 +1,95 @@
// Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT.
package athena
import (
"github.com/aws/aws-sdk-go/aws"
"github.com/aws/aws-sdk-go/aws/client"
"github.com/aws/aws-sdk-go/aws/client/metadata"
"github.com/aws/aws-sdk-go/aws/request"
"github.com/aws/aws-sdk-go/aws/signer/v4"
"github.com/aws/aws-sdk-go/private/protocol/jsonrpc"
)
// Athena provides the API operation methods for making requests to
// Amazon Athena. See this package's package overview docs
// for details on the service.
//
// Athena methods are safe to use concurrently. It is not safe to
// modify mutate any of the struct's properties though.
type Athena struct {
*client.Client
}
// Used for custom client initialization logic
var initClient func(*client.Client)
// Used for custom request initialization logic
var initRequest func(*request.Request)
// Service information constants
const (
ServiceName = "athena" // Service endpoint prefix API calls made to.
EndpointsID = ServiceName // Service ID for Regions and Endpoints metadata.
)
// New creates a new instance of the Athena client with a session.
// If additional configuration is needed for the client instance use the optional
// aws.Config parameter to add your extra config.
//
// Example:
// // Create a Athena client from just a session.
// svc := athena.New(mySession)
//
// // Create a Athena client with additional configuration
// svc := athena.New(mySession, aws.NewConfig().WithRegion("us-west-2"))
func New(p client.ConfigProvider, cfgs ...*aws.Config) *Athena {
c := p.ClientConfig(EndpointsID, cfgs...)
return newClient(*c.Config, c.Handlers, c.Endpoint, c.SigningRegion, c.SigningName)
}
// newClient creates, initializes and returns a new service client instance.
func newClient(cfg aws.Config, handlers request.Handlers, endpoint, signingRegion, signingName string) *Athena {
svc := &Athena{
Client: client.New(
cfg,
metadata.ClientInfo{
ServiceName: ServiceName,
SigningName: signingName,
SigningRegion: signingRegion,
Endpoint: endpoint,
APIVersion: "2017-05-18",
JSONVersion: "1.1",
TargetPrefix: "AmazonAthena",
},
handlers,
),
}
// Handlers
svc.Handlers.Sign.PushBackNamed(v4.SignRequestHandler)
svc.Handlers.Build.PushBackNamed(jsonrpc.BuildHandler)
svc.Handlers.Unmarshal.PushBackNamed(jsonrpc.UnmarshalHandler)
svc.Handlers.UnmarshalMeta.PushBackNamed(jsonrpc.UnmarshalMetaHandler)
svc.Handlers.UnmarshalError.PushBackNamed(jsonrpc.UnmarshalErrorHandler)
// Run custom client initialization if present
if initClient != nil {
initClient(svc.Client)
}
return svc
}
// newRequest creates a new request for a Athena operation and runs any
// custom request initialization.
func (c *Athena) newRequest(op *request.Operation, params, data interface{}) *request.Request {
req := c.NewRequest(op, params, data)
// Run custom request initialization if present
if initRequest != nil {
initRequest(req)
}
return req
}

180
vendor/github.com/aws/aws-sdk-go/service/autoscaling/api.go generated vendored
View File

@ -67,7 +67,7 @@ func (c *AutoScaling) AttachInstancesRequest(input *AttachInstancesInput) (req *
// being attached plus the desired capacity of the group exceeds the maximum
// size of the group, the operation fails.
//
// If there is a Classic load balancer attached to your Auto Scaling group,
// If there is a Classic Load Balancer attached to your Auto Scaling group,
// the instances are also registered with the load balancer. If there are target
// groups attached to your Auto Scaling group, the instances are also registered
// with the target groups.
@ -243,10 +243,10 @@ func (c *AutoScaling) AttachLoadBalancersRequest(input *AttachLoadBalancersInput
// AttachLoadBalancers API operation for Auto Scaling.
//
// Attaches one or more Classic load balancers to the specified Auto Scaling
// Attaches one or more Classic Load Balancers to the specified Auto Scaling
// group.
//
// To attach an Application load balancer instead, see AttachLoadBalancerTargetGroups.
// To attach an Application Load Balancer instead, see AttachLoadBalancerTargetGroups.
//
// To describe the load balancers for an Auto Scaling group, use DescribeLoadBalancers.
// To detach the load balancer from the Auto Scaling group, use DetachLoadBalancers.
@ -2258,8 +2258,8 @@ func (c *AutoScaling) DescribeLoadBalancersRequest(input *DescribeLoadBalancersI
//
// Describes the load balancers for the specified Auto Scaling group.
//
// Note that this operation describes only Classic load balancers. If you have
// Application load balancers, use DescribeLoadBalancerTargetGroups instead.
// Note that this operation describes only Classic Load Balancers. If you have
// Application Load Balancers, use DescribeLoadBalancerTargetGroups instead.
//
// Returns awserr.Error for service API and SDK errors. Use runtime type assertions
// with awserr.Error's Code and Message methods to get detailed information about
@ -3299,13 +3299,13 @@ func (c *AutoScaling) DetachInstancesRequest(input *DetachInstancesInput) (req *
//
// Removes one or more instances from the specified Auto Scaling group.
//
// After the instances are detached, you can manage them independently from
// the rest of the Auto Scaling group.
// After the instances are detached, you can manage them independent of the
// Auto Scaling group.
//
// If you do not specify the option to decrement the desired capacity, Auto
// Scaling launches instances to replace the ones that are detached.
//
// If there is a Classic load balancer attached to the Auto Scaling group, the
// If there is a Classic Load Balancer attached to the Auto Scaling group, the
// instances are deregistered from the load balancer. If there are target groups
// attached to the Auto Scaling group, the instances are deregistered from the
// target groups.
@ -3474,11 +3474,11 @@ func (c *AutoScaling) DetachLoadBalancersRequest(input *DetachLoadBalancersInput
// DetachLoadBalancers API operation for Auto Scaling.
//
// Detaches one or more Classic load balancers from the specified Auto Scaling
// Detaches one or more Classic Load Balancers from the specified Auto Scaling
// group.
//
// Note that this operation detaches only Classic load balancers. If you have
// Application load balancers, use DetachLoadBalancerTargetGroups instead.
// Note that this operation detaches only Classic Load Balancers. If you have
// Application Load Balancers, use DetachLoadBalancerTargetGroups instead.
//
// When you detach a load balancer, it enters the Removing state while deregistering
// the instances in the group. When all instances are deregistered, then you
@ -3732,9 +3732,10 @@ func (c *AutoScaling) EnterStandbyRequest(input *EnterStandbyInput) (req *reques
// EnterStandby API operation for Auto Scaling.
//
// Moves the specified instances into Standby mode.
// Moves the specified instances into the standby state.
//
// For more information, see Auto Scaling Lifecycle (http://docs.aws.amazon.com/autoscaling/latest/userguide/AutoScalingGroupLifecycle.html)
// For more information, see Temporarily Removing Instances from Your Auto Scaling
// Group (http://docs.aws.amazon.com/autoscaling/latest/userguide/as-enter-exit-standby.html)
// in the Auto Scaling User Guide.
//
// Returns awserr.Error for service API and SDK errors. Use runtime type assertions
@ -3903,9 +3904,10 @@ func (c *AutoScaling) ExitStandbyRequest(input *ExitStandbyInput) (req *request.
// ExitStandby API operation for Auto Scaling.
//
// Moves the specified instances out of Standby mode.
// Moves the specified instances out of the standby state.
//
// For more information, see Auto Scaling Lifecycle (http://docs.aws.amazon.com/autoscaling/latest/userguide/AutoScalingGroupLifecycle.html)
// For more information, see Temporarily Removing Instances from Your Auto Scaling
// Group (http://docs.aws.amazon.com/autoscaling/latest/userguide/as-enter-exit-standby.html)
// in the Auto Scaling User Guide.
//
// Returns awserr.Error for service API and SDK errors. Use runtime type assertions
@ -5039,15 +5041,14 @@ func (c *AutoScaling) UpdateAutoScalingGroupRequest(input *UpdateAutoScalingGrou
//
// Updates the configuration for the specified Auto Scaling group.
//
// The new settings take effect on any scaling activities after this call returns.
// Scaling activities that are currently in progress aren't affected.
//
// To update an Auto Scaling group with a launch configuration with InstanceMonitoring
// set to False, you must first disable the collection of group metrics. Otherwise,
// set to false, you must first disable the collection of group metrics. Otherwise,
// you will get an error. If you have previously enabled the collection of group
// metrics, you can disable it using DisableMetricsCollection.
//
// The new settings are registered upon the completion of this call. Any launch
// configuration settings take effect on any triggers after this call returns.
// Scaling activities that are currently in progress aren't affected.
//
// Note the following:
//
// * If you specify a new value for MinSize without specifying a value for
@ -5281,7 +5282,6 @@ func (s *Alarm) SetAlarmName(v string) *Alarm {
return s
}
// Contains the parameters for AttachInstances.
// Please also see https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/AttachInstancesQuery
type AttachInstancesInput struct {
_ struct{} `type:"structure"`
@ -5348,7 +5348,6 @@ func (s AttachInstancesOutput) GoString() string {
return s.String()
}
// Contains the parameters for AttachLoadBalancerTargetGroups.
// Please also see https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/AttachLoadBalancerTargetGroupsType
type AttachLoadBalancerTargetGroupsInput struct {
_ struct{} `type:"structure"`
@ -5420,7 +5419,6 @@ func (s AttachLoadBalancerTargetGroupsOutput) GoString() string {
return s.String()
}
// Contains the parameters for AttachLoadBalancers.
// Please also see https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/AttachLoadBalancersType
type AttachLoadBalancersInput struct {
_ struct{} `type:"structure"`
@ -5477,7 +5475,6 @@ func (s *AttachLoadBalancersInput) SetLoadBalancerNames(v []*string) *AttachLoad
return s
}
// Contains the output of AttachLoadBalancers.
// Please also see https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/AttachLoadBalancersResultType
type AttachLoadBalancersOutput struct {
_ struct{} `type:"structure"`
@ -5575,7 +5572,6 @@ func (s *BlockDeviceMapping) SetVirtualName(v string) *BlockDeviceMapping {
return s
}
// Contains the parameters for CompleteLifecycleAction.
// Please also see https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/CompleteLifecycleActionType
type CompleteLifecycleActionInput struct {
_ struct{} `type:"structure"`
@ -5676,7 +5672,6 @@ func (s *CompleteLifecycleActionInput) SetLifecycleHookName(v string) *CompleteL
return s
}
// Contains the output of CompleteLifecycleAction.
// Please also see https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/CompleteLifecycleActionAnswer
type CompleteLifecycleActionOutput struct {
_ struct{} `type:"structure"`
@ -5692,7 +5687,6 @@ func (s CompleteLifecycleActionOutput) GoString() string {
return s.String()
}
// Contains the parameters for CreateAutoScalingGroup.
// Please also see https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/CreateAutoScalingGroupType
type CreateAutoScalingGroupInput struct {
_ struct{} `type:"structure"`
@ -5716,7 +5710,8 @@ type CreateAutoScalingGroupInput struct {
// The number of EC2 instances that should be running in the group. This number
// must be greater than or equal to the minimum size of the group and less than
// or equal to the maximum size of the group.
// or equal to the maximum size of the group. If you do not specify a desired
// capacity, the default is the minimum size of the group.
DesiredCapacity *int64 `type:"integer"`
// The amount of time, in seconds, that Auto Scaling waits before checking the
@ -5754,7 +5749,7 @@ type CreateAutoScalingGroupInput struct {
// instead of a launch configuration.
LaunchConfigurationName *string `min:"1" type:"string"`
// One or more Classic load balancers. To specify an Application load balancer,
// One or more Classic Load Balancers. To specify an Application Load Balancer,
// use TargetGroupARNs instead.
//
// For more information, see Using a Load Balancer With an Auto Scaling Group
@ -5986,7 +5981,6 @@ func (s CreateAutoScalingGroupOutput) GoString() string {
return s.String()
}
// Contains the parameters for CreateLaunchConfiguration.
// Please also see https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/CreateLaunchConfigurationType
type CreateLaunchConfigurationInput struct {
_ struct{} `type:"structure"`
@ -6043,14 +6037,18 @@ type CreateLaunchConfigurationInput struct {
IamInstanceProfile *string `min:"1" type:"string"`
// The ID of the Amazon Machine Image (AMI) to use to launch your EC2 instances.
//
// If you do not specify InstanceId, you must specify ImageId.
//
// For more information, see Finding an AMI (http://docs.aws.amazon.com/AWSEC2/latest/UserGuide/finding-an-ami.html)
// in the Amazon Elastic Compute Cloud User Guide.
ImageId *string `min:"1" type:"string"`
// The ID of the instance to use to create the launch configuration.
// The ID of the instance to use to create the launch configuration. The new
// launch configuration derives attributes from the instance, with the exception
// of the block device mapping.
//
// The new launch configuration derives attributes from the instance, with the
// exception of the block device mapping.
// If you do not specify InstanceId, you must specify both ImageId and InstanceType.
//
// To create a launch configuration with a block device mapping or override
// any other instance attributes, specify them as part of the same request.
@ -6061,11 +6059,15 @@ type CreateLaunchConfigurationInput struct {
InstanceId *string `min:"1" type:"string"`
// Enables detailed monitoring (true) or basic monitoring (false) for the Auto
// Scaling instances.
// Scaling instances. The default is true.
InstanceMonitoring *InstanceMonitoring `type:"structure"`
// The instance type of the EC2 instance. For information about available instance
// types, see Available Instance Types (http://docs.aws.amazon.com/AWSEC2/latest/UserGuide/instance-types.html#AvailableInstanceTypes)
// The instance type of the EC2 instance.
//
// If you do not specify InstanceId, you must specify InstanceType.
//
// For information about available instance types, see Available Instance Types
// (http://docs.aws.amazon.com/AWSEC2/latest/UserGuide/instance-types.html#AvailableInstanceTypes)
// in the Amazon Elastic Compute Cloud User Guide.
InstanceType *string `min:"1" type:"string"`
@ -6316,7 +6318,6 @@ func (s CreateLaunchConfigurationOutput) GoString() string {
return s.String()
}
// Contains the parameters for CreateOrUpdateTags.
// Please also see https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/CreateOrUpdateTagsType
type CreateOrUpdateTagsInput struct {
_ struct{} `type:"structure"`
@ -6381,7 +6382,6 @@ func (s CreateOrUpdateTagsOutput) GoString() string {
return s.String()
}
// Contains the parameters for DeleteAutoScalingGroup.
// Please also see https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/DeleteAutoScalingGroupType
type DeleteAutoScalingGroupInput struct {
_ struct{} `type:"structure"`
@ -6450,7 +6450,6 @@ func (s DeleteAutoScalingGroupOutput) GoString() string {
return s.String()
}
// Contains the parameters for DeleteLaunchConfiguration.
// Please also see https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/LaunchConfigurationNameType
type DeleteLaunchConfigurationInput struct {
_ struct{} `type:"structure"`
@ -6508,7 +6507,6 @@ func (s DeleteLaunchConfigurationOutput) GoString() string {
return s.String()
}
// Contains the parameters for DeleteLifecycleHook.
// Please also see https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/DeleteLifecycleHookType
type DeleteLifecycleHookInput struct {
_ struct{} `type:"structure"`
@ -6568,7 +6566,6 @@ func (s *DeleteLifecycleHookInput) SetLifecycleHookName(v string) *DeleteLifecyc
return s
}
// Contains the output of DeleteLifecycleHook.
// Please also see https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/DeleteLifecycleHookAnswer
type DeleteLifecycleHookOutput struct {
_ struct{} `type:"structure"`
@ -6584,7 +6581,6 @@ func (s DeleteLifecycleHookOutput) GoString() string {
return s.String()
}
// Contains the parameters for DeleteNotificationConfiguration.
// Please also see https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/DeleteNotificationConfigurationType
type DeleteNotificationConfigurationInput struct {
_ struct{} `type:"structure"`
@ -6660,7 +6656,6 @@ func (s DeleteNotificationConfigurationOutput) GoString() string {
return s.String()
}
// Contains the parameters for DeletePolicy.
// Please also see https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/DeletePolicyType
type DeletePolicyInput struct {
_ struct{} `type:"structure"`
@ -6730,7 +6725,6 @@ func (s DeletePolicyOutput) GoString() string {
return s.String()
}
// Contains the parameters for DeleteScheduledAction.
// Please also see https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/DeleteScheduledActionType
type DeleteScheduledActionInput struct {
_ struct{} `type:"structure"`
@ -6805,7 +6799,6 @@ func (s DeleteScheduledActionOutput) GoString() string {
return s.String()
}
// Contains the parameters for DeleteTags.
// Please also see https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/DeleteTagsType
type DeleteTagsInput struct {
_ struct{} `type:"structure"`
@ -6885,7 +6878,6 @@ func (s DescribeAccountLimitsInput) GoString() string {
return s.String()
}
// Contains the parameters for DescribeAccountLimits.
// Please also see https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/DescribeAccountLimitsAnswer
type DescribeAccountLimitsOutput struct {
_ struct{} `type:"structure"`
@ -6954,7 +6946,6 @@ func (s DescribeAdjustmentTypesInput) GoString() string {
return s.String()
}
// Contains the parameters for DescribeAdjustmentTypes.
// Please also see https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/DescribeAdjustmentTypesAnswer
type DescribeAdjustmentTypesOutput struct {
_ struct{} `type:"structure"`
@ -6979,7 +6970,6 @@ func (s *DescribeAdjustmentTypesOutput) SetAdjustmentTypes(v []*AdjustmentType)
return s
}
// Contains the parameters for DescribeAutoScalingGroups.
// Please also see https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/GroupNamesType
type DescribeAutoScalingGroupsInput struct {
_ struct{} `type:"structure"`
@ -6988,7 +6978,8 @@ type DescribeAutoScalingGroupsInput struct {
// described.
AutoScalingGroupNames []*string `type:"list"`
// The maximum number of items to return with this call.
// The maximum number of items to return with this call. The default value is
// 50 and the maximum value is 100.
MaxRecords *int64 `type:"integer"`
// The token for the next set of items to return. (You received this token from
@ -7024,7 +7015,6 @@ func (s *DescribeAutoScalingGroupsInput) SetNextToken(v string) *DescribeAutoSca
return s
}
// Contains the output for DescribeAutoScalingGroups.
// Please also see https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/GroupsType
type DescribeAutoScalingGroupsOutput struct {
_ struct{} `type:"structure"`
@ -7061,7 +7051,6 @@ func (s *DescribeAutoScalingGroupsOutput) SetNextToken(v string) *DescribeAutoSc
return s
}
// Contains the parameters for DescribeAutoScalingInstances.
// Please also see https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/DescribeAutoScalingInstancesType
type DescribeAutoScalingInstancesInput struct {
_ struct{} `type:"structure"`
@ -7071,7 +7060,8 @@ type DescribeAutoScalingInstancesInput struct {
// not exist, it is ignored with no error.
InstanceIds []*string `type:"list"`
// The maximum number of items to return with this call.
// The maximum number of items to return with this call. The default value is
// 50 and the maximum value is 100.
MaxRecords *int64 `type:"integer"`
// The token for the next set of items to return. (You received this token from
@ -7107,7 +7097,6 @@ func (s *DescribeAutoScalingInstancesInput) SetNextToken(v string) *DescribeAuto
return s
}
// Contains the output of DescribeAutoScalingInstances.
// Please also see https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/InstancesType
type DescribeAutoScalingInstancesOutput struct {
_ struct{} `type:"structure"`
@ -7157,7 +7146,6 @@ func (s DescribeAutoScalingNotificationTypesInput) GoString() string {
return s.String()
}
// Contains the output of DescribeAutoScalingNotificationTypes.
// Please also see https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/DescribeAutoScalingNotificationTypesAnswer
type DescribeAutoScalingNotificationTypesOutput struct {
_ struct{} `type:"structure"`
@ -7182,7 +7170,6 @@ func (s *DescribeAutoScalingNotificationTypesOutput) SetAutoScalingNotificationT
return s
}
// Contains the parameters for DescribeLaunchConfigurations.
// Please also see https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/LaunchConfigurationNamesType
type DescribeLaunchConfigurationsInput struct {
_ struct{} `type:"structure"`
@ -7191,7 +7178,8 @@ type DescribeLaunchConfigurationsInput struct {
// are described.
LaunchConfigurationNames []*string `type:"list"`
// The maximum number of items to return with this call. The default is 100.
// The maximum number of items to return with this call. The default value is
// 50 and the maximum value is 100.
MaxRecords *int64 `type:"integer"`
// The token for the next set of items to return. (You received this token from
@ -7227,7 +7215,6 @@ func (s *DescribeLaunchConfigurationsInput) SetNextToken(v string) *DescribeLaun
return s
}
// Contains the output of DescribeLaunchConfigurations.
// Please also see https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/LaunchConfigurationsType
type DescribeLaunchConfigurationsOutput struct {
_ struct{} `type:"structure"`
@ -7279,7 +7266,6 @@ func (s DescribeLifecycleHookTypesInput) GoString() string {
return s.String()
}
// Contains the output of DescribeLifecycleHookTypes.
// Please also see https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/DescribeLifecycleHookTypesAnswer
type DescribeLifecycleHookTypesOutput struct {
_ struct{} `type:"structure"`
@ -7304,7 +7290,6 @@ func (s *DescribeLifecycleHookTypesOutput) SetLifecycleHookTypes(v []*string) *D
return s
}
// Contains the parameters for DescribeLifecycleHooks.
// Please also see https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/DescribeLifecycleHooksType
type DescribeLifecycleHooksInput struct {
_ struct{} `type:"structure"`
@ -7357,7 +7342,6 @@ func (s *DescribeLifecycleHooksInput) SetLifecycleHookNames(v []*string) *Descri
return s
}
// Contains the output of DescribeLifecycleHooks.
// Please also see https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/DescribeLifecycleHooksAnswer
type DescribeLifecycleHooksOutput struct {
_ struct{} `type:"structure"`
@ -7382,7 +7366,6 @@ func (s *DescribeLifecycleHooksOutput) SetLifecycleHooks(v []*LifecycleHook) *De
return s
}
// Contains the parameters for DescribeLoadBalancerTargetGroups.
// Please also see https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/DescribeLoadBalancerTargetGroupsRequest
type DescribeLoadBalancerTargetGroupsInput struct {
_ struct{} `type:"structure"`
@ -7392,7 +7375,8 @@ type DescribeLoadBalancerTargetGroupsInput struct {
// AutoScalingGroupName is a required field
AutoScalingGroupName *string `min:"1" type:"string" required:"true"`
// The maximum number of items to return with this call.
// The maximum number of items to return with this call. The default value is
// 50 and the maximum value is 100.
MaxRecords *int64 `type:"integer"`
// The token for the next set of items to return. (You received this token from
@ -7444,7 +7428,6 @@ func (s *DescribeLoadBalancerTargetGroupsInput) SetNextToken(v string) *Describe
return s
}
// Contains the output of DescribeLoadBalancerTargetGroups.
// Please also see https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/DescribeLoadBalancerTargetGroupsResponse
type DescribeLoadBalancerTargetGroupsOutput struct {
_ struct{} `type:"structure"`
@ -7479,7 +7462,6 @@ func (s *DescribeLoadBalancerTargetGroupsOutput) SetNextToken(v string) *Describ
return s
}
// Contains the parameters for DescribeLoadBalancers.
// Please also see https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/DescribeLoadBalancersRequest
type DescribeLoadBalancersInput struct {
_ struct{} `type:"structure"`
@ -7489,7 +7471,8 @@ type DescribeLoadBalancersInput struct {
// AutoScalingGroupName is a required field
AutoScalingGroupName *string `min:"1" type:"string" required:"true"`
// The maximum number of items to return with this call.
// The maximum number of items to return with this call. The default value is
// 50 and the maximum value is 100.
MaxRecords *int64 `type:"integer"`
// The token for the next set of items to return. (You received this token from
@ -7541,7 +7524,6 @@ func (s *DescribeLoadBalancersInput) SetNextToken(v string) *DescribeLoadBalance
return s
}
// Contains the output of DescribeLoadBalancers.
// Please also see https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/DescribeLoadBalancersResponse
type DescribeLoadBalancersOutput struct {
_ struct{} `type:"structure"`
@ -7591,7 +7573,6 @@ func (s DescribeMetricCollectionTypesInput) GoString() string {
return s.String()
}
// Contains the output of DescribeMetricsCollectionTypes.
// Please also see https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/DescribeMetricCollectionTypesAnswer
type DescribeMetricCollectionTypesOutput struct {
_ struct{} `type:"structure"`
@ -7625,7 +7606,6 @@ func (s *DescribeMetricCollectionTypesOutput) SetMetrics(v []*MetricCollectionTy
return s
}
// Contains the parameters for DescribeNotificationConfigurations.
// Please also see https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/DescribeNotificationConfigurationsType
type DescribeNotificationConfigurationsInput struct {
_ struct{} `type:"structure"`
@ -7633,7 +7613,8 @@ type DescribeNotificationConfigurationsInput struct {
// The name of the group.
AutoScalingGroupNames []*string `type:"list"`
// The maximum number of items to return with this call.
// The maximum number of items to return with this call. The default value is
// 50 and the maximum value is 100.
MaxRecords *int64 `type:"integer"`
// The token for the next set of items to return. (You received this token from
@ -7669,7 +7650,6 @@ func (s *DescribeNotificationConfigurationsInput) SetNextToken(v string) *Descri
return s
}
// Contains the output from DescribeNotificationConfigurations.
// Please also see https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/DescribeNotificationConfigurationsAnswer
type DescribeNotificationConfigurationsOutput struct {
_ struct{} `type:"structure"`
@ -7706,7 +7686,6 @@ func (s *DescribeNotificationConfigurationsOutput) SetNotificationConfigurations
return s
}
// Contains the parameters for DescribePolicies.
// Please also see https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/DescribePoliciesType
type DescribePoliciesInput struct {
_ struct{} `type:"structure"`
@ -7714,7 +7693,8 @@ type DescribePoliciesInput struct {
// The name of the group.
AutoScalingGroupName *string `min:"1" type:"string"`
// The maximum number of items to be returned with each call.
// The maximum number of items to be returned with each call. The default value
// is 50 and the maximum value is 100.
MaxRecords *int64 `type:"integer"`
// The token for the next set of items to return. (You received this token from
@ -7784,7 +7764,6 @@ func (s *DescribePoliciesInput) SetPolicyTypes(v []*string) *DescribePoliciesInp
return s
}
// Contains the output of DescribePolicies.
// Please also see https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/PoliciesType
type DescribePoliciesOutput struct {
_ struct{} `type:"structure"`
@ -7819,7 +7798,6 @@ func (s *DescribePoliciesOutput) SetScalingPolicies(v []*ScalingPolicy) *Describ
return s
}
// Contains the parameters for DescribeScalingActivities.
// Please also see https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/DescribeScalingActivitiesType
type DescribeScalingActivitiesInput struct {
_ struct{} `type:"structure"`
@ -7834,7 +7812,8 @@ type DescribeScalingActivitiesInput struct {
// The name of the group.
AutoScalingGroupName *string `min:"1" type:"string"`
// The maximum number of items to return with this call.
// The maximum number of items to return with this call. The default value is
// 100.
MaxRecords *int64 `type:"integer"`
// The token for the next set of items to return. (You received this token from
@ -7889,7 +7868,6 @@ func (s *DescribeScalingActivitiesInput) SetNextToken(v string) *DescribeScaling
return s
}
// Contains the output of DescribeScalingActivities.
// Please also see https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/ActivitiesType
type DescribeScalingActivitiesOutput struct {
_ struct{} `type:"structure"`
@ -7942,7 +7920,6 @@ func (s DescribeScalingProcessTypesInput) GoString() string {
return s.String()
}
// Contains the output of DescribeScalingProcessTypes.
// Please also see https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/ProcessesType
type DescribeScalingProcessTypesOutput struct {
_ struct{} `type:"structure"`
@ -7967,7 +7944,6 @@ func (s *DescribeScalingProcessTypesOutput) SetProcesses(v []*ProcessType) *Desc
return s
}
// Contains the parameters for DescribeScheduledActions.
// Please also see https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/DescribeScheduledActionsType
type DescribeScheduledActionsInput struct {
_ struct{} `type:"structure"`
@ -7979,7 +7955,8 @@ type DescribeScheduledActionsInput struct {
// provided, this parameter is ignored.
EndTime *time.Time `type:"timestamp" timestampFormat:"iso8601"`
// The maximum number of items to return with this call.
// The maximum number of items to return with this call. The default value is
// 50 and the maximum value is 100.
MaxRecords *int64 `type:"integer"`
// The token for the next set of items to return. (You received this token from
@ -8059,7 +8036,6 @@ func (s *DescribeScheduledActionsInput) SetStartTime(v time.Time) *DescribeSched
return s
}
// Contains the output of DescribeScheduledActions.
// Please also see https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/ScheduledActionsType
type DescribeScheduledActionsOutput struct {
_ struct{} `type:"structure"`
@ -8094,7 +8070,6 @@ func (s *DescribeScheduledActionsOutput) SetScheduledUpdateGroupActions(v []*Sch
return s
}
// Contains the parameters for DescribeTags.
// Please also see https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/DescribeTagsType
type DescribeTagsInput struct {
_ struct{} `type:"structure"`
@ -8102,7 +8077,8 @@ type DescribeTagsInput struct {
// A filter used to scope the tags to return.
Filters []*Filter `type:"list"`
// The maximum number of items to return with this call.
// The maximum number of items to return with this call. The default value is
// 50 and the maximum value is 100.
MaxRecords *int64 `type:"integer"`
// The token for the next set of items to return. (You received this token from
@ -8138,7 +8114,6 @@ func (s *DescribeTagsInput) SetNextToken(v string) *DescribeTagsInput {
return s
}
// Contains the output of DescribeTags.
// Please also see https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/TagsType
type DescribeTagsOutput struct {
_ struct{} `type:"structure"`
@ -8188,7 +8163,6 @@ func (s DescribeTerminationPolicyTypesInput) GoString() string {
return s.String()
}
// Contains the output of DescribeTerminationPolicyTypes.
// Please also see https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/DescribeTerminationPolicyTypesAnswer
type DescribeTerminationPolicyTypesOutput struct {
_ struct{} `type:"structure"`
@ -8214,7 +8188,6 @@ func (s *DescribeTerminationPolicyTypesOutput) SetTerminationPolicyTypes(v []*st
return s
}
// Contains the parameters for DetachInstances.
// Please also see https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/DetachInstancesQuery
type DetachInstancesInput struct {
_ struct{} `type:"structure"`
@ -8281,7 +8254,6 @@ func (s *DetachInstancesInput) SetShouldDecrementDesiredCapacity(v bool) *Detach
return s
}
// Contains the output of DetachInstances.
// Please also see https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/DetachInstancesAnswer
type DetachInstancesOutput struct {
_ struct{} `type:"structure"`
@ -8377,7 +8349,6 @@ func (s DetachLoadBalancerTargetGroupsOutput) GoString() string {
return s.String()
}
// Contains the parameters for DetachLoadBalancers.
// Please also see https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/DetachLoadBalancersType
type DetachLoadBalancersInput struct {
_ struct{} `type:"structure"`
@ -8434,7 +8405,6 @@ func (s *DetachLoadBalancersInput) SetLoadBalancerNames(v []*string) *DetachLoad
return s
}
// Contains the output for DetachLoadBalancers.
// Please also see https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/DetachLoadBalancersResultType
type DetachLoadBalancersOutput struct {
_ struct{} `type:"structure"`
@ -8450,7 +8420,6 @@ func (s DetachLoadBalancersOutput) GoString() string {
return s.String()
}
// Contains the parameters for DisableMetricsCollection.
// Please also see https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/DisableMetricsCollectionQuery
type DisableMetricsCollectionInput struct {
_ struct{} `type:"structure"`
@ -8647,7 +8616,6 @@ func (s *Ebs) SetVolumeType(v string) *Ebs {
return s
}
// Contains the parameters for EnableMetricsCollection.
// Please also see https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/EnableMetricsCollectionQuery
type EnableMetricsCollectionInput struct {
_ struct{} `type:"structure"`
@ -8799,7 +8767,6 @@ func (s *EnabledMetric) SetMetric(v string) *EnabledMetric {
return s
}
// Contains the parameters for EnteStandby.
// Please also see https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/EnterStandbyQuery
type EnterStandbyInput struct {
_ struct{} `type:"structure"`
@ -8869,7 +8836,6 @@ func (s *EnterStandbyInput) SetShouldDecrementDesiredCapacity(v bool) *EnterStan
return s
}
// Contains the output of EnterStandby.
// Please also see https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/EnterStandbyAnswer
type EnterStandbyOutput struct {
_ struct{} `type:"structure"`
@ -8894,7 +8860,6 @@ func (s *EnterStandbyOutput) SetActivities(v []*Activity) *EnterStandbyOutput {
return s
}
// Contains the parameters for ExecutePolicy.
// Please also see https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/ExecutePolicyType
type ExecutePolicyInput struct {
_ struct{} `type:"structure"`
@ -9011,7 +8976,6 @@ func (s ExecutePolicyOutput) GoString() string {
return s.String()
}
// Contains the parameters for ExitStandby.
// Please also see https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/ExitStandbyQuery
type ExitStandbyInput struct {
_ struct{} `type:"structure"`
@ -9063,7 +9027,6 @@ func (s *ExitStandbyInput) SetInstanceIds(v []*string) *ExitStandbyInput {
return s
}
// Contains the parameters for ExitStandby.
// Please also see https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/ExitStandbyAnswer
type ExitStandbyOutput struct {
_ struct{} `type:"structure"`
@ -9474,7 +9437,8 @@ type InstanceDetails struct {
// InstanceId is a required field
InstanceId *string `min:"1" type:"string" required:"true"`
// The launch configuration associated with the instance.
// The launch configuration used to launch the instance. This value is not available
// if you attached the instance to the Auto Scaling group.
//
// LaunchConfigurationName is a required field
LaunchConfigurationName *string `min:"1" type:"string" required:"true"`
@ -9545,12 +9509,12 @@ func (s *InstanceDetails) SetProtectedFromScaleIn(v bool) *InstanceDetails {
return s
}
// Describes whether instance monitoring is enabled.
// Describes whether detailed monitoring is enabled for the Auto Scaling instances.
// Please also see https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/InstanceMonitoring
type InstanceMonitoring struct {
_ struct{} `type:"structure"`
// If True, instance monitoring is enabled.
// If true, detailed monitoring is enabled. Otherwise, basic monitoring is enabled.
Enabled *bool `type:"boolean"`
}
@ -9908,7 +9872,7 @@ func (s *LifecycleHook) SetRoleARN(v string) *LifecycleHook {
return s
}
// Describes the state of a Classic load balancer.
// Describes the state of a Classic Load Balancer.
//
// If you specify a load balancer when creating the Auto Scaling group, the
// state of the load balancer is InService.
@ -10189,7 +10153,6 @@ func (s *ProcessType) SetProcessName(v string) *ProcessType {
return s
}
// Contains the parameters for PutLifecycleHook.
// Please also see https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/PutLifecycleHookType
type PutLifecycleHookInput struct {
_ struct{} `type:"structure"`
@ -10335,7 +10298,6 @@ func (s *PutLifecycleHookInput) SetRoleARN(v string) *PutLifecycleHookInput {
return s
}
// Contains the output of PutLifecycleHook.
// Please also see https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/PutLifecycleHookAnswer
type PutLifecycleHookOutput struct {
_ struct{} `type:"structure"`
@ -10351,7 +10313,6 @@ func (s PutLifecycleHookOutput) GoString() string {
return s.String()
}
// Contains the parameters for PutNotificationConfiguration.
// Please also see https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/PutNotificationConfigurationType
type PutNotificationConfigurationInput struct {
_ struct{} `type:"structure"`
@ -10442,7 +10403,6 @@ func (s PutNotificationConfigurationOutput) GoString() string {
return s.String()
}
// Contains the parameters for PutScalingPolicy.
// Please also see https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/PutScalingPolicyType
type PutScalingPolicyInput struct {
_ struct{} `type:"structure"`
@ -10639,7 +10599,6 @@ func (s *PutScalingPolicyInput) SetStepAdjustments(v []*StepAdjustment) *PutScal
return s
}
// Contains the output of PutScalingPolicy.
// Please also see https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/PolicyARNType
type PutScalingPolicyOutput struct {
_ struct{} `type:"structure"`
@ -10664,7 +10623,6 @@ func (s *PutScalingPolicyOutput) SetPolicyARN(v string) *PutScalingPolicyOutput
return s
}
// Contains the parameters for PutScheduledUpdateGroupAction.
// Please also see https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/PutScheduledUpdateGroupActionType
type PutScheduledUpdateGroupActionInput struct {
_ struct{} `type:"structure"`
@ -10814,7 +10772,6 @@ func (s PutScheduledUpdateGroupActionOutput) GoString() string {
return s.String()
}
// Contains the parameters for RecordLifecycleActionHeartbeat.
// Please also see https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/RecordLifecycleActionHeartbeatType
type RecordLifecycleActionHeartbeatInput struct {
_ struct{} `type:"structure"`
@ -10900,7 +10857,6 @@ func (s *RecordLifecycleActionHeartbeatInput) SetLifecycleHookName(v string) *Re
return s
}
// Contains the output of RecordLifecycleActionHeartBeat.
// Please also see https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/RecordLifecycleActionHeartbeatAnswer
type RecordLifecycleActionHeartbeatOutput struct {
_ struct{} `type:"structure"`
@ -10947,7 +10903,7 @@ type ScalingPolicy struct {
AutoScalingGroupName *string `min:"1" type:"string"`
// The amount of time, in seconds, after a scaling activity completes before
// any further trigger-related scaling activities can start.
// any further dynamic scaling activities can start.
Cooldown *int64 `type:"integer"`
// The estimated time, in seconds, until a newly launched instance can contribute
@ -11074,7 +11030,6 @@ func (s *ScalingPolicy) SetStepAdjustments(v []*StepAdjustment) *ScalingPolicy {
return s
}
// Contains the parameters for SuspendProcesses and ResumeProcesses.
// Please also see https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/ScalingProcessQuery
type ScalingProcessQuery struct {
_ struct{} `type:"structure"`
@ -11254,7 +11209,6 @@ func (s *ScheduledUpdateGroupAction) SetTime(v time.Time) *ScheduledUpdateGroupA
return s
}
// Contains the parameters for SetDesiredCapacity.
// Please also see https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/SetDesiredCapacityType
type SetDesiredCapacityInput struct {
_ struct{} `type:"structure"`
@ -11338,7 +11292,6 @@ func (s SetDesiredCapacityOutput) GoString() string {
return s.String()
}
// Contains the parameters for SetInstanceHealth.
// Please also see https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/SetInstanceHealthQuery
type SetInstanceHealthInput struct {
_ struct{} `type:"structure"`
@ -11430,7 +11383,6 @@ func (s SetInstanceHealthOutput) GoString() string {
return s.String()
}
// Contains the parameters for SetInstanceProtection.
// Please also see https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/SetInstanceProtectionQuery
type SetInstanceProtectionInput struct {
_ struct{} `type:"structure"`
@ -11502,7 +11454,6 @@ func (s *SetInstanceProtectionInput) SetProtectedFromScaleIn(v bool) *SetInstanc
return s
}
// Contains the output of SetInstanceProtection.
// Please also see https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/SetInstanceProtectionAnswer
type SetInstanceProtectionOutput struct {
_ struct{} `type:"structure"`
@ -11808,7 +11759,6 @@ func (s *TagDescription) SetValue(v string) *TagDescription {
return s
}
// Contains the parameters for TerminateInstanceInAutoScalingGroup.
// Please also see https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/TerminateInstanceInAutoScalingGroupType
type TerminateInstanceInAutoScalingGroupInput struct {
_ struct{} `type:"structure"`
@ -11866,7 +11816,6 @@ func (s *TerminateInstanceInAutoScalingGroupInput) SetShouldDecrementDesiredCapa
return s
}
// Contains the output of TerminateInstancesInAutoScalingGroup.
// Please also see https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/ActivityType
type TerminateInstanceInAutoScalingGroupOutput struct {
_ struct{} `type:"structure"`
@ -11891,7 +11840,6 @@ func (s *TerminateInstanceInAutoScalingGroupOutput) SetActivity(v *Activity) *Te
return s
}
// Contains the parameters for UpdateAutoScalingGroup.
// Please also see https://docs.aws.amazon.com/goto/WebAPI/autoscaling-2011-01-01/UpdateAutoScalingGroupType
type UpdateAutoScalingGroupInput struct {
_ struct{} `type:"structure"`

46
vendor/github.com/aws/aws-sdk-go/service/cloudwatchevents/api.go generated vendored
View File

@ -889,10 +889,18 @@ func (c *CloudWatchEvents) PutTargetsRequest(input *PutTargetsInput) (req *reque
// are extracted from the event and used as values in a template that you
// specify as the input to the target.
//
// When you specify Input, InputPath, or InputTransformer, you must use JSON
// dot notation, not bracket notation.
//
// When you add targets to a rule and the associated rule triggers soon after,
// new or updated targets might not be immediately invoked. Please allow a short
// period of time for changes to take effect.
//
// This action can partially fail if too many requests are made at the same
// time. If that happens, FailedEntryCount is non-zero in the response and each
// entry in FailedEntries provides the ID of the failed target and the error
// code.
//
// Returns awserr.Error for service API and SDK errors. Use runtime type assertions
// with awserr.Error's Code and Message methods to get detailed information about
// the error.
@ -987,6 +995,11 @@ func (c *CloudWatchEvents) RemoveTargetsRequest(input *RemoveTargetsInput) (req
// might continue to be invoked. Please allow a short period of time for changes
// to take effect.
//
// This action can partially fail if too many requests are made at the same
// time. If that happens, FailedEntryCount is non-zero in the response and each
// entry in FailedEntries provides the ID of the failed target and the error
// code.
//
// Returns awserr.Error for service API and SDK errors. Use runtime type assertions
// with awserr.Error's Code and Message methods to get detailed information about
// the error.
@ -1223,7 +1236,8 @@ type DescribeRuleOutput struct {
// The description of the rule.
Description *string `type:"string"`
// The event pattern.
// The event pattern. For more information, see Events and Event Patterns (http://docs.aws.amazon.com/AmazonCloudWatch/latest/events/CloudWatchEventsandEventPatterns.html)
// in the Amazon CloudWatch Events User Guide.
EventPattern *string `type:"string"`
// The name of the rule.
@ -1469,7 +1483,8 @@ type InputTransformer struct {
_ struct{} `type:"structure"`
// Map of JSON paths to be extracted from the event. These are key-value pairs,
// where each value is a JSON path.
// where each value is a JSON path. You must use JSON dot notation, not bracket
// notation.
InputPathsMap map[string]*string `type:"map"`
// Input template where you can use the values of the keys from InputPathsMap
@ -2050,7 +2065,8 @@ type PutRuleInput struct {
// A description of the rule.
Description *string `type:"string"`
// The event pattern.
// The event pattern. For more information, see Events and Event Patterns (http://docs.aws.amazon.com/AmazonCloudWatch/latest/events/CloudWatchEventsandEventPatterns.html)
// in the Amazon CloudWatch Events User Guide.
EventPattern *string `type:"string"`
// The name of the rule that you are creating or updating.
@ -2264,7 +2280,9 @@ func (s *PutTargetsOutput) SetFailedEntryCount(v int64) *PutTargetsOutput {
type PutTargetsResultEntry struct {
_ struct{} `type:"structure"`
// The error code that indicates why the target addition failed.
// The error code that indicates why the target addition failed. If the value
// is ConcurrentModificationException, too many requests were made at the same
// time.
ErrorCode *string `type:"string"`
// The error message that explains why the target addition failed.
@ -2399,7 +2417,9 @@ func (s *RemoveTargetsOutput) SetFailedEntryCount(v int64) *RemoveTargetsOutput
type RemoveTargetsResultEntry struct {
_ struct{} `type:"structure"`
// The error code that indicates why the target removal failed.
// The error code that indicates why the target removal failed. If the value
// is ConcurrentModificationException, too many requests were made at the same
// time.
ErrorCode *string `type:"string"`
// The error message that explains why the target removal failed.
@ -2448,7 +2468,9 @@ type Rule struct {
// The description of the rule.
Description *string `type:"string"`
// The event pattern of the rule.
// The event pattern of the rule. For more information, see Events and Event
// Patterns (http://docs.aws.amazon.com/AmazonCloudWatch/latest/events/CloudWatchEventsandEventPatterns.html)
// in the Amazon CloudWatch Events User Guide.
EventPattern *string `type:"string"`
// The name of the rule.
@ -2659,13 +2681,14 @@ type Target struct {
Id *string `min:"1" type:"string" required:"true"`
// Valid JSON text passed to the target. In this case, nothing from the event
// itself is passed to the target. For more information, see The JavaScript
// Object Notation (JSON) Data Interchange Format (http://www.rfc-editor.org/rfc/rfc7159.txt).
// itself is passed to the target. You must use JSON dot notation, not bracket
// notation. For more information, see The JavaScript Object Notation (JSON)
// Data Interchange Format (http://www.rfc-editor.org/rfc/rfc7159.txt).
Input *string `type:"string"`
// The value of the JSONPath that is used for extracting part of the matched
// event when passing it to the target. For more information about JSON paths,
// see JSONPath (http://goessner.net/articles/JsonPath/).
// event when passing it to the target. You must use JSON dot notation, not
// bracket notation. For more information about JSON paths, see JSONPath (http://goessner.net/articles/JsonPath/).
InputPath *string `type:"string"`
// Settings to enable you to provide custom input to a target based on certain
@ -2805,7 +2828,8 @@ type TestEventPatternInput struct {
// Event is a required field
Event *string `type:"string" required:"true"`
// The event pattern.
// The event pattern. For more information, see Events and Event Patterns (http://docs.aws.amazon.com/AmazonCloudWatch/latest/events/CloudWatchEventsandEventPatterns.html)
// in the Amazon CloudWatch Events User Guide.
//
// EventPattern is a required field
EventPattern *string `type:"string" required:"true"`

53
vendor/github.com/aws/aws-sdk-go/service/cloudwatchlogs/api.go generated vendored
View File

@ -2713,7 +2713,10 @@ func (c *CloudWatchLogs) PutSubscriptionFilterRequest(input *PutSubscriptionFilt
// * An AWS Lambda function that belongs to the same account as the subscription
// filter, for same-account delivery.
//
// There can only be one subscription filter associated with a log group.
// There can only be one subscription filter associated with a log group. If
// you are updating an existing filter, you must specify the correct name in
// filterName. Otherwise, the call will fail because you cannot associate a
// second filter with a log group.
//
// Returns awserr.Error for service API and SDK errors. Use runtime type assertions
// with awserr.Error's Code and Message methods to get detailed information about
@ -4101,6 +4104,12 @@ type DescribeLogStreamsInput struct {
//
// If you order the results by event time, you cannot specify the logStreamNamePrefix
// parameter.
//
// lastEventTimestamp represents the time of the most recent log event in the
// log stream in CloudWatch Logs. This number is expressed as the number of
// milliseconds since Jan 1, 1970 00:00:00 UTC. lastEventTimeStamp updates on
// an eventual consistency basis. It typically updates in less than an hour
// from ingestion, but may take longer in some rare situations.
OrderBy *string `locationName:"orderBy" type:"string" enum:"OrderBy"`
}
@ -4462,7 +4471,8 @@ type Destination struct {
// The ARN of this destination.
Arn *string `locationName:"arn" type:"string"`
// The creation time of the destination.
// The creation time of the destination, expressed as the number of milliseconds
// since Jan 1, 1970 00:00:00 UTC.
CreationTime *int64 `locationName:"creationTime" type:"long"`
// The name of the destination.
@ -4626,10 +4636,12 @@ func (s *ExportTask) SetTo(v int64) *ExportTask {
type ExportTaskExecutionInfo struct {
_ struct{} `type:"structure"`
// The completion time of the export task.
// The completion time of the export task, expressed as the number of milliseconds
// since Jan 1, 1970 00:00:00 UTC.
CompletionTime *int64 `locationName:"completionTime" type:"long"`
// The creation time of the export task.
// The creation time of the export task, expressed as the number of milliseconds
// since Jan 1, 1970 00:00:00 UTC.
CreationTime *int64 `locationName:"creationTime" type:"long"`
}
@ -4864,7 +4876,8 @@ type FilteredLogEvent struct {
// The ID of the event.
EventId *string `locationName:"eventId" type:"string"`
// The time the event was ingested.
// The time the event was ingested, expressed as the number of milliseconds
// since Jan 1, 1970 00:00:00 UTC.
IngestionTime *int64 `locationName:"ingestionTime" type:"long"`
// The name of the log stream this event belongs to.
@ -5214,7 +5227,8 @@ type LogGroup struct {
// The Amazon Resource Name (ARN) of the log group.
Arn *string `locationName:"arn" type:"string"`
// The creation time of the log group.
// The creation time of the log group, expressed as the number of milliseconds
// since Jan 1, 1970 00:00:00 UTC.
CreationTime *int64 `locationName:"creationTime" type:"long"`
// The name of the log group.
@ -5287,18 +5301,23 @@ type LogStream struct {
// The Amazon Resource Name (ARN) of the log stream.
Arn *string `locationName:"arn" type:"string"`
// The creation time of the stream.
// The creation time of the stream, expressed as the number of milliseconds
// since Jan 1, 1970 00:00:00 UTC.
CreationTime *int64 `locationName:"creationTime" type:"long"`
// The time of the first event, expressed as the number of milliseconds since
// Jan 1, 1970 00:00:00 UTC.
FirstEventTimestamp *int64 `locationName:"firstEventTimestamp" type:"long"`
// The time of the last event, expressed as the number of milliseconds since
// Jan 1, 1970 00:00:00 UTC.
// the time of the most recent log event in the log stream in CloudWatch Logs.
// This number is expressed as the number of milliseconds since Jan 1, 1970
// 00:00:00 UTC. lastEventTime updates on an eventual consistency basis. It
// typically updates in less than an hour from ingestion, but may take longer
// in some rare situations.
LastEventTimestamp *int64 `locationName:"lastEventTimestamp" type:"long"`
// The ingestion time.
// The ingestion time, expressed as the number of milliseconds since Jan 1,
// 1970 00:00:00 UTC.
LastIngestionTime *int64 `locationName:"lastIngestionTime" type:"long"`
// The name of the log stream.
@ -5376,7 +5395,8 @@ func (s *LogStream) SetUploadSequenceToken(v string) *LogStream {
type MetricFilter struct {
_ struct{} `type:"structure"`
// The creation time of the metric filter.
// The creation time of the metric filter, expressed as the number of milliseconds
// since Jan 1, 1970 00:00:00 UTC.
CreationTime *int64 `locationName:"creationTime" type:"long"`
// The name of the metric filter.
@ -5563,7 +5583,8 @@ func (s *MetricTransformation) SetMetricValue(v string) *MetricTransformation {
type OutputLogEvent struct {
_ struct{} `type:"structure"`
// The time the event was ingested.
// The time the event was ingested, expressed as the number of milliseconds
// since Jan 1, 1970 00:00:00 UTC.
IngestionTime *int64 `locationName:"ingestionTime" type:"long"`
// The data contained in the log event.
@ -6124,7 +6145,10 @@ type PutSubscriptionFilterInput struct {
// For a more even distribution, you can group log data randomly.
Distribution *string `locationName:"distribution" type:"string" enum:"Distribution"`
// A name for the subscription filter.
// A name for the subscription filter. If you are updating an existing filter,
// you must specify the correct name in filterName. Otherwise, the call will
// fail because you cannot associate a second filter with a log group. To find
// the name of the filter currently associated with a log group, use DescribeSubscriptionFilters.
//
// FilterName is a required field
FilterName *string `locationName:"filterName" min:"1" type:"string" required:"true"`
@ -6323,7 +6347,8 @@ func (s *SearchedLogStream) SetSearchedCompletely(v bool) *SearchedLogStream {
type SubscriptionFilter struct {
_ struct{} `type:"structure"`
// The creation time of the subscription filter.
// The creation time of the subscription filter, expressed as the number of
// milliseconds since Jan 1, 1970 00:00:00 UTC.
CreationTime *int64 `locationName:"creationTime" type:"long"`
// The Amazon Resource Name (ARN) of the destination.

139
vendor/github.com/aws/aws-sdk-go/service/codedeploy/api.go generated vendored
View File

@ -704,11 +704,12 @@ func (c *CodeDeploy) ContinueDeploymentRequest(input *ContinueDeploymentInput) (
// ContinueDeployment API operation for AWS CodeDeploy.
//
// Starts the process of rerouting traffic from instances in the original environment
// to instances in thereplacement environment without waiting for a specified
// wait time to elapse. (Traffic rerouting, which is achieved by registering
// instances in the replacement environment with the load balancer, can start
// as soon as all instances have a status of Ready.)
// For a blue/green deployment, starts the process of rerouting traffic from
// instances in the original environment to instances in the replacement environment
// without waiting for a specified wait time to elapse. (Traffic rerouting,
// which is achieved by registering instances in the replacement environment
// with the load balancer, can start as soon as all instances have a status
// of Ready.)
//
// Returns awserr.Error for service API and SDK errors. Use runtime type assertions
// with awserr.Error's Code and Message methods to get detailed information about
@ -964,6 +965,12 @@ func (c *CodeDeploy) CreateDeploymentRequest(input *CreateDeploymentInput) (req
// * ErrCodeInvalidLoadBalancerInfoException "InvalidLoadBalancerInfoException"
// An invalid load balancer name, or no load balancer name, was specified.
//
// * ErrCodeInvalidFileExistsBehaviorException "InvalidFileExistsBehaviorException"
// An invalid fileExistsBehavior option was specified to determine how AWS CodeDeploy
// handles files or directories that already exist in a deployment target location
// but weren't part of the previous successful deployment. Valid values include
// "DISALLOW", "OVERWRITE", and "RETAIN".
//
// Please also see https://docs.aws.amazon.com/goto/WebAPI/codedeploy-2014-10-06/CreateDeployment
func (c *CodeDeploy) CreateDeployment(input *CreateDeploymentInput) (*CreateDeploymentOutput, error) {
req, out := c.CreateDeploymentRequest(input)
@ -1215,8 +1222,8 @@ func (c *CodeDeploy) CreateDeploymentGroupRequest(input *CreateDeploymentGroupIn
//
// * ErrCodeInvalidDeploymentStyleException "InvalidDeploymentStyleException"
// An invalid deployment style was specified. Valid deployment types include
// "IN_PLACE" and "BLUE_GREEN". Valid deployment options for blue/green deployments
// include "WITH_TRAFFIC_CONTROL" and "WITHOUT_TRAFFIC_CONTROL".
// "IN_PLACE" and "BLUE_GREEN". Valid deployment options include "WITH_TRAFFIC_CONTROL"
// and "WITHOUT_TRAFFIC_CONTROL".
//
// * ErrCodeInvalidBlueGreenDeploymentConfigurationException "InvalidBlueGreenDeploymentConfigurationException"
// The configuration for the blue/green deployment group was provided in an
@ -2901,6 +2908,10 @@ func (c *CodeDeploy) ListDeploymentInstancesRequest(input *ListDeploymentInstanc
// Valid values include "Blue" for an original environment and "Green" for a
// replacement environment.
//
// * ErrCodeInvalidDeploymentInstanceTypeException "InvalidDeploymentInstanceTypeException"
// An instance type was specified for an in-place deployment. Instance types
// are supported for blue/green deployments only.
//
// Please also see https://docs.aws.amazon.com/goto/WebAPI/codedeploy-2014-10-06/ListDeploymentInstances
func (c *CodeDeploy) ListDeploymentInstances(input *ListDeploymentInstancesInput) (*ListDeploymentInstancesOutput, error) {
req, out := c.ListDeploymentInstancesRequest(input)
@ -3948,8 +3959,8 @@ func (c *CodeDeploy) UpdateDeploymentGroupRequest(input *UpdateDeploymentGroupIn
//
// * ErrCodeInvalidDeploymentStyleException "InvalidDeploymentStyleException"
// An invalid deployment style was specified. Valid deployment types include
// "IN_PLACE" and "BLUE_GREEN". Valid deployment options for blue/green deployments
// include "WITH_TRAFFIC_CONTROL" and "WITHOUT_TRAFFIC_CONTROL".
// "IN_PLACE" and "BLUE_GREEN". Valid deployment options include "WITH_TRAFFIC_CONTROL"
// and "WITHOUT_TRAFFIC_CONTROL".
//
// * ErrCodeInvalidBlueGreenDeploymentConfigurationException "InvalidBlueGreenDeploymentConfigurationException"
// The configuration for the blue/green deployment group was provided in an
@ -5008,7 +5019,7 @@ type CreateDeploymentGroupInput struct {
// group.
//
// For more information about the predefined deployment configurations in AWS
// CodeDeploy, see see Working with Deployment Groups in AWS CodeDeploy (http://docs.aws.amazon.com/codedeploy/latest/userguide/deployment-configurations.html)
// CodeDeploy, see Working with Deployment Groups in AWS CodeDeploy (http://docs.aws.amazon.com/codedeploy/latest/userguide/deployment-configurations.html)
// in the AWS CodeDeploy User Guide.
DeploymentConfigName *string `locationName:"deploymentConfigName" min:"1" type:"string"`
@ -5017,17 +5028,19 @@ type CreateDeploymentGroupInput struct {
// DeploymentGroupName is a required field
DeploymentGroupName *string `locationName:"deploymentGroupName" min:"1" type:"string" required:"true"`
// Information about the type of deployment, standard or blue/green, that you
// Information about the type of deployment, in-place or blue/green, that you
// want to run and whether to route deployment traffic behind a load balancer.
DeploymentStyle *DeploymentStyle `locationName:"deploymentStyle" type:"structure"`
// The Amazon EC2 tags on which to filter.
// The Amazon EC2 tags on which to filter. The deployment group will include
// EC2 instances with any of the specified tags.
Ec2TagFilters []*EC2TagFilter `locationName:"ec2TagFilters" type:"list"`
// Information about the load balancer used in a blue/green deployment.
// Information about the load balancer used in a deployment.
LoadBalancerInfo *LoadBalancerInfo `locationName:"loadBalancerInfo" type:"structure"`
// The on-premises instance tags on which to filter.
// The on-premises instance tags on which to filter. The deployment group will
// include on-premises instances with any of the specified tags.
OnPremisesInstanceTagFilters []*TagFilter `locationName:"onPremisesInstanceTagFilters" type:"list"`
// A service role ARN that allows AWS CodeDeploy to act on the user's behalf
@ -5212,6 +5225,22 @@ type CreateDeploymentInput struct {
// A comment about the deployment.
Description *string `locationName:"description" type:"string"`
// Information about how AWS CodeDeploy handles files that already exist in
// a deployment target location but weren't part of the previous successful
// deployment.
//
// The fileExistsBehavior parameter takes any of the following values:
//
// * DISALLOW: The deployment fails. This is also the default behavior if
// no option is specified.
//
// * OVERWRITE: The version of the file from the application revision currently
// being deployed replaces the version already on the instance.
//
// * RETAIN: The version of the file already on the instance is kept and
// used as part of the new deployment.
FileExistsBehavior *string `locationName:"fileExistsBehavior" type:"string" enum:"FileExistsBehavior"`
// If set to true, then if the deployment causes the ApplicationStop deployment
// lifecycle event to an instance to fail, the deployment to that instance will
// not be considered to have failed at that point and will continue on to the
@ -5297,6 +5326,12 @@ func (s *CreateDeploymentInput) SetDescription(v string) *CreateDeploymentInput
return s
}
// SetFileExistsBehavior sets the FileExistsBehavior field's value.
func (s *CreateDeploymentInput) SetFileExistsBehavior(v string) *CreateDeploymentInput {
s.FileExistsBehavior = &v
return s
}
// SetIgnoreApplicationStopFailures sets the IgnoreApplicationStopFailures field's value.
func (s *CreateDeploymentInput) SetIgnoreApplicationStopFailures(v bool) *CreateDeploymentInput {
s.IgnoreApplicationStopFailures = &v
@ -5637,14 +5672,14 @@ type DeploymentGroupInfo struct {
// The deployment group name.
DeploymentGroupName *string `locationName:"deploymentGroupName" min:"1" type:"string"`
// Information about the type of deployment, either standard or blue/green,
// Information about the type of deployment, either in-place or blue/green,
// you want to run and whether to route deployment traffic behind a load balancer.
DeploymentStyle *DeploymentStyle `locationName:"deploymentStyle" type:"structure"`
// The Amazon EC2 tags on which to filter.
Ec2TagFilters []*EC2TagFilter `locationName:"ec2TagFilters" type:"list"`
// Information about the load balancer to use in a blue/green deployment.
// Information about the load balancer to use in a deployment.
LoadBalancerInfo *LoadBalancerInfo `locationName:"loadBalancerInfo" type:"structure"`
// The on-premises instance tags on which to filter.
@ -5807,7 +5842,7 @@ type DeploymentInfo struct {
// A summary of the deployment status of the instances in the deployment.
DeploymentOverview *DeploymentOverview `locationName:"deploymentOverview" type:"structure"`
// Information about the type of deployment, either standard or blue/green,
// Information about the type of deployment, either in-place or blue/green,
// you want to run and whether to route deployment traffic behind a load balancer.
DeploymentStyle *DeploymentStyle `locationName:"deploymentStyle" type:"structure"`
@ -5817,6 +5852,20 @@ type DeploymentInfo struct {
// Information about any error associated with this deployment.
ErrorInformation *ErrorInformation `locationName:"errorInformation" type:"structure"`
// Information about how AWS CodeDeploy handles files that already exist in
// a deployment target location but weren't part of the previous successful
// deployment.
//
// * DISALLOW: The deployment fails. This is also the default behavior if
// no option is specified.
//
// * OVERWRITE: The version of the file from the application revision currently
// being deployed replaces the version already on the instance.
//
// * RETAIN: The version of the file already on the instance is kept and
// used as part of the new deployment.
FileExistsBehavior *string `locationName:"fileExistsBehavior" type:"string" enum:"FileExistsBehavior"`
// If true, then if the deployment causes the ApplicationStop deployment lifecycle
// event to an instance to fail, the deployment to that instance will not be
// considered to have failed at that point and will continue on to the BeforeInstall
@ -5834,9 +5883,13 @@ type DeploymentInfo struct {
// starts.
InstanceTerminationWaitTimeStarted *bool `locationName:"instanceTerminationWaitTimeStarted" type:"boolean"`
// Information about the load balancer used in this blue/green deployment.
// Information about the load balancer used in the deployment.
LoadBalancerInfo *LoadBalancerInfo `locationName:"loadBalancerInfo" type:"structure"`
// Information about the application revision that was deployed to the deployment
// group before the most recent successful deployment.
PreviousRevision *RevisionLocation `locationName:"previousRevision" type:"structure"`
// Information about the location of stored application artifacts and the service
// from which to retrieve them.
Revision *RevisionLocation `locationName:"revision" type:"structure"`
@ -5958,6 +6011,12 @@ func (s *DeploymentInfo) SetErrorInformation(v *ErrorInformation) *DeploymentInf
return s
}
// SetFileExistsBehavior sets the FileExistsBehavior field's value.
func (s *DeploymentInfo) SetFileExistsBehavior(v string) *DeploymentInfo {
s.FileExistsBehavior = &v
return s
}
// SetIgnoreApplicationStopFailures sets the IgnoreApplicationStopFailures field's value.
func (s *DeploymentInfo) SetIgnoreApplicationStopFailures(v bool) *DeploymentInfo {
s.IgnoreApplicationStopFailures = &v
@ -5976,6 +6035,12 @@ func (s *DeploymentInfo) SetLoadBalancerInfo(v *LoadBalancerInfo) *DeploymentInf
return s
}
// SetPreviousRevision sets the PreviousRevision field's value.
func (s *DeploymentInfo) SetPreviousRevision(v *RevisionLocation) *DeploymentInfo {
s.PreviousRevision = v
return s
}
// SetRevision sets the Revision field's value.
func (s *DeploymentInfo) SetRevision(v *RevisionLocation) *DeploymentInfo {
s.Revision = v
@ -6131,7 +6196,7 @@ func (s *DeploymentReadyOption) SetWaitTimeInMinutes(v int64) *DeploymentReadyOp
return s
}
// Information about the type of deployment, either standard or blue/green,
// Information about the type of deployment, either in-place or blue/green,
// you want to run and whether to route deployment traffic behind a load balancer.
// Please also see https://docs.aws.amazon.com/goto/WebAPI/codedeploy-2014-10-06/DeploymentStyle
type DeploymentStyle struct {
@ -6140,7 +6205,7 @@ type DeploymentStyle struct {
// Indicates whether to route deployment traffic behind a load balancer.
DeploymentOption *string `locationName:"deploymentOption" type:"string" enum:"DeploymentOption"`
// Indicates whether to run a standard deployment or a blue/green deployment.
// Indicates whether to run an in-place deployment or a blue/green deployment.
DeploymentType *string `locationName:"deploymentType" type:"string" enum:"DeploymentType"`
}
@ -6290,7 +6355,7 @@ func (s *Diagnostics) SetScriptName(v string) *Diagnostics {
return s
}
// Information about a tag filter.
// Information about an EC2 tag filter.
// Please also see https://docs.aws.amazon.com/goto/WebAPI/codedeploy-2014-10-06/EC2TagFilter
type EC2TagFilter struct {
_ struct{} `type:"structure"`
@ -6339,14 +6404,16 @@ func (s *EC2TagFilter) SetValue(v string) *EC2TagFilter {
return s
}
// Information about a load balancer in Elastic Load Balancing to use in a blue/green
// deployment.
// Information about a load balancer in Elastic Load Balancing to use in a deployment.
// Please also see https://docs.aws.amazon.com/goto/WebAPI/codedeploy-2014-10-06/ELBInfo
type ELBInfo struct {
_ struct{} `type:"structure"`
// The name of the load balancer that will be used to route traffic from original
// instances to replacement instances in a blue/green deployment.
// For blue/green deployments, the name of the load balancer that will be used
// to route traffic from original instances to replacement instances in a blue/green
// deployment. For in-place deployments, the name of the load balancer that
// instances are deregistered from so they are not serving traffic during a
// deployment, and then re-registered with after the deployment completes.
Name *string `locationName:"name" type:"string"`
}
@ -8065,13 +8132,13 @@ func (s *ListOnPremisesInstancesOutput) SetNextToken(v string) *ListOnPremisesIn
return s
}
// Information about the load balancer used in a blue/green deployment.
// Information about the load balancer used in a deployment.
// Please also see https://docs.aws.amazon.com/goto/WebAPI/codedeploy-2014-10-06/LoadBalancerInfo
type LoadBalancerInfo struct {
_ struct{} `type:"structure"`
// An array containing information about the load balancer in Elastic Load Balancing
// to use in a blue/green deployment.
// to use in a deployment.
ElbInfoList []*ELBInfo `locationName:"elbInfoList" type:"list"`
}
@ -8119,6 +8186,9 @@ type MinimumHealthyHosts struct {
// Although this allows one instance at a time to be taken offline for a new
// deployment, it also means that if the deployment to the last instance fails,
// the overall deployment still succeeds.
//
// For more information, see AWS CodeDeploy Instance Health (http://docs.aws.amazon.com/codedeploy/latest/userguide/instances-health.html)
// in the AWS CodeDeploy User Guide.
Type *string `locationName:"type" type:"string" enum:"MinimumHealthyHostsType"`
// The minimum healthy instance value.
@ -9009,7 +9079,7 @@ type UpdateDeploymentGroupInput struct {
// it.
DeploymentConfigName *string `locationName:"deploymentConfigName" min:"1" type:"string"`
// Information about the type of deployment, either standard or blue/green,
// Information about the type of deployment, either in-place or blue/green,
// you want to run and whether to route deployment traffic behind a load balancer.
DeploymentStyle *DeploymentStyle `locationName:"deploymentStyle" type:"structure"`
@ -9018,7 +9088,7 @@ type UpdateDeploymentGroupInput struct {
// do not enter any tag names.
Ec2TagFilters []*EC2TagFilter `locationName:"ec2TagFilters" type:"list"`
// Information about the load balancer used in a blue/green deployment.
// Information about the load balancer used in a deployment.
LoadBalancerInfo *LoadBalancerInfo `locationName:"loadBalancerInfo" type:"structure"`
// The new name of the deployment group, if you want to change it.
@ -9347,6 +9417,17 @@ const (
ErrorCodeManualStop = "MANUAL_STOP"
)
const (
// FileExistsBehaviorDisallow is a FileExistsBehavior enum value
FileExistsBehaviorDisallow = "DISALLOW"
// FileExistsBehaviorOverwrite is a FileExistsBehavior enum value
FileExistsBehaviorOverwrite = "OVERWRITE"
// FileExistsBehaviorRetain is a FileExistsBehavior enum value
FileExistsBehaviorRetain = "RETAIN"
)
const (
// GreenFleetProvisioningActionDiscoverExisting is a GreenFleetProvisioningAction enum value
GreenFleetProvisioningActionDiscoverExisting = "DISCOVER_EXISTING"

77
vendor/github.com/aws/aws-sdk-go/service/codedeploy/doc.go generated vendored
View File

@ -3,59 +3,60 @@
// Package codedeploy provides the client and types for making API
// requests to AWS CodeDeploy.
//
// Overview
// AWS CodeDeploy is a deployment service that automates application deployments
// to Amazon EC2 instances or on-premises instances running in your own facility.
//
// This reference guide provides descriptions of the AWS CodeDeploy APIs. For
// more information about AWS CodeDeploy, see the AWS CodeDeploy User Guide
// (http://docs.aws.amazon.com/codedeploy/latest/userguide).
// You can deploy a nearly unlimited variety of application content, such as
// code, web and configuration files, executables, packages, scripts, multimedia
// files, and so on. AWS CodeDeploy can deploy application content stored in
// Amazon S3 buckets, GitHub repositories, or Bitbucket repositories. You do
// not need to make changes to your existing code before you can use AWS CodeDeploy.
//
// Using the APIs
// AWS CodeDeploy makes it easier for you to rapidly release new features, helps
// you avoid downtime during application deployment, and handles the complexity
// of updating your applications, without many of the risks associated with
// error-prone manual deployments.
//
// You can use the AWS CodeDeploy APIs to work with the following:
// AWS CodeDeploy Components
//
// * Applications are unique identifiers used by AWS CodeDeploy to ensure
// the correct combinations of revisions, deployment configurations, and
// deployment groups are being referenced during deployments.
// Use the information in this guide to help you work with the following AWS
// CodeDeploy components:
//
// You can use the AWS CodeDeploy APIs to create, delete, get, list, and update
// applications.
// * Application: A name that uniquely identifies the application you want
// to deploy. AWS CodeDeploy uses this name, which functions as a container,
// to ensure the correct combination of revision, deployment configuration,
// and deployment group are referenced during a deployment.
//
// * Deployment configurations are sets of deployment rules and success and
// failure conditions used by AWS CodeDeploy during deployments.
// * Deployment group: A set of individual instances. A deployment group
// contains individually tagged instances, Amazon EC2 instances in Auto Scaling
// groups, or both.
//
// You can use the AWS CodeDeploy APIs to create, delete, get, and list deployment
// configurations.
// * Deployment configuration: A set of deployment rules and deployment success
// and failure conditions used by AWS CodeDeploy during a deployment.
//
// * Deployment groups are groups of instances to which application revisions
// can be deployed.
// * Deployment: The process, and the components involved in the process,
// of installing content on one or more instances.
//
// You can use the AWS CodeDeploy APIs to create, delete, get, list, and update
// deployment groups.
// * Application revisions: An archive file containing source content—source
// code, web pages, executable files, and deployment scripts—along with an
// application specification file (AppSpec file). Revisions are stored in
// Amazon S3 buckets or GitHub repositories. For Amazon S3, a revision is
// uniquely identified by its Amazon S3 object key and its ETag, version,
// or both. For GitHub, a revision is uniquely identified by its commit ID.
//
// * Instances represent Amazon EC2 instances to which application revisions
// are deployed. Instances are identified by their Amazon EC2 tags or Auto
// Scaling group names. Instances belong to deployment groups.
// This guide also contains information to help you get details about the instances
// in your deployments and to make on-premises instances available for AWS CodeDeploy
// deployments.
//
// You can use the AWS CodeDeploy APIs to get and list instance.
// AWS CodeDeploy Information Resources
//
// * Deployments represent the process of deploying revisions to instances.
// * AWS CodeDeploy User Guide (http://docs.aws.amazon.com/codedeploy/latest/userguide)
//
// You can use the AWS CodeDeploy APIs to create, get, list, and stop deployments.
// * AWS CodeDeploy API Reference Guide (http://docs.aws.amazon.com/codedeploy/latest/APIReference/)
//
// * Application revisions are archive files stored in Amazon S3 buckets
// or GitHub repositories. These revisions contain source content (such as
// source code, web pages, executable files, and deployment scripts) along
// with an application specification (AppSpec) file. (The AppSpec file is
// unique to AWS CodeDeploy; it defines the deployment actions you want AWS
// CodeDeploy to execute.) For application revisions stored in Amazon S3
// buckets, an application revision is uniquely identified by its Amazon
// S3 object key and its ETag, version, or both. For application revisions
// stored in GitHub repositories, an application revision is uniquely identified
// by its repository name and commit ID. Application revisions are deployed
// through deployment groups.
// * AWS CLI Reference for AWS CodeDeploy (http://docs.aws.amazon.com/cli/latest/reference/deploy/index.html)
//
// You can use the AWS CodeDeploy APIs to get, list, and register application
// revisions.
// * AWS CodeDeploy Developer Forum (https://forums.aws.amazon.com/forum.jspa?forumID=179)
//
// See https://docs.aws.amazon.com/goto/WebAPI/codedeploy-2014-10-06 for more information on this service.
//

20
vendor/github.com/aws/aws-sdk-go/service/codedeploy/errors.go generated vendored
View File

@ -284,6 +284,13 @@ const (
// At least one of the deployment IDs was specified in an invalid format.
ErrCodeInvalidDeploymentIdException = "InvalidDeploymentIdException"
// ErrCodeInvalidDeploymentInstanceTypeException for service response error code
// "InvalidDeploymentInstanceTypeException".
//
// An instance type was specified for an in-place deployment. Instance types
// are supported for blue/green deployments only.
ErrCodeInvalidDeploymentInstanceTypeException = "InvalidDeploymentInstanceTypeException"
// ErrCodeInvalidDeploymentStatusException for service response error code
// "InvalidDeploymentStatusException".
//
@ -294,8 +301,8 @@ const (
// "InvalidDeploymentStyleException".
//
// An invalid deployment style was specified. Valid deployment types include
// "IN_PLACE" and "BLUE_GREEN". Valid deployment options for blue/green deployments
// include "WITH_TRAFFIC_CONTROL" and "WITHOUT_TRAFFIC_CONTROL".
// "IN_PLACE" and "BLUE_GREEN". Valid deployment options include "WITH_TRAFFIC_CONTROL"
// and "WITHOUT_TRAFFIC_CONTROL".
ErrCodeInvalidDeploymentStyleException = "InvalidDeploymentStyleException"
// ErrCodeInvalidEC2TagException for service response error code
@ -304,6 +311,15 @@ const (
// The tag was specified in an invalid format.
ErrCodeInvalidEC2TagException = "InvalidEC2TagException"
// ErrCodeInvalidFileExistsBehaviorException for service response error code
// "InvalidFileExistsBehaviorException".
//
// An invalid fileExistsBehavior option was specified to determine how AWS CodeDeploy
// handles files or directories that already exist in a deployment target location
// but weren't part of the previous successful deployment. Valid values include
// "DISALLOW", "OVERWRITE", and "RETAIN".
ErrCodeInvalidFileExistsBehaviorException = "InvalidFileExistsBehaviorException"
// ErrCodeInvalidIamSessionArnException for service response error code
// "InvalidIamSessionArnException".
//

1
vendor/github.com/aws/aws-sdk-go/service/codedeploy/examples_test.go generated vendored
View File

@ -265,6 +265,7 @@ func ExampleCodeDeploy_CreateDeployment() {
DeploymentConfigName: aws.String("DeploymentConfigName"),
DeploymentGroupName: aws.String("DeploymentGroupName"),
Description: aws.String("Description"),
FileExistsBehavior: aws.String("FileExistsBehavior"),
IgnoreApplicationStopFailures: aws.Bool(true),
Revision: &codedeploy.RevisionLocation{
GitHubLocation: &codedeploy.GitHubLocation{

2
vendor/github.com/aws/aws-sdk-go/service/dynamodb/dynamodbattribute/encode.go generated vendored
View File

@ -14,7 +14,7 @@ import (
// and unmarshaled with DynamoDB AttributeValues it will be done so as number
// instead of string in seconds since January 1, 1970 UTC.
//
// This type is useful as an alterntitive to the struct tag `unixtime` when you
// This type is useful as an alternative to the struct tag `unixtime` when you
// want to have your time value marshaled as Unix time in seconds intead of
// the default time.RFC3339.
//

154
vendor/github.com/aws/aws-sdk-go/service/gamelift/api.go generated vendored
View File

@ -293,13 +293,17 @@ func (c *GameLift) CreateFleetRequest(input *CreateFleetInput) (req *request.Req
// A newly created fleet passes through several statuses; once it reaches the
// ACTIVE status, it can begin hosting game sessions.
//
// To create a new fleet, provide a fleet name, an EC2 instance type, and a
// build ID of the game build to deploy. You can also configure the new fleet
// with the following settings: (1) a runtime configuration describing what
// server processes to run on each instance in the fleet (required to create
// fleet), (2) access permissions for inbound traffic, (3) fleet-wide game session
// protection, and (4) the location of default log files for Amazon GameLift
// to upload and store.
// To create a new fleet, you must specify the following: (1) fleet name, (2)
// build ID of an uploaded game build, (3) an EC2 instance type, and (4) a runtime
// configuration that describes which server processes to run on each instance
// in the fleet. (Although the runtime configuration is not a required parameter,
// the fleet cannot be successfully created without it.) You can also configure
// the new fleet with the following settings: fleet description, access permissions
// for inbound traffic, fleet-wide game session protection, and resource creation
// limit. If you use Amazon CloudWatch for metrics, you can add the new fleet
// to a metric group, which allows you to view aggregated metrics for a set
// of fleets. Once you specify a metric group, the new fleet's metrics are included
// in the metric group's data.
//
// If the CreateFleet call is successful, Amazon GameLift performs the following
// tasks:
@ -636,6 +640,10 @@ func (c *GameLift) CreateGameSessionQueueRequest(input *CreateGameSessionQueueIn
// * ErrCodeUnauthorizedException "UnauthorizedException"
// The client failed authentication. Clients should not retry such requests.
//
// * ErrCodeLimitExceededException "LimitExceededException"
// The requested operation would cause the resource to exceed the allowed service
// limit. Resolve the issue before retrying.
//
// Please also see https://docs.aws.amazon.com/goto/WebAPI/gamelift-2015-10-01/CreateGameSessionQueue
func (c *GameLift) CreateGameSessionQueue(input *CreateGameSessionQueueInput) (*CreateGameSessionQueueOutput, error) {
req, out := c.CreateGameSessionQueueRequest(input)
@ -3984,33 +3992,44 @@ func (c *GameLift) StartGameSessionPlacementRequest(input *StartGameSessionPlace
// Places a request for a new game session in a queue (see CreateGameSessionQueue).
// When processing a placement request, Amazon GameLift searches for available
// resources on the queue's destinations, scanning each until it finds resources
// or the placement request times out. A game session placement request can
// also request player sessions. When a new game session is successfully created,
// Amazon GameLift creates a player session for each player included in the
// request.
// or the placement request times out.
//
// A game session placement request can also request player sessions. When a
// new game session is successfully created, Amazon GameLift creates a player
// session for each player included in the request.
//
// When placing a game session, by default Amazon GameLift tries each fleet
// in the order they are listed in the queue configuration. Ideally, a queue's
// destinations are listed in preference order. Alternatively, when requesting
// a game session with players, you can also provide latency data for each player
// in relevant regions. Latency data indicates the performance lag a player
// experiences when connected to a fleet in the region. Amazon GameLift uses
// latency data to reorder the list of destinations to place the game session
// in a region with minimal lag. If latency data is provided for multiple players,
// Amazon GameLift calculates each region's average lag for all players and
// reorders to get the best game play across all players.
// destinations are listed in preference order.
//
// To place a new game session request, specify the queue name and a set of
// game session properties and settings. Also provide a unique ID (such as a
// UUID) for the placement. You'll use this ID to track the status of the placement
// request. Optionally, provide a set of IDs and player data for each player
// you want to join to the new game session. To optimize game play for the players,
// also provide latency data for all players. If successful, a new game session
// placement is created. To track the status of a placement request, call DescribeGameSessionPlacement
// Alternatively, when requesting a game session with players, you can also
// provide latency data for each player in relevant regions. Latency data indicates
// the performance lag a player experiences when connected to a fleet in the
// region. Amazon GameLift uses latency data to reorder the list of destinations
// to place the game session in a region with minimal lag. If latency data is
// provided for multiple players, Amazon GameLift calculates each region's average
// lag for all players and reorders to get the best game play across all players.
//
// To place a new game session request, specify the following:
//
// * The queue name and a set of game session properties and settings
//
// * A unique ID (such as a UUID) for the placement. You use this ID to track
// the status of the placement request
//
// * (Optional) A set of IDs and player data for each player you want to
// join to the new game session
//
// * Latency data for all players (if you want to optimize game play for
// the players)
//
// If successful, a new game session placement is created.
//
// To track the status of a placement request, call DescribeGameSessionPlacement
// and check the request's status. If the status is Fulfilled, a new game session
// has been created and a game session ARN and region are referenced. If the
// placement request times out, you have the option of resubmitting the request
// or retrying it with a different queue.
// placement request times out, you can resubmit the request or retry it with
// a different queue.
//
// Returns awserr.Error for service API and SDK errors. Use runtime type assertions
// with awserr.Error's Code and Message methods to get detailed information about
@ -5510,6 +5529,11 @@ type CreateFleetInput struct {
// See more information in the Server API Reference (http://docs.aws.amazon.com/gamelift/latest/developerguide/gamelift-sdk-server-api-ref.html#gamelift-sdk-server-api-ref-dataypes-process).
LogPaths []*string `type:"list"`
// Names of metric groups to add this fleet to. Use an existing metric group
// name to add this fleet to the group, or use a new name to create a new metric
// group. Currently, a fleet can only be included in one metric group at a time.
MetricGroups []*string `type:"list"`
// Descriptive label that is associated with a fleet. Fleet names do not need
// to be unique.
//
@ -5645,6 +5669,12 @@ func (s *CreateFleetInput) SetLogPaths(v []*string) *CreateFleetInput {
return s
}
// SetMetricGroups sets the MetricGroups field's value.
func (s *CreateFleetInput) SetMetricGroups(v []*string) *CreateFleetInput {
s.MetricGroups = v
return s
}
// SetName sets the Name field's value.
func (s *CreateFleetInput) SetName(v string) *CreateFleetInput {
s.Name = &v
@ -8354,6 +8384,12 @@ type FleetAttributes struct {
// stored logs.
LogPaths []*string `type:"list"`
// Names of metric groups that this fleet is included in. In Amazon CloudWatch,
// you can view metrics for an individual fleet or aggregated metrics for a
// fleets that are in a fleet metric group. Currently, a fleet can be included
// in only one metric group at a time.
MetricGroups []*string `type:"list"`
// Descriptive label that is associated with a fleet. Fleet names do not need
// to be unique.
Name *string `min:"1" type:"string"`
@ -8459,6 +8495,12 @@ func (s *FleetAttributes) SetLogPaths(v []*string) *FleetAttributes {
return s
}
// SetMetricGroups sets the MetricGroups field's value.
func (s *FleetAttributes) SetMetricGroups(v []*string) *FleetAttributes {
s.MetricGroups = v
return s
}
// SetName sets the Name field's value.
func (s *FleetAttributes) SetName(v string) *FleetAttributes {
s.Name = &v
@ -9095,7 +9137,7 @@ type GameSessionQueue struct {
// ARN. Destinations are listed in default preference order.
Destinations []*GameSessionQueueDestination `type:"list"`
// Amazon Resource Name (ARN (http://docs.aws.amazon.com/docs.aws.amazon.com/AmazonS3/latest/dev/s3-arn-format.html))
// Amazon Resource Name (ARN (http://docs.aws.amazon.com/AmazonS3/latest/dev/s3-arn-format.html))
// that is assigned to a game session queue and uniquely identifies it. Format
// is arn:aws:gamelift:<region>::fleet/fleet-a1234567-b8c9-0d1e-2fa3-b45c6d7e8912.
GameSessionQueueArn *string `min:"1" type:"string"`
@ -10729,8 +10771,18 @@ func (s *RoutingStrategy) SetType(v string) *RoutingStrategy {
type RuntimeConfiguration struct {
_ struct{} `type:"structure"`
// Collection of server process configurations describing what server processes
// to run on each instance in a fleet
// Maximum amount of time (in seconds) that a game session can remain in status
// ACTIVATING. If the game session is not active before the timeout, activation
// is terminated and the game session status is changed to TERMINATED.
GameSessionActivationTimeoutSeconds *int64 `min:"1" type:"integer"`
// Maximum number of game sessions with status ACTIVATING to allow on an instance
// simultaneously. This setting limits the amount of instance resources that
// can be used for new game activations at any one time.
MaxConcurrentGameSessionActivations *int64 `min:"1" type:"integer"`
// Collection of server process configurations that describe which server processes
// to run on each instance in a fleet.
ServerProcesses []*ServerProcess `min:"1" type:"list"`
}
@ -10747,6 +10799,12 @@ func (s RuntimeConfiguration) GoString() string {
// Validate inspects the fields of the type to determine if they are valid.
func (s *RuntimeConfiguration) Validate() error {
invalidParams := request.ErrInvalidParams{Context: "RuntimeConfiguration"}
if s.GameSessionActivationTimeoutSeconds != nil && *s.GameSessionActivationTimeoutSeconds < 1 {
invalidParams.Add(request.NewErrParamMinValue("GameSessionActivationTimeoutSeconds", 1))
}
if s.MaxConcurrentGameSessionActivations != nil && *s.MaxConcurrentGameSessionActivations < 1 {
invalidParams.Add(request.NewErrParamMinValue("MaxConcurrentGameSessionActivations", 1))
}
if s.ServerProcesses != nil && len(s.ServerProcesses) < 1 {
invalidParams.Add(request.NewErrParamMinLen("ServerProcesses", 1))
}
@ -10767,6 +10825,18 @@ func (s *RuntimeConfiguration) Validate() error {
return nil
}
// SetGameSessionActivationTimeoutSeconds sets the GameSessionActivationTimeoutSeconds field's value.
func (s *RuntimeConfiguration) SetGameSessionActivationTimeoutSeconds(v int64) *RuntimeConfiguration {
s.GameSessionActivationTimeoutSeconds = &v
return s
}
// SetMaxConcurrentGameSessionActivations sets the MaxConcurrentGameSessionActivations field's value.
func (s *RuntimeConfiguration) SetMaxConcurrentGameSessionActivations(v int64) *RuntimeConfiguration {
s.MaxConcurrentGameSessionActivations = &v
return s
}
// SetServerProcesses sets the ServerProcesses field's value.
func (s *RuntimeConfiguration) SetServerProcesses(v []*ServerProcess) *RuntimeConfiguration {
s.ServerProcesses = v
@ -11703,6 +11773,13 @@ type UpdateFleetAttributesInput struct {
// FleetId is a required field
FleetId *string `type:"string" required:"true"`
// Names of metric groups to include this fleet with. A fleet metric group is
// used in Amazon CloudWatch to aggregate metrics from multiple fleets. Use
// an existing metric group name to add this fleet to the group, or use a new
// name to create a new metric group. Currently, a fleet can only be included
// in one metric group at a time.
MetricGroups []*string `type:"list"`
// Descriptive label that is associated with a fleet. Fleet names do not need
// to be unique.
Name *string `min:"1" type:"string"`
@ -11764,6 +11841,12 @@ func (s *UpdateFleetAttributesInput) SetFleetId(v string) *UpdateFleetAttributes
return s
}
// SetMetricGroups sets the MetricGroups field's value.
func (s *UpdateFleetAttributesInput) SetMetricGroups(v []*string) *UpdateFleetAttributesInput {
s.MetricGroups = v
return s
}
// SetName sets the Name field's value.
func (s *UpdateFleetAttributesInput) SetName(v string) *UpdateFleetAttributesInput {
s.Name = &v
@ -12608,6 +12691,9 @@ const (
// MetricNameActiveInstances is a MetricName enum value
MetricNameActiveInstances = "ActiveInstances"
// MetricNameAvailableGameSessions is a MetricName enum value
MetricNameAvailableGameSessions = "AvailableGameSessions"
// MetricNameAvailablePlayerSessions is a MetricName enum value
MetricNameAvailablePlayerSessions = "AvailablePlayerSessions"
@ -12617,6 +12703,12 @@ const (
// MetricNameIdleInstances is a MetricName enum value
MetricNameIdleInstances = "IdleInstances"
// MetricNamePercentAvailableGameSessions is a MetricName enum value
MetricNamePercentAvailableGameSessions = "PercentAvailableGameSessions"
// MetricNamePercentIdleInstances is a MetricName enum value
MetricNamePercentIdleInstances = "PercentIdleInstances"
// MetricNameQueueDepth is a MetricName enum value
MetricNameQueueDepth = "QueueDepth"

12
vendor/github.com/aws/aws-sdk-go/service/gamelift/examples_test.go generated vendored
View File

@ -93,12 +93,18 @@ func ExampleGameLift_CreateFleet() {
aws.String("NonZeroAndMaxString"), // Required
// More values...
},
MetricGroups: []*string{
aws.String("MetricGroup"), // Required
// More values...
},
NewGameSessionProtectionPolicy: aws.String("ProtectionPolicy"),
ResourceCreationLimitPolicy: &gamelift.ResourceCreationLimitPolicy{
NewGameSessionsPerCreator: aws.Int64(1),
PolicyPeriodInMinutes: aws.Int64(1),
},
RuntimeConfiguration: &gamelift.RuntimeConfiguration{
GameSessionActivationTimeoutSeconds: aws.Int64(1),
MaxConcurrentGameSessionActivations: aws.Int64(1),
ServerProcesses: []*gamelift.ServerProcess{
{ // Required
ConcurrentExecutions: aws.Int64(1), // Required
@ -1067,6 +1073,10 @@ func ExampleGameLift_UpdateFleetAttributes() {
params := &gamelift.UpdateFleetAttributesInput{
FleetId: aws.String("FleetId"), // Required
Description: aws.String("NonZeroAndMaxString"),
MetricGroups: []*string{
aws.String("MetricGroup"), // Required
// More values...
},
Name: aws.String("NonZeroAndMaxString"),
NewGameSessionProtectionPolicy: aws.String("ProtectionPolicy"),
ResourceCreationLimitPolicy: &gamelift.ResourceCreationLimitPolicy{
@ -1218,6 +1228,8 @@ func ExampleGameLift_UpdateRuntimeConfiguration() {
params := &gamelift.UpdateRuntimeConfigurationInput{
FleetId: aws.String("FleetId"), // Required
RuntimeConfiguration: &gamelift.RuntimeConfiguration{ // Required
GameSessionActivationTimeoutSeconds: aws.Int64(1),
MaxConcurrentGameSessionActivations: aws.Int64(1),
ServerProcesses: []*gamelift.ServerProcess{
{ // Required
ConcurrentExecutions: aws.Int64(1), // Required

258
vendor/github.com/aws/aws-sdk-go/service/inspector/api.go generated vendored
View File

@ -1276,6 +1276,109 @@ func (c *Inspector) DescribeRulesPackagesWithContext(ctx aws.Context, input *Des
return out, req.Send()
}
const opGetAssessmentReport = "GetAssessmentReport"
// GetAssessmentReportRequest generates a "aws/request.Request" representing the
// client's request for the GetAssessmentReport operation. The "output" return
// value can be used to capture response data after the request's "Send" method
// is called.
//
// See GetAssessmentReport for usage and error information.
//
// Creating a request object using this method should be used when you want to inject
// custom logic into the request's lifecycle using a custom handler, or if you want to
// access properties on the request object before or after sending the request. If
// you just want the service response, call the GetAssessmentReport method directly
// instead.
//
// Note: You must call the "Send" method on the returned request object in order
// to execute the request.
//
// // Example sending a request using the GetAssessmentReportRequest method.
// req, resp := client.GetAssessmentReportRequest(params)
//
// err := req.Send()
// if err == nil { // resp is now filled
// fmt.Println(resp)
// }
//
// Please also see https://docs.aws.amazon.com/goto/WebAPI/inspector-2016-02-16/GetAssessmentReport
func (c *Inspector) GetAssessmentReportRequest(input *GetAssessmentReportInput) (req *request.Request, output *GetAssessmentReportOutput) {
op := &request.Operation{
Name: opGetAssessmentReport,
HTTPMethod: "POST",
HTTPPath: "/",
}
if input == nil {
input = &GetAssessmentReportInput{}
}
output = &GetAssessmentReportOutput{}
req = c.newRequest(op, input, output)
return
}
// GetAssessmentReport API operation for Amazon Inspector.
//
// Produces an assessment report that includes detailed and comprehensive results
// of a specified assessment run.
//
// Returns awserr.Error for service API and SDK errors. Use runtime type assertions
// with awserr.Error's Code and Message methods to get detailed information about
// the error.
//
// See the AWS API reference guide for Amazon Inspector's
// API operation GetAssessmentReport for usage and error information.
//
// Returned Error Codes:
// * ErrCodeInternalException "InternalException"
// Internal server error.
//
// * ErrCodeInvalidInputException "InvalidInputException"
// The request was rejected because an invalid or out-of-range value was supplied
// for an input parameter.
//
// * ErrCodeAccessDeniedException "AccessDeniedException"
// You do not have required permissions to access the requested resource.
//
// * ErrCodeNoSuchEntityException "NoSuchEntityException"
// The request was rejected because it referenced an entity that does not exist.
// The error code describes the entity.
//
// * ErrCodeAssessmentRunInProgressException "AssessmentRunInProgressException"
// You cannot perform a specified action if an assessment run is currently in
// progress.
//
// * ErrCodeUnsupportedFeatureException "UnsupportedFeatureException"
// Used by the GetAssessmentReport API. The request was rejected because you
// tried to generate a report for an assessment run that existed before reporting
// was supported in Amazon Inspector. You can only generate reports for assessment
// runs that took place or will take place after generating reports in Amazon
// Inspector became available.
//
// Please also see https://docs.aws.amazon.com/goto/WebAPI/inspector-2016-02-16/GetAssessmentReport
func (c *Inspector) GetAssessmentReport(input *GetAssessmentReportInput) (*GetAssessmentReportOutput, error) {
req, out := c.GetAssessmentReportRequest(input)
return out, req.Send()
}
// GetAssessmentReportWithContext is the same as GetAssessmentReport with the addition of
// the ability to pass a context and additional request options.
//
// See GetAssessmentReport for details on how to use this API operation.
//
// The context must be non-nil and will be used for request cancellation. If
// the context is nil a panic will occur. In the future the SDK may create
// sub-contexts for http.Requests. See https://golang.org/pkg/context/
// for more information on using Contexts.
func (c *Inspector) GetAssessmentReportWithContext(ctx aws.Context, input *GetAssessmentReportInput, opts ...request.Option) (*GetAssessmentReportOutput, error) {
req, out := c.GetAssessmentReportRequest(input)
req.SetContext(ctx)
req.ApplyOptions(opts...)
return out, req.Send()
}
const opGetTelemetryMetadata = "GetTelemetryMetadata"
// GetTelemetryMetadataRequest generates a "aws/request.Request" representing the
@ -3222,6 +3325,11 @@ type AssessmentRun struct {
// DurationInSeconds is a required field
DurationInSeconds *int64 `locationName:"durationInSeconds" min:"180" type:"integer" required:"true"`
// Provides a total count of generated findings per severity.
//
// FindingCounts is a required field
FindingCounts map[string]*int64 `locationName:"findingCounts" type:"map" required:"true"`
// The auto-generated name for the assessment run.
//
// Name is a required field
@ -3308,6 +3416,12 @@ func (s *AssessmentRun) SetDurationInSeconds(v int64) *AssessmentRun {
return s
}
// SetFindingCounts sets the FindingCounts field's value.
func (s *AssessmentRun) SetFindingCounts(v map[string]*int64) *AssessmentRun {
s.FindingCounts = v
return s
}
// SetName sets the Name field's value.
func (s *AssessmentRun) SetName(v string) *AssessmentRun {
s.Name = &v
@ -3580,6 +3694,7 @@ type AssessmentRunNotification struct {
// Event is a required field
Event *string `locationName:"event" type:"string" required:"true" enum:"Event"`
// The message included in the notification.
Message *string `locationName:"message" type:"string"`
// The status code of the SNS notification.
@ -5573,6 +5688,116 @@ func (s *FindingFilter) SetUserAttributes(v []*Attribute) *FindingFilter {
return s
}
// Please also see https://docs.aws.amazon.com/goto/WebAPI/inspector-2016-02-16/GetAssessmentReportRequest
type GetAssessmentReportInput struct {
_ struct{} `type:"structure"`
// The ARN that specifies the assessment run for which you want to generate
// a report.
//
// AssessmentRunArn is a required field
AssessmentRunArn *string `locationName:"assessmentRunArn" min:"1" type:"string" required:"true"`
// Specifies the file format (html or pdf) of the assessment report that you
// want to generate.
//
// ReportFileFormat is a required field
ReportFileFormat *string `locationName:"reportFileFormat" type:"string" required:"true" enum:"ReportFileFormat"`
// Specifies the type of the assessment report that you want to generate. There
// are two types of assessment reports: a finding report and a full report.
// For more information, see Assessment Reports (http://docs.aws.amazon.com/inspector/latest/userguide/inspector_reports.html).
//
// ReportType is a required field
ReportType *string `locationName:"reportType" type:"string" required:"true" enum:"ReportType"`
}
// String returns the string representation
func (s GetAssessmentReportInput) String() string {
return awsutil.Prettify(s)
}
// GoString returns the string representation
func (s GetAssessmentReportInput) GoString() string {
return s.String()
}
// Validate inspects the fields of the type to determine if they are valid.
func (s *GetAssessmentReportInput) Validate() error {
invalidParams := request.ErrInvalidParams{Context: "GetAssessmentReportInput"}
if s.AssessmentRunArn == nil {
invalidParams.Add(request.NewErrParamRequired("AssessmentRunArn"))
}
if s.AssessmentRunArn != nil && len(*s.AssessmentRunArn) < 1 {
invalidParams.Add(request.NewErrParamMinLen("AssessmentRunArn", 1))
}
if s.ReportFileFormat == nil {
invalidParams.Add(request.NewErrParamRequired("ReportFileFormat"))
}
if s.ReportType == nil {
invalidParams.Add(request.NewErrParamRequired("ReportType"))
}
if invalidParams.Len() > 0 {
return invalidParams
}
return nil
}
// SetAssessmentRunArn sets the AssessmentRunArn field's value.
func (s *GetAssessmentReportInput) SetAssessmentRunArn(v string) *GetAssessmentReportInput {
s.AssessmentRunArn = &v
return s
}
// SetReportFileFormat sets the ReportFileFormat field's value.
func (s *GetAssessmentReportInput) SetReportFileFormat(v string) *GetAssessmentReportInput {
s.ReportFileFormat = &v
return s
}
// SetReportType sets the ReportType field's value.
func (s *GetAssessmentReportInput) SetReportType(v string) *GetAssessmentReportInput {
s.ReportType = &v
return s
}
// Please also see https://docs.aws.amazon.com/goto/WebAPI/inspector-2016-02-16/GetAssessmentReportResponse
type GetAssessmentReportOutput struct {
_ struct{} `type:"structure"`
// Specifies the status of the request to generate an assessment report.
//
// Status is a required field
Status *string `locationName:"status" type:"string" required:"true" enum:"ReportStatus"`
// Specifies the URL where you can find the generated assessment report. This
// parameter is only returned if the report is successfully generated.
Url *string `locationName:"url" type:"string"`
}
// String returns the string representation
func (s GetAssessmentReportOutput) String() string {
return awsutil.Prettify(s)
}
// GoString returns the string representation
func (s GetAssessmentReportOutput) GoString() string {
return s.String()
}
// SetStatus sets the Status field's value.
func (s *GetAssessmentReportOutput) SetStatus(v string) *GetAssessmentReportOutput {
s.Status = &v
return s
}
// SetUrl sets the Url field's value.
func (s *GetAssessmentReportOutput) SetUrl(v string) *GetAssessmentReportOutput {
s.Url = &v
return s
}
// Please also see https://docs.aws.amazon.com/goto/WebAPI/inspector-2016-02-16/GetTelemetryMetadataRequest
type GetTelemetryMetadataInput struct {
_ struct{} `type:"structure"`
@ -7717,12 +7942,18 @@ const (
// AssessmentRunStateDataCollected is a AssessmentRunState enum value
AssessmentRunStateDataCollected = "DATA_COLLECTED"
// AssessmentRunStateStartEvaluatingRulesPending is a AssessmentRunState enum value
AssessmentRunStateStartEvaluatingRulesPending = "START_EVALUATING_RULES_PENDING"
// AssessmentRunStateEvaluatingRules is a AssessmentRunState enum value
AssessmentRunStateEvaluatingRules = "EVALUATING_RULES"
// AssessmentRunStateFailed is a AssessmentRunState enum value
AssessmentRunStateFailed = "FAILED"
// AssessmentRunStateError is a AssessmentRunState enum value
AssessmentRunStateError = "ERROR"
// AssessmentRunStateCompleted is a AssessmentRunState enum value
AssessmentRunStateCompleted = "COMPLETED"
@ -7992,6 +8223,33 @@ const (
NoSuchEntityErrorCodeIamRoleDoesNotExist = "IAM_ROLE_DOES_NOT_EXIST"
)
const (
// ReportFileFormatHtml is a ReportFileFormat enum value
ReportFileFormatHtml = "HTML"
// ReportFileFormatPdf is a ReportFileFormat enum value
ReportFileFormatPdf = "PDF"
)
const (
// ReportStatusWorkInProgress is a ReportStatus enum value
ReportStatusWorkInProgress = "WORK_IN_PROGRESS"
// ReportStatusFailed is a ReportStatus enum value
ReportStatusFailed = "FAILED"
// ReportStatusCompleted is a ReportStatus enum value
ReportStatusCompleted = "COMPLETED"
)
const (
// ReportTypeFinding is a ReportType enum value
ReportTypeFinding = "FINDING"
// ReportTypeFull is a ReportType enum value
ReportTypeFull = "FULL"
)
const (
// SeverityLow is a Severity enum value
SeverityLow = "Low"

10
vendor/github.com/aws/aws-sdk-go/service/inspector/errors.go generated vendored
View File

@ -57,4 +57,14 @@ const (
// The request was rejected because it referenced an entity that does not exist.
// The error code describes the entity.
ErrCodeNoSuchEntityException = "NoSuchEntityException"
// ErrCodeUnsupportedFeatureException for service response error code
// "UnsupportedFeatureException".
//
// Used by the GetAssessmentReport API. The request was rejected because you
// tried to generate a report for an assessment run that existed before reporting
// was supported in Amazon Inspector. You can only generate reports for assessment
// runs that took place or will take place after generating reports in Amazon
// Inspector became available.
ErrCodeUnsupportedFeatureException = "UnsupportedFeatureException"
)

23
vendor/github.com/aws/aws-sdk-go/service/inspector/examples_test.go generated vendored
View File

@ -357,6 +357,29 @@ func ExampleInspector_DescribeRulesPackages() {
fmt.Println(resp)
}
func ExampleInspector_GetAssessmentReport() {
sess := session.Must(session.NewSession())
svc := inspector.New(sess)
params := &inspector.GetAssessmentReportInput{
AssessmentRunArn: aws.String("Arn"), // Required
ReportFileFormat: aws.String("ReportFileFormat"), // Required
ReportType: aws.String("ReportType"), // Required
}
resp, err := svc.GetAssessmentReport(params)
if err != nil {
// Print the error, cast err to awserr.Error to get the Code and
// Message from an error.
fmt.Println(err.Error())
return
}
// Pretty-print the response data.
fmt.Println(resp)
}
func ExampleInspector_GetTelemetryMetadata() {
sess := session.Must(session.NewSession())

4
vendor/github.com/aws/aws-sdk-go/service/inspector/inspectoriface/interface.go generated vendored
View File

@ -116,6 +116,10 @@ type InspectorAPI interface {
DescribeRulesPackagesWithContext(aws.Context, *inspector.DescribeRulesPackagesInput, ...request.Option) (*inspector.DescribeRulesPackagesOutput, error)
DescribeRulesPackagesRequest(*inspector.DescribeRulesPackagesInput) (*request.Request, *inspector.DescribeRulesPackagesOutput)
GetAssessmentReport(*inspector.GetAssessmentReportInput) (*inspector.GetAssessmentReportOutput, error)
GetAssessmentReportWithContext(aws.Context, *inspector.GetAssessmentReportInput, ...request.Option) (*inspector.GetAssessmentReportOutput, error)
GetAssessmentReportRequest(*inspector.GetAssessmentReportInput) (*request.Request, *inspector.GetAssessmentReportOutput)
GetTelemetryMetadata(*inspector.GetTelemetryMetadataInput) (*inspector.GetTelemetryMetadataOutput, error)
GetTelemetryMetadataWithContext(aws.Context, *inspector.GetTelemetryMetadataInput, ...request.Option) (*inspector.GetTelemetryMetadataOutput, error)
GetTelemetryMetadataRequest(*inspector.GetTelemetryMetadataInput) (*request.Request, *inspector.GetTelemetryMetadataOutput)

6
vendor/github.com/aws/aws-sdk-go/service/kms/api.go generated vendored
View File

@ -4336,9 +4336,9 @@ type CreateGrantInput struct {
//
// To specify the principal, use the Amazon Resource Name (ARN) (http://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html)
// of an AWS principal. Valid AWS principals include AWS accounts (root), IAM
// users, federated users, and assumed role users. For examples of the ARN syntax
// to use for specifying a principal, see AWS Identity and Access Management
// (IAM) (http://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html#arn-syntax-iam)
// users, IAM roles, federated users, and assumed role users. For examples of
// the ARN syntax to use for specifying a principal, see AWS Identity and Access
// Management (IAM) (http://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html#arn-syntax-iam)
// in the Example ARNs section of the AWS General Reference.
//
// GranteePrincipal is a required field

485
vendor/github.com/aws/aws-sdk-go/service/lightsail/api.go generated vendored
View File

@ -72,6 +72,10 @@ func (c *Lightsail) AllocateStaticIpRequest(input *AllocateStaticIpInput) (req *
// Lightsail throws this exception when user input does not conform to the validation
// rules of an input field.
//
// Domain-related APIs are only available in the N. Virginia (us-east-1) Region.
// Please set your Region configuration to us-east-1 to create, view, or edit
// these resources.
//
// * ErrCodeNotFoundException "NotFoundException"
// Lightsail throws this exception when it cannot find a resource.
//
@ -173,6 +177,10 @@ func (c *Lightsail) AttachStaticIpRequest(input *AttachStaticIpInput) (req *requ
// Lightsail throws this exception when user input does not conform to the validation
// rules of an input field.
//
// Domain-related APIs are only available in the N. Virginia (us-east-1) Region.
// Please set your Region configuration to us-east-1 to create, view, or edit
// these resources.
//
// * ErrCodeNotFoundException "NotFoundException"
// Lightsail throws this exception when it cannot find a resource.
//
@ -274,6 +282,10 @@ func (c *Lightsail) CloseInstancePublicPortsRequest(input *CloseInstancePublicPo
// Lightsail throws this exception when user input does not conform to the validation
// rules of an input field.
//
// Domain-related APIs are only available in the N. Virginia (us-east-1) Region.
// Please set your Region configuration to us-east-1 to create, view, or edit
// these resources.
//
// * ErrCodeNotFoundException "NotFoundException"
// Lightsail throws this exception when it cannot find a resource.
//
@ -375,6 +387,10 @@ func (c *Lightsail) CreateDomainRequest(input *CreateDomainInput) (req *request.
// Lightsail throws this exception when user input does not conform to the validation
// rules of an input field.
//
// Domain-related APIs are only available in the N. Virginia (us-east-1) Region.
// Please set your Region configuration to us-east-1 to create, view, or edit
// these resources.
//
// * ErrCodeNotFoundException "NotFoundException"
// Lightsail throws this exception when it cannot find a resource.
//
@ -477,6 +493,10 @@ func (c *Lightsail) CreateDomainEntryRequest(input *CreateDomainEntryInput) (req
// Lightsail throws this exception when user input does not conform to the validation
// rules of an input field.
//
// Domain-related APIs are only available in the N. Virginia (us-east-1) Region.
// Please set your Region configuration to us-east-1 to create, view, or edit
// these resources.
//
// * ErrCodeNotFoundException "NotFoundException"
// Lightsail throws this exception when it cannot find a resource.
//
@ -579,6 +599,10 @@ func (c *Lightsail) CreateInstanceSnapshotRequest(input *CreateInstanceSnapshotI
// Lightsail throws this exception when user input does not conform to the validation
// rules of an input field.
//
// Domain-related APIs are only available in the N. Virginia (us-east-1) Region.
// Please set your Region configuration to us-east-1 to create, view, or edit
// these resources.
//
// * ErrCodeNotFoundException "NotFoundException"
// Lightsail throws this exception when it cannot find a resource.
//
@ -680,6 +704,10 @@ func (c *Lightsail) CreateInstancesRequest(input *CreateInstancesInput) (req *re
// Lightsail throws this exception when user input does not conform to the validation
// rules of an input field.
//
// Domain-related APIs are only available in the N. Virginia (us-east-1) Region.
// Please set your Region configuration to us-east-1 to create, view, or edit
// these resources.
//
// * ErrCodeNotFoundException "NotFoundException"
// Lightsail throws this exception when it cannot find a resource.
//
@ -782,6 +810,10 @@ func (c *Lightsail) CreateInstancesFromSnapshotRequest(input *CreateInstancesFro
// Lightsail throws this exception when user input does not conform to the validation
// rules of an input field.
//
// Domain-related APIs are only available in the N. Virginia (us-east-1) Region.
// Please set your Region configuration to us-east-1 to create, view, or edit
// these resources.
//
// * ErrCodeNotFoundException "NotFoundException"
// Lightsail throws this exception when it cannot find a resource.
//
@ -883,6 +915,10 @@ func (c *Lightsail) CreateKeyPairRequest(input *CreateKeyPairInput) (req *reques
// Lightsail throws this exception when user input does not conform to the validation
// rules of an input field.
//
// Domain-related APIs are only available in the N. Virginia (us-east-1) Region.
// Please set your Region configuration to us-east-1 to create, view, or edit
// these resources.
//
// * ErrCodeNotFoundException "NotFoundException"
// Lightsail throws this exception when it cannot find a resource.
//
@ -984,6 +1020,10 @@ func (c *Lightsail) DeleteDomainRequest(input *DeleteDomainInput) (req *request.
// Lightsail throws this exception when user input does not conform to the validation
// rules of an input field.
//
// Domain-related APIs are only available in the N. Virginia (us-east-1) Region.
// Please set your Region configuration to us-east-1 to create, view, or edit
// these resources.
//
// * ErrCodeNotFoundException "NotFoundException"
// Lightsail throws this exception when it cannot find a resource.
//
@ -1085,6 +1125,10 @@ func (c *Lightsail) DeleteDomainEntryRequest(input *DeleteDomainEntryInput) (req
// Lightsail throws this exception when user input does not conform to the validation
// rules of an input field.
//
// Domain-related APIs are only available in the N. Virginia (us-east-1) Region.
// Please set your Region configuration to us-east-1 to create, view, or edit
// these resources.
//
// * ErrCodeNotFoundException "NotFoundException"
// Lightsail throws this exception when it cannot find a resource.
//
@ -1186,6 +1230,10 @@ func (c *Lightsail) DeleteInstanceRequest(input *DeleteInstanceInput) (req *requ
// Lightsail throws this exception when user input does not conform to the validation
// rules of an input field.
//
// Domain-related APIs are only available in the N. Virginia (us-east-1) Region.
// Please set your Region configuration to us-east-1 to create, view, or edit
// these resources.
//
// * ErrCodeNotFoundException "NotFoundException"
// Lightsail throws this exception when it cannot find a resource.
//
@ -1287,6 +1335,10 @@ func (c *Lightsail) DeleteInstanceSnapshotRequest(input *DeleteInstanceSnapshotI
// Lightsail throws this exception when user input does not conform to the validation
// rules of an input field.
//
// Domain-related APIs are only available in the N. Virginia (us-east-1) Region.
// Please set your Region configuration to us-east-1 to create, view, or edit
// these resources.
//
// * ErrCodeNotFoundException "NotFoundException"
// Lightsail throws this exception when it cannot find a resource.
//
@ -1388,6 +1440,10 @@ func (c *Lightsail) DeleteKeyPairRequest(input *DeleteKeyPairInput) (req *reques
// Lightsail throws this exception when user input does not conform to the validation
// rules of an input field.
//
// Domain-related APIs are only available in the N. Virginia (us-east-1) Region.
// Please set your Region configuration to us-east-1 to create, view, or edit
// these resources.
//
// * ErrCodeNotFoundException "NotFoundException"
// Lightsail throws this exception when it cannot find a resource.
//
@ -1489,6 +1545,10 @@ func (c *Lightsail) DetachStaticIpRequest(input *DetachStaticIpInput) (req *requ
// Lightsail throws this exception when user input does not conform to the validation
// rules of an input field.
//
// Domain-related APIs are only available in the N. Virginia (us-east-1) Region.
// Please set your Region configuration to us-east-1 to create, view, or edit
// these resources.
//
// * ErrCodeNotFoundException "NotFoundException"
// Lightsail throws this exception when it cannot find a resource.
//
@ -1590,6 +1650,10 @@ func (c *Lightsail) DownloadDefaultKeyPairRequest(input *DownloadDefaultKeyPairI
// Lightsail throws this exception when user input does not conform to the validation
// rules of an input field.
//
// Domain-related APIs are only available in the N. Virginia (us-east-1) Region.
// Please set your Region configuration to us-east-1 to create, view, or edit
// these resources.
//
// * ErrCodeNotFoundException "NotFoundException"
// Lightsail throws this exception when it cannot find a resource.
//
@ -1691,6 +1755,10 @@ func (c *Lightsail) GetActiveNamesRequest(input *GetActiveNamesInput) (req *requ
// Lightsail throws this exception when user input does not conform to the validation
// rules of an input field.
//
// Domain-related APIs are only available in the N. Virginia (us-east-1) Region.
// Please set your Region configuration to us-east-1 to create, view, or edit
// these resources.
//
// * ErrCodeNotFoundException "NotFoundException"
// Lightsail throws this exception when it cannot find a resource.
//
@ -1795,6 +1863,10 @@ func (c *Lightsail) GetBlueprintsRequest(input *GetBlueprintsInput) (req *reques
// Lightsail throws this exception when user input does not conform to the validation
// rules of an input field.
//
// Domain-related APIs are only available in the N. Virginia (us-east-1) Region.
// Please set your Region configuration to us-east-1 to create, view, or edit
// these resources.
//
// * ErrCodeNotFoundException "NotFoundException"
// Lightsail throws this exception when it cannot find a resource.
//
@ -1897,6 +1969,10 @@ func (c *Lightsail) GetBundlesRequest(input *GetBundlesInput) (req *request.Requ
// Lightsail throws this exception when user input does not conform to the validation
// rules of an input field.
//
// Domain-related APIs are only available in the N. Virginia (us-east-1) Region.
// Please set your Region configuration to us-east-1 to create, view, or edit
// these resources.
//
// * ErrCodeNotFoundException "NotFoundException"
// Lightsail throws this exception when it cannot find a resource.
//
@ -1998,6 +2074,10 @@ func (c *Lightsail) GetDomainRequest(input *GetDomainInput) (req *request.Reques
// Lightsail throws this exception when user input does not conform to the validation
// rules of an input field.
//
// Domain-related APIs are only available in the N. Virginia (us-east-1) Region.
// Please set your Region configuration to us-east-1 to create, view, or edit
// these resources.
//
// * ErrCodeNotFoundException "NotFoundException"
// Lightsail throws this exception when it cannot find a resource.
//
@ -2099,6 +2179,10 @@ func (c *Lightsail) GetDomainsRequest(input *GetDomainsInput) (req *request.Requ
// Lightsail throws this exception when user input does not conform to the validation
// rules of an input field.
//
// Domain-related APIs are only available in the N. Virginia (us-east-1) Region.
// Please set your Region configuration to us-east-1 to create, view, or edit
// these resources.
//
// * ErrCodeNotFoundException "NotFoundException"
// Lightsail throws this exception when it cannot find a resource.
//
@ -2201,6 +2285,10 @@ func (c *Lightsail) GetInstanceRequest(input *GetInstanceInput) (req *request.Re
// Lightsail throws this exception when user input does not conform to the validation
// rules of an input field.
//
// Domain-related APIs are only available in the N. Virginia (us-east-1) Region.
// Please set your Region configuration to us-east-1 to create, view, or edit
// these resources.
//
// * ErrCodeNotFoundException "NotFoundException"
// Lightsail throws this exception when it cannot find a resource.
//
@ -2303,6 +2391,10 @@ func (c *Lightsail) GetInstanceAccessDetailsRequest(input *GetInstanceAccessDeta
// Lightsail throws this exception when user input does not conform to the validation
// rules of an input field.
//
// Domain-related APIs are only available in the N. Virginia (us-east-1) Region.
// Please set your Region configuration to us-east-1 to create, view, or edit
// these resources.
//
// * ErrCodeNotFoundException "NotFoundException"
// Lightsail throws this exception when it cannot find a resource.
//
@ -2405,6 +2497,10 @@ func (c *Lightsail) GetInstanceMetricDataRequest(input *GetInstanceMetricDataInp
// Lightsail throws this exception when user input does not conform to the validation
// rules of an input field.
//
// Domain-related APIs are only available in the N. Virginia (us-east-1) Region.
// Please set your Region configuration to us-east-1 to create, view, or edit
// these resources.
//
// * ErrCodeNotFoundException "NotFoundException"
// Lightsail throws this exception when it cannot find a resource.
//
@ -2506,6 +2602,10 @@ func (c *Lightsail) GetInstancePortStatesRequest(input *GetInstancePortStatesInp
// Lightsail throws this exception when user input does not conform to the validation
// rules of an input field.
//
// Domain-related APIs are only available in the N. Virginia (us-east-1) Region.
// Please set your Region configuration to us-east-1 to create, view, or edit
// these resources.
//
// * ErrCodeNotFoundException "NotFoundException"
// Lightsail throws this exception when it cannot find a resource.
//
@ -2607,6 +2707,10 @@ func (c *Lightsail) GetInstanceSnapshotRequest(input *GetInstanceSnapshotInput)
// Lightsail throws this exception when user input does not conform to the validation
// rules of an input field.
//
// Domain-related APIs are only available in the N. Virginia (us-east-1) Region.
// Please set your Region configuration to us-east-1 to create, view, or edit
// these resources.
//
// * ErrCodeNotFoundException "NotFoundException"
// Lightsail throws this exception when it cannot find a resource.
//
@ -2708,6 +2812,10 @@ func (c *Lightsail) GetInstanceSnapshotsRequest(input *GetInstanceSnapshotsInput
// Lightsail throws this exception when user input does not conform to the validation
// rules of an input field.
//
// Domain-related APIs are only available in the N. Virginia (us-east-1) Region.
// Please set your Region configuration to us-east-1 to create, view, or edit
// these resources.
//
// * ErrCodeNotFoundException "NotFoundException"
// Lightsail throws this exception when it cannot find a resource.
//
@ -2809,6 +2917,10 @@ func (c *Lightsail) GetInstanceStateRequest(input *GetInstanceStateInput) (req *
// Lightsail throws this exception when user input does not conform to the validation
// rules of an input field.
//
// Domain-related APIs are only available in the N. Virginia (us-east-1) Region.
// Please set your Region configuration to us-east-1 to create, view, or edit
// these resources.
//
// * ErrCodeNotFoundException "NotFoundException"
// Lightsail throws this exception when it cannot find a resource.
//
@ -2911,6 +3023,10 @@ func (c *Lightsail) GetInstancesRequest(input *GetInstancesInput) (req *request.
// Lightsail throws this exception when user input does not conform to the validation
// rules of an input field.
//
// Domain-related APIs are only available in the N. Virginia (us-east-1) Region.
// Please set your Region configuration to us-east-1 to create, view, or edit
// these resources.
//
// * ErrCodeNotFoundException "NotFoundException"
// Lightsail throws this exception when it cannot find a resource.
//
@ -3012,6 +3128,10 @@ func (c *Lightsail) GetKeyPairRequest(input *GetKeyPairInput) (req *request.Requ
// Lightsail throws this exception when user input does not conform to the validation
// rules of an input field.
//
// Domain-related APIs are only available in the N. Virginia (us-east-1) Region.
// Please set your Region configuration to us-east-1 to create, view, or edit
// these resources.
//
// * ErrCodeNotFoundException "NotFoundException"
// Lightsail throws this exception when it cannot find a resource.
//
@ -3113,6 +3233,10 @@ func (c *Lightsail) GetKeyPairsRequest(input *GetKeyPairsInput) (req *request.Re
// Lightsail throws this exception when user input does not conform to the validation
// rules of an input field.
//
// Domain-related APIs are only available in the N. Virginia (us-east-1) Region.
// Please set your Region configuration to us-east-1 to create, view, or edit
// these resources.
//
// * ErrCodeNotFoundException "NotFoundException"
// Lightsail throws this exception when it cannot find a resource.
//
@ -3216,6 +3340,10 @@ func (c *Lightsail) GetOperationRequest(input *GetOperationInput) (req *request.
// Lightsail throws this exception when user input does not conform to the validation
// rules of an input field.
//
// Domain-related APIs are only available in the N. Virginia (us-east-1) Region.
// Please set your Region configuration to us-east-1 to create, view, or edit
// these resources.
//
// * ErrCodeNotFoundException "NotFoundException"
// Lightsail throws this exception when it cannot find a resource.
//
@ -3321,6 +3449,10 @@ func (c *Lightsail) GetOperationsRequest(input *GetOperationsInput) (req *reques
// Lightsail throws this exception when user input does not conform to the validation
// rules of an input field.
//
// Domain-related APIs are only available in the N. Virginia (us-east-1) Region.
// Please set your Region configuration to us-east-1 to create, view, or edit
// these resources.
//
// * ErrCodeNotFoundException "NotFoundException"
// Lightsail throws this exception when it cannot find a resource.
//
@ -3422,6 +3554,10 @@ func (c *Lightsail) GetOperationsForResourceRequest(input *GetOperationsForResou
// Lightsail throws this exception when user input does not conform to the validation
// rules of an input field.
//
// Domain-related APIs are only available in the N. Virginia (us-east-1) Region.
// Please set your Region configuration to us-east-1 to create, view, or edit
// these resources.
//
// * ErrCodeNotFoundException "NotFoundException"
// Lightsail throws this exception when it cannot find a resource.
//
@ -3506,7 +3642,8 @@ func (c *Lightsail) GetRegionsRequest(input *GetRegionsInput) (req *request.Requ
// GetRegions API operation for Amazon Lightsail.
//
// Returns a list of all valid regions for Amazon Lightsail.
// Returns a list of all valid regions for Amazon Lightsail. Use the include
// availability zones parameter to also return the availability zones in a region.
//
// Returns awserr.Error for service API and SDK errors. Use runtime type assertions
// with awserr.Error's Code and Message methods to get detailed information about
@ -3523,6 +3660,10 @@ func (c *Lightsail) GetRegionsRequest(input *GetRegionsInput) (req *request.Requ
// Lightsail throws this exception when user input does not conform to the validation
// rules of an input field.
//
// Domain-related APIs are only available in the N. Virginia (us-east-1) Region.
// Please set your Region configuration to us-east-1 to create, view, or edit
// these resources.
//
// * ErrCodeNotFoundException "NotFoundException"
// Lightsail throws this exception when it cannot find a resource.
//
@ -3624,6 +3765,10 @@ func (c *Lightsail) GetStaticIpRequest(input *GetStaticIpInput) (req *request.Re
// Lightsail throws this exception when user input does not conform to the validation
// rules of an input field.
//
// Domain-related APIs are only available in the N. Virginia (us-east-1) Region.
// Please set your Region configuration to us-east-1 to create, view, or edit
// these resources.
//
// * ErrCodeNotFoundException "NotFoundException"
// Lightsail throws this exception when it cannot find a resource.
//
@ -3725,6 +3870,10 @@ func (c *Lightsail) GetStaticIpsRequest(input *GetStaticIpsInput) (req *request.
// Lightsail throws this exception when user input does not conform to the validation
// rules of an input field.
//
// Domain-related APIs are only available in the N. Virginia (us-east-1) Region.
// Please set your Region configuration to us-east-1 to create, view, or edit
// these resources.
//
// * ErrCodeNotFoundException "NotFoundException"
// Lightsail throws this exception when it cannot find a resource.
//
@ -3826,6 +3975,10 @@ func (c *Lightsail) ImportKeyPairRequest(input *ImportKeyPairInput) (req *reques
// Lightsail throws this exception when user input does not conform to the validation
// rules of an input field.
//
// Domain-related APIs are only available in the N. Virginia (us-east-1) Region.
// Please set your Region configuration to us-east-1 to create, view, or edit
// these resources.
//
// * ErrCodeNotFoundException "NotFoundException"
// Lightsail throws this exception when it cannot find a resource.
//
@ -3927,6 +4080,10 @@ func (c *Lightsail) IsVpcPeeredRequest(input *IsVpcPeeredInput) (req *request.Re
// Lightsail throws this exception when user input does not conform to the validation
// rules of an input field.
//
// Domain-related APIs are only available in the N. Virginia (us-east-1) Region.
// Please set your Region configuration to us-east-1 to create, view, or edit
// these resources.
//
// * ErrCodeNotFoundException "NotFoundException"
// Lightsail throws this exception when it cannot find a resource.
//
@ -4028,6 +4185,10 @@ func (c *Lightsail) OpenInstancePublicPortsRequest(input *OpenInstancePublicPort
// Lightsail throws this exception when user input does not conform to the validation
// rules of an input field.
//
// Domain-related APIs are only available in the N. Virginia (us-east-1) Region.
// Please set your Region configuration to us-east-1 to create, view, or edit
// these resources.
//
// * ErrCodeNotFoundException "NotFoundException"
// Lightsail throws this exception when it cannot find a resource.
//
@ -4129,6 +4290,10 @@ func (c *Lightsail) PeerVpcRequest(input *PeerVpcInput) (req *request.Request, o
// Lightsail throws this exception when user input does not conform to the validation
// rules of an input field.
//
// Domain-related APIs are only available in the N. Virginia (us-east-1) Region.
// Please set your Region configuration to us-east-1 to create, view, or edit
// these resources.
//
// * ErrCodeNotFoundException "NotFoundException"
// Lightsail throws this exception when it cannot find a resource.
//
@ -4168,6 +4333,112 @@ func (c *Lightsail) PeerVpcWithContext(ctx aws.Context, input *PeerVpcInput, opt
return out, req.Send()
}
const opPutInstancePublicPorts = "PutInstancePublicPorts"
// PutInstancePublicPortsRequest generates a "aws/request.Request" representing the
// client's request for the PutInstancePublicPorts operation. The "output" return
// value can be used to capture response data after the request's "Send" method
// is called.
//
// See PutInstancePublicPorts for usage and error information.
//
// Creating a request object using this method should be used when you want to inject
// custom logic into the request's lifecycle using a custom handler, or if you want to
// access properties on the request object before or after sending the request. If
// you just want the service response, call the PutInstancePublicPorts method directly
// instead.
//
// Note: You must call the "Send" method on the returned request object in order
// to execute the request.
//
// // Example sending a request using the PutInstancePublicPortsRequest method.
// req, resp := client.PutInstancePublicPortsRequest(params)
//
// err := req.Send()
// if err == nil { // resp is now filled
// fmt.Println(resp)
// }
//
// Please also see https://docs.aws.amazon.com/goto/WebAPI/lightsail-2016-11-28/PutInstancePublicPorts
func (c *Lightsail) PutInstancePublicPortsRequest(input *PutInstancePublicPortsInput) (req *request.Request, output *PutInstancePublicPortsOutput) {
op := &request.Operation{
Name: opPutInstancePublicPorts,
HTTPMethod: "POST",
HTTPPath: "/",
}
if input == nil {
input = &PutInstancePublicPortsInput{}
}
output = &PutInstancePublicPortsOutput{}
req = c.newRequest(op, input, output)
return
}
// PutInstancePublicPorts API operation for Amazon Lightsail.
//
// Sets the specified open ports for an Amazon Lightsail instance, and closes
// all ports for every protocol not included in the current request.
//
// Returns awserr.Error for service API and SDK errors. Use runtime type assertions
// with awserr.Error's Code and Message methods to get detailed information about
// the error.
//
// See the AWS API reference guide for Amazon Lightsail's
// API operation PutInstancePublicPorts for usage and error information.
//
// Returned Error Codes:
// * ErrCodeServiceException "ServiceException"
// A general service exception.
//
// * ErrCodeInvalidInputException "InvalidInputException"
// Lightsail throws this exception when user input does not conform to the validation
// rules of an input field.
//
// Domain-related APIs are only available in the N. Virginia (us-east-1) Region.
// Please set your Region configuration to us-east-1 to create, view, or edit
// these resources.
//
// * ErrCodeNotFoundException "NotFoundException"
// Lightsail throws this exception when it cannot find a resource.
//
// * ErrCodeOperationFailureException "OperationFailureException"
// Lightsail throws this exception when an operation fails to execute.
//
// * ErrCodeAccessDeniedException "AccessDeniedException"
// Lightsail throws this exception when the user cannot be authenticated or
// uses invalid credentials to access a resource.
//
// * ErrCodeAccountSetupInProgressException "AccountSetupInProgressException"
// Lightsail throws this exception when an account is still in the setup in
// progress state.
//
// * ErrCodeUnauthenticatedException "UnauthenticatedException"
// Lightsail throws this exception when the user has not been authenticated.
//
// Please also see https://docs.aws.amazon.com/goto/WebAPI/lightsail-2016-11-28/PutInstancePublicPorts
func (c *Lightsail) PutInstancePublicPorts(input *PutInstancePublicPortsInput) (*PutInstancePublicPortsOutput, error) {
req, out := c.PutInstancePublicPortsRequest(input)
return out, req.Send()
}
// PutInstancePublicPortsWithContext is the same as PutInstancePublicPorts with the addition of
// the ability to pass a context and additional request options.
//
// See PutInstancePublicPorts for details on how to use this API operation.
//
// The context must be non-nil and will be used for request cancellation. If
// the context is nil a panic will occur. In the future the SDK may create
// sub-contexts for http.Requests. See https://golang.org/pkg/context/
// for more information on using Contexts.
func (c *Lightsail) PutInstancePublicPortsWithContext(ctx aws.Context, input *PutInstancePublicPortsInput, opts ...request.Option) (*PutInstancePublicPortsOutput, error) {
req, out := c.PutInstancePublicPortsRequest(input)
req.SetContext(ctx)
req.ApplyOptions(opts...)
return out, req.Send()
}
const opRebootInstance = "RebootInstance"
// RebootInstanceRequest generates a "aws/request.Request" representing the
@ -4233,6 +4504,10 @@ func (c *Lightsail) RebootInstanceRequest(input *RebootInstanceInput) (req *requ
// Lightsail throws this exception when user input does not conform to the validation
// rules of an input field.
//
// Domain-related APIs are only available in the N. Virginia (us-east-1) Region.
// Please set your Region configuration to us-east-1 to create, view, or edit
// these resources.
//
// * ErrCodeNotFoundException "NotFoundException"
// Lightsail throws this exception when it cannot find a resource.
//
@ -4334,6 +4609,10 @@ func (c *Lightsail) ReleaseStaticIpRequest(input *ReleaseStaticIpInput) (req *re
// Lightsail throws this exception when user input does not conform to the validation
// rules of an input field.
//
// Domain-related APIs are only available in the N. Virginia (us-east-1) Region.
// Please set your Region configuration to us-east-1 to create, view, or edit
// these resources.
//
// * ErrCodeNotFoundException "NotFoundException"
// Lightsail throws this exception when it cannot find a resource.
//
@ -4436,6 +4715,10 @@ func (c *Lightsail) StartInstanceRequest(input *StartInstanceInput) (req *reques
// Lightsail throws this exception when user input does not conform to the validation
// rules of an input field.
//
// Domain-related APIs are only available in the N. Virginia (us-east-1) Region.
// Please set your Region configuration to us-east-1 to create, view, or edit
// these resources.
//
// * ErrCodeNotFoundException "NotFoundException"
// Lightsail throws this exception when it cannot find a resource.
//
@ -4537,6 +4820,10 @@ func (c *Lightsail) StopInstanceRequest(input *StopInstanceInput) (req *request.
// Lightsail throws this exception when user input does not conform to the validation
// rules of an input field.
//
// Domain-related APIs are only available in the N. Virginia (us-east-1) Region.
// Please set your Region configuration to us-east-1 to create, view, or edit
// these resources.
//
// * ErrCodeNotFoundException "NotFoundException"
// Lightsail throws this exception when it cannot find a resource.
//
@ -4638,6 +4925,10 @@ func (c *Lightsail) UnpeerVpcRequest(input *UnpeerVpcInput) (req *request.Reques
// Lightsail throws this exception when user input does not conform to the validation
// rules of an input field.
//
// Domain-related APIs are only available in the N. Virginia (us-east-1) Region.
// Please set your Region configuration to us-east-1 to create, view, or edit
// these resources.
//
// * ErrCodeNotFoundException "NotFoundException"
// Lightsail throws this exception when it cannot find a resource.
//
@ -4739,6 +5030,10 @@ func (c *Lightsail) UpdateDomainEntryRequest(input *UpdateDomainEntryInput) (req
// Lightsail throws this exception when user input does not conform to the validation
// rules of an input field.
//
// Domain-related APIs are only available in the N. Virginia (us-east-1) Region.
// Please set your Region configuration to us-east-1 to create, view, or edit
// these resources.
//
// * ErrCodeNotFoundException "NotFoundException"
// Lightsail throws this exception when it cannot find a resource.
//
@ -4927,7 +5222,7 @@ type AvailabilityZone struct {
// The state of the Availability Zone.
State *string `locationName:"state" type:"string"`
// The name of the Availability Zone.
// The name of the Availability Zone. The format is us-east-1a (case-sensitive).
ZoneName *string `locationName:"zoneName" type:"string"`
}
@ -5487,7 +5782,10 @@ type CreateInstancesFromSnapshotInput struct {
_ struct{} `type:"structure"`
// The Availability Zone where you want to create your instances. Use the following
// formatting: us-east-1a (case sensitive).
// formatting: us-east-1a (case sensitive). You can get a list of availability
// zones by using the get regions (http://docs.aws.amazon.com/lightsail/2016-11-28/api-reference/API_GetRegions.html)
// operation. Be sure to add the include availability zones parameter to your
// request.
//
// AvailabilityZone is a required field
AvailabilityZone *string `locationName:"availabilityZone" type:"string" required:"true"`
@ -5621,7 +5919,10 @@ type CreateInstancesInput struct {
_ struct{} `type:"structure"`
// The Availability Zone in which to create your instance. Use the following
// format: us-east-1a (case sensitive).
// format: us-east-1a (case sensitive). You can get a list of availability zones
// by using the get regions (http://docs.aws.amazon.com/lightsail/2016-11-28/api-reference/API_GetRegions.html)
// operation. Be sure to add the include availability zones parameter to your
// request.
//
// AvailabilityZone is a required field
AvailabilityZone *string `locationName:"availabilityZone" type:"string" required:"true"`
@ -7246,7 +7547,7 @@ type GetInstancePortStatesOutput struct {
_ struct{} `type:"structure"`
// Information about the port states resulting from your request.
PortStates []*string `locationName:"portStates" type:"list"`
PortStates []*InstancePortState `locationName:"portStates" type:"list"`
}
// String returns the string representation
@ -7260,7 +7561,7 @@ func (s GetInstancePortStatesOutput) GoString() string {
}
// SetPortStates sets the PortStates field's value.
func (s *GetInstancePortStatesOutput) SetPortStates(v []*string) *GetInstancePortStatesOutput {
func (s *GetInstancePortStatesOutput) SetPortStates(v []*InstancePortState) *GetInstancePortStatesOutput {
s.PortStates = v
return s
}
@ -8463,7 +8764,24 @@ type InstancePortInfo struct {
// The first port in the range.
FromPort *int64 `locationName:"fromPort" type:"integer"`
// The protocol.
// The protocol being used. Can be one of the following.
//
// * tcp - Transmission Control Protocol (TCP) provides reliable, ordered,
// and error-checked delivery of streamed data between applications running
// on hosts communicating by an IP network. If you have an application that
// doesn't require reliable data stream service, use UDP instead.
//
// * all - All transport layer protocol types. For more general information,
// see Transport layer (https://en.wikipedia.org/wiki/Transport_layer) on
// Wikipedia.
//
// * udp - With User Datagram Protocol (UDP), computer applications can send
// messages (or datagrams) to other hosts on an Internet Protocol (IP) network.
// Prior communications are not required to set up transmission channels
// or data paths. Applications that don't require reliable data stream service
// can use UDP, which provides a connectionless datagram service that emphasizes
// reduced latency over reliability. If you do require reliable data stream
// service, use TCP instead.
Protocol *string `locationName:"protocol" type:"string" enum:"NetworkProtocol"`
// The last port in the range.
@ -8522,6 +8840,75 @@ func (s *InstancePortInfo) SetToPort(v int64) *InstancePortInfo {
return s
}
// Describes the port state.
// Please also see https://docs.aws.amazon.com/goto/WebAPI/lightsail-2016-11-28/InstancePortState
type InstancePortState struct {
_ struct{} `type:"structure"`
// The first port in the range.
FromPort *int64 `locationName:"fromPort" type:"integer"`
// The protocol being used. Can be one of the following.
//
// * tcp - Transmission Control Protocol (TCP) provides reliable, ordered,
// and error-checked delivery of streamed data between applications running
// on hosts communicating by an IP network. If you have an application that
// doesn't require reliable data stream service, use UDP instead.
//
// * all - All transport layer protocol types. For more general information,
// see Transport layer (https://en.wikipedia.org/wiki/Transport_layer) on
// Wikipedia.
//
// * udp - With User Datagram Protocol (UDP), computer applications can send
// messages (or datagrams) to other hosts on an Internet Protocol (IP) network.
// Prior communications are not required to set up transmission channels
// or data paths. Applications that don't require reliable data stream service
// can use UDP, which provides a connectionless datagram service that emphasizes
// reduced latency over reliability. If you do require reliable data stream
// service, use TCP instead.
Protocol *string `locationName:"protocol" type:"string" enum:"NetworkProtocol"`
// Specifies whether the instance port is open or closed.
State *string `locationName:"state" type:"string" enum:"PortState"`
// The last port in the range.
ToPort *int64 `locationName:"toPort" type:"integer"`
}
// String returns the string representation
func (s InstancePortState) String() string {
return awsutil.Prettify(s)
}
// GoString returns the string representation
func (s InstancePortState) GoString() string {
return s.String()
}
// SetFromPort sets the FromPort field's value.
func (s *InstancePortState) SetFromPort(v int64) *InstancePortState {
s.FromPort = &v
return s
}
// SetProtocol sets the Protocol field's value.
func (s *InstancePortState) SetProtocol(v string) *InstancePortState {
s.Protocol = &v
return s
}
// SetState sets the State field's value.
func (s *InstancePortState) SetState(v string) *InstancePortState {
s.State = &v
return s
}
// SetToPort sets the ToPort field's value.
func (s *InstancePortState) SetToPort(v int64) *InstancePortState {
s.ToPort = &v
return s
}
// Describes the snapshot of the virtual private server, or instance.
// Please also see https://docs.aws.amazon.com/goto/WebAPI/lightsail-2016-11-28/InstanceSnapshot
type InstanceSnapshot struct {
@ -9203,6 +9590,83 @@ func (s *PortInfo) SetToPort(v int64) *PortInfo {
return s
}
// Please also see https://docs.aws.amazon.com/goto/WebAPI/lightsail-2016-11-28/PutInstancePublicPortsRequest
type PutInstancePublicPortsInput struct {
_ struct{} `type:"structure"`
// The Lightsail instance name of the public port(s) you are setting.
//
// InstanceName is a required field
InstanceName *string `locationName:"instanceName" type:"string" required:"true"`
// Specifies information about the public port(s).
//
// PortInfos is a required field
PortInfos []*PortInfo `locationName:"portInfos" type:"list" required:"true"`
}
// String returns the string representation
func (s PutInstancePublicPortsInput) String() string {
return awsutil.Prettify(s)
}
// GoString returns the string representation
func (s PutInstancePublicPortsInput) GoString() string {
return s.String()
}
// Validate inspects the fields of the type to determine if they are valid.
func (s *PutInstancePublicPortsInput) Validate() error {
invalidParams := request.ErrInvalidParams{Context: "PutInstancePublicPortsInput"}
if s.InstanceName == nil {
invalidParams.Add(request.NewErrParamRequired("InstanceName"))
}
if s.PortInfos == nil {
invalidParams.Add(request.NewErrParamRequired("PortInfos"))
}
if invalidParams.Len() > 0 {
return invalidParams
}
return nil
}
// SetInstanceName sets the InstanceName field's value.
func (s *PutInstancePublicPortsInput) SetInstanceName(v string) *PutInstancePublicPortsInput {
s.InstanceName = &v
return s
}
// SetPortInfos sets the PortInfos field's value.
func (s *PutInstancePublicPortsInput) SetPortInfos(v []*PortInfo) *PutInstancePublicPortsInput {
s.PortInfos = v
return s
}
// Please also see https://docs.aws.amazon.com/goto/WebAPI/lightsail-2016-11-28/PutInstancePublicPortsResult
type PutInstancePublicPortsOutput struct {
_ struct{} `type:"structure"`
// Describes metadata about the operation you just executed.
Operation *Operation `locationName:"operation" type:"structure"`
}
// String returns the string representation
func (s PutInstancePublicPortsOutput) String() string {
return awsutil.Prettify(s)
}
// GoString returns the string representation
func (s PutInstancePublicPortsOutput) GoString() string {
return s.String()
}
// SetOperation sets the Operation field's value.
func (s *PutInstancePublicPortsOutput) SetOperation(v *Operation) *PutInstancePublicPortsOutput {
s.Operation = v
return s
}
// Please also see https://docs.aws.amazon.com/goto/WebAPI/lightsail-2016-11-28/RebootInstanceRequest
type RebootInstanceInput struct {
_ struct{} `type:"structure"`
@ -9271,7 +9735,7 @@ func (s *RebootInstanceOutput) SetOperations(v []*Operation) *RebootInstanceOutp
type Region struct {
_ struct{} `type:"structure"`
// The Availability Zones.
// The Availability Zones. Follows the format us-east-1a (case-sensitive).
AvailabilityZones []*AvailabilityZone `locationName:"availabilityZones" type:"list"`
// The continent code (e.g., NA, meaning North America).
@ -9396,7 +9860,7 @@ func (s *ReleaseStaticIpOutput) SetOperations(v []*Operation) *ReleaseStaticIpOu
type ResourceLocation struct {
_ struct{} `type:"structure"`
// The Availability Zone.
// The Availability Zone. Follows the format us-east-1a (case-sensitive).
AvailabilityZone *string `locationName:"availabilityZone" type:"string"`
// The AWS Region name.
@ -9965,6 +10429,9 @@ const (
// OperationTypeOpenInstancePublicPorts is a OperationType enum value
OperationTypeOpenInstancePublicPorts = "OpenInstancePublicPorts"
// OperationTypePutInstancePublicPorts is a OperationType enum value
OperationTypePutInstancePublicPorts = "PutInstancePublicPorts"
// OperationTypeCloseInstancePublicPorts is a OperationType enum value
OperationTypeCloseInstancePublicPorts = "CloseInstancePublicPorts"

4
vendor/github.com/aws/aws-sdk-go/service/lightsail/doc.go generated vendored
View File

@ -11,11 +11,11 @@
// the API or command-line interface (CLI).
//
// For more information about Lightsail concepts and tasks, see the Lightsail
// Dev Guide (http://lightsail.aws.amazon.com/ls/docs).
// Dev Guide (https://lightsail.aws.amazon.com/ls/docs/all).
//
// To use the Lightsail API or the CLI, you will need to use AWS Identity and
// Access Management (IAM) to generate access keys. For details about how to
// set this up, see the Lightsail Dev Guide (http://lightsail.aws.amazon.com/ls/docs/how-to/articles/lightsail-how-to-set-up-access-keys-to-use-sdk-api-cli).
// set this up, see the Lightsail Dev Guide (http://lightsail.aws.amazon.com/ls/docs/how-to/article/lightsail-how-to-set-up-access-keys-to-use-sdk-api-cli).
//
// See https://docs.aws.amazon.com/goto/WebAPI/lightsail-2016-11-28 for more information on this service.
//

4
vendor/github.com/aws/aws-sdk-go/service/lightsail/errors.go generated vendored
View File

@ -23,6 +23,10 @@ const (
//
// Lightsail throws this exception when user input does not conform to the validation
// rules of an input field.
//
// Domain-related APIs are only available in the N. Virginia (us-east-1) Region.
// Please set your Region configuration to us-east-1 to create, view, or edit
// these resources.
ErrCodeInvalidInputException = "InvalidInputException"
// ErrCodeNotFoundException for service response error code

29
vendor/github.com/aws/aws-sdk-go/service/lightsail/examples_test.go generated vendored
View File

@ -933,6 +933,35 @@ func ExampleLightsail_PeerVpc() {
fmt.Println(resp)
}
func ExampleLightsail_PutInstancePublicPorts() {
sess := session.Must(session.NewSession())
svc := lightsail.New(sess)
params := &lightsail.PutInstancePublicPortsInput{
InstanceName: aws.String("ResourceName"), // Required
PortInfos: []*lightsail.PortInfo{ // Required
{ // Required
FromPort: aws.Int64(1),
Protocol: aws.String("NetworkProtocol"),
ToPort: aws.Int64(1),
},
// More values...
},
}
resp, err := svc.PutInstancePublicPorts(params)
if err != nil {
// Print the error, cast err to awserr.Error to get the Code and
// Message from an error.
fmt.Println(err.Error())
return
}
// Pretty-print the response data.
fmt.Println(resp)
}
func ExampleLightsail_RebootInstance() {
sess := session.Must(session.NewSession())

4
vendor/github.com/aws/aws-sdk-go/service/lightsail/lightsailiface/interface.go generated vendored
View File

@ -224,6 +224,10 @@ type LightsailAPI interface {
PeerVpcWithContext(aws.Context, *lightsail.PeerVpcInput, ...request.Option) (*lightsail.PeerVpcOutput, error)
PeerVpcRequest(*lightsail.PeerVpcInput) (*request.Request, *lightsail.PeerVpcOutput)
PutInstancePublicPorts(*lightsail.PutInstancePublicPortsInput) (*lightsail.PutInstancePublicPortsOutput, error)
PutInstancePublicPortsWithContext(aws.Context, *lightsail.PutInstancePublicPortsInput, ...request.Option) (*lightsail.PutInstancePublicPortsOutput, error)
PutInstancePublicPortsRequest(*lightsail.PutInstancePublicPortsInput) (*request.Request, *lightsail.PutInstancePublicPortsOutput)
RebootInstance(*lightsail.RebootInstanceInput) (*lightsail.RebootInstanceOutput, error)
RebootInstanceWithContext(aws.Context, *lightsail.RebootInstanceInput, ...request.Option) (*lightsail.RebootInstanceOutput, error)
RebootInstanceRequest(*lightsail.RebootInstanceInput) (*request.Request, *lightsail.RebootInstanceOutput)

3
vendor/github.com/aws/aws-sdk-go/service/polly/api.go generated vendored
View File

@ -1558,4 +1558,7 @@ const (
// VoiceIdFiliz is a VoiceId enum value
VoiceIdFiliz = "Filiz"
// VoiceIdVicki is a VoiceId enum value
VoiceIdVicki = "Vicki"
)

Some files were not shown because too many files have changed in this diff Show More