From 730f07d673764cdc45b0fb060ad7930e504fb2a6 Mon Sep 17 00:00:00 2001 From: aws-sdk-go-automation <43143561+aws-sdk-go-automation@users.noreply.github.com> Date: Tue, 15 Aug 2023 14:27:39 -0400 Subject: [PATCH] Release v1.44.324 (2023-08-15) (#4954) Release v1.44.324 (2023-08-15) === ### Service Client Updates * `service/chime-sdk-meetings`: Updates service API * `service/ec2`: Updates service documentation * Documentation updates for Elastic Compute Cloud (EC2). * `service/glue`: Updates service API and documentation * AWS Glue Crawlers can now accept SerDe overrides from a custom csv classifier. The two SerDe options are LazySimpleSerDe and OpenCSVSerDe. In case, the user wants crawler to do the selection, "None" can be selected for this purpose. * `service/pi`: Updates service API, documentation, and paginators * `service/route53domains`: Updates service API and documentation * Provide explanation if CheckDomainTransferability return false. Provide requestId if a request is already submitted. Add sensitive protection for customer information * `service/sagemaker`: Updates service API and documentation * SageMaker Inference Recommender now provides SupportedResponseMIMETypes from DescribeInferenceRecommendationsJob response --- CHANGELOG.md | 15 + aws/endpoints/defaults.go | 93 + aws/version.go | 2 +- .../chime-sdk-meetings/2021-07-15/api-2.json | 29 +- .../2021-07-15/endpoint-rule-set-1.json | 344 ++- models/apis/ec2/2016-11-15/docs-2.json | 16 +- models/apis/glue/2017-03-31/api-2.json | 17 +- models/apis/glue/2017-03-31/docs-2.json | 8 + models/apis/pi/2018-02-27/api-2.json | 427 +++- models/apis/pi/2018-02-27/docs-2.json | 304 ++- .../pi/2018-02-27/endpoint-rule-set-1.json | 344 ++- .../apis/pi/2018-02-27/endpoint-tests-1.json | 50 + models/apis/pi/2018-02-27/paginators-1.json | 5 + .../apis/route53domains/2014-05-15/api-2.json | 38 +- .../route53domains/2014-05-15/docs-2.json | 25 +- .../2014-05-15/endpoint-rule-set-1.json | 344 ++- models/apis/sagemaker/2017-07-24/api-2.json | 12 +- models/apis/sagemaker/2017-07-24/docs-2.json | 16 +- models/endpoints/endpoints.json | 85 +- service/chimesdkmeetings/api.go | 76 + service/ec2/api.go | 151 +- service/glue/api.go | 56 + service/pi/api.go | 2203 ++++++++++++++++- service/pi/piiface/interface.go | 35 +- service/route53domains/api.go | 120 +- service/sagemaker/api.go | 16 +- 26 files changed, 4105 insertions(+), 726 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 06a00920052..914cd16be4e 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,3 +1,18 @@ +Release v1.44.324 (2023-08-15) +=== + +### Service Client Updates +* `service/chime-sdk-meetings`: Updates service API +* `service/ec2`: Updates service documentation + * Documentation updates for Elastic Compute Cloud (EC2). +* `service/glue`: Updates service API and documentation + * AWS Glue Crawlers can now accept SerDe overrides from a custom csv classifier. The two SerDe options are LazySimpleSerDe and OpenCSVSerDe. In case, the user wants crawler to do the selection, "None" can be selected for this purpose. +* `service/pi`: Updates service API, documentation, and paginators +* `service/route53domains`: Updates service API and documentation + * Provide explanation if CheckDomainTransferability return false. Provide requestId if a request is already submitted. Add sensitive protection for customer information +* `service/sagemaker`: Updates service API and documentation + * SageMaker Inference Recommender now provides SupportedResponseMIMETypes from DescribeInferenceRecommendationsJob response + Release v1.44.323 (2023-08-14) === diff --git a/aws/endpoints/defaults.go b/aws/endpoints/defaults.go index d7ca9fbf543..03f3f27089f 100644 --- a/aws/endpoints/defaults.go +++ b/aws/endpoints/defaults.go @@ -1853,6 +1853,9 @@ var awsPartition = partition{ endpointKey{ Region: "ap-south-1", }: endpoint{}, + endpointKey{ + Region: "eu-central-1", + }: endpoint{}, endpointKey{ Region: "us-east-1", }: endpoint{}, @@ -14055,6 +14058,42 @@ var awsPartition = partition{ endpointKey{ Region: "eu-west-3", }: endpoint{}, + endpointKey{ + Region: "fips-us-east-1", + }: endpoint{ + Hostname: "inspector2-fips.us-east-1.amazonaws.com", + CredentialScope: credentialScope{ + Region: "us-east-1", + }, + Deprecated: boxedTrue, + }, + endpointKey{ + Region: "fips-us-east-2", + }: endpoint{ + Hostname: "inspector2-fips.us-east-2.amazonaws.com", + CredentialScope: credentialScope{ + Region: "us-east-2", + }, + Deprecated: boxedTrue, + }, + endpointKey{ + Region: "fips-us-west-1", + }: endpoint{ + Hostname: "inspector2-fips.us-west-1.amazonaws.com", + CredentialScope: credentialScope{ + Region: "us-west-1", + }, + Deprecated: boxedTrue, + }, + endpointKey{ + Region: "fips-us-west-2", + }: endpoint{ + Hostname: "inspector2-fips.us-west-2.amazonaws.com", + CredentialScope: credentialScope{ + Region: "us-west-2", + }, + Deprecated: boxedTrue, + }, endpointKey{ Region: "me-south-1", }: endpoint{}, @@ -14064,15 +14103,39 @@ var awsPartition = partition{ endpointKey{ Region: "us-east-1", }: endpoint{}, + endpointKey{ + Region: "us-east-1", + Variant: fipsVariant, + }: endpoint{ + Hostname: "inspector2-fips.us-east-1.amazonaws.com", + }, endpointKey{ Region: "us-east-2", }: endpoint{}, + endpointKey{ + Region: "us-east-2", + Variant: fipsVariant, + }: endpoint{ + Hostname: "inspector2-fips.us-east-2.amazonaws.com", + }, endpointKey{ Region: "us-west-1", }: endpoint{}, + endpointKey{ + Region: "us-west-1", + Variant: fipsVariant, + }: endpoint{ + Hostname: "inspector2-fips.us-west-1.amazonaws.com", + }, endpointKey{ Region: "us-west-2", }: endpoint{}, + endpointKey{ + Region: "us-west-2", + Variant: fipsVariant, + }: endpoint{ + Hostname: "inspector2-fips.us-west-2.amazonaws.com", + }, }, }, "internetmonitor": service{ @@ -36454,12 +36517,42 @@ var awsusgovPartition = partition{ }, "inspector2": service{ Endpoints: serviceEndpoints{ + endpointKey{ + Region: "fips-us-gov-east-1", + }: endpoint{ + Hostname: "inspector2-fips.us-gov-east-1.amazonaws.com", + CredentialScope: credentialScope{ + Region: "us-gov-east-1", + }, + Deprecated: boxedTrue, + }, + endpointKey{ + Region: "fips-us-gov-west-1", + }: endpoint{ + Hostname: "inspector2-fips.us-gov-west-1.amazonaws.com", + CredentialScope: credentialScope{ + Region: "us-gov-west-1", + }, + Deprecated: boxedTrue, + }, endpointKey{ Region: "us-gov-east-1", }: endpoint{}, + endpointKey{ + Region: "us-gov-east-1", + Variant: fipsVariant, + }: endpoint{ + Hostname: "inspector2-fips.us-gov-east-1.amazonaws.com", + }, endpointKey{ Region: "us-gov-west-1", }: endpoint{}, + endpointKey{ + Region: "us-gov-west-1", + Variant: fipsVariant, + }: endpoint{ + Hostname: "inspector2-fips.us-gov-west-1.amazonaws.com", + }, }, }, "internetmonitor": service{ diff --git a/aws/version.go b/aws/version.go index a0203e75803..c2668df7a8a 100644 --- a/aws/version.go +++ b/aws/version.go @@ -5,4 +5,4 @@ package aws const SDKName = "aws-sdk-go" // SDKVersion is the version of this SDK -const SDKVersion = "1.44.323" +const SDKVersion = "1.44.324" diff --git a/models/apis/chime-sdk-meetings/2021-07-15/api-2.json b/models/apis/chime-sdk-meetings/2021-07-15/api-2.json index e003ea2c8e5..0486b1a5bd5 100644 --- a/models/apis/chime-sdk-meetings/2021-07-15/api-2.json +++ b/models/apis/chime-sdk-meetings/2021-07-15/api-2.json @@ -45,7 +45,9 @@ {"shape":"UnauthorizedException"}, {"shape":"NotFoundException"}, {"shape":"ForbiddenException"}, - {"shape":"ServiceUnavailableException"} + {"shape":"ServiceUnavailableException"}, + {"shape":"ServiceFailureException"}, + {"shape":"ThrottlingException"} ] }, "CreateAttendee":{ @@ -78,6 +80,7 @@ "output":{"shape":"CreateMeetingResponse"}, "errors":[ {"shape":"BadRequestException"}, + {"shape":"ConflictException"}, {"shape":"ForbiddenException"}, {"shape":"UnauthorizedException"}, {"shape":"ThrottlingException"}, @@ -96,6 +99,7 @@ "output":{"shape":"CreateMeetingWithAttendeesResponse"}, "errors":[ {"shape":"BadRequestException"}, + {"shape":"ConflictException"}, {"shape":"ForbiddenException"}, {"shape":"UnauthorizedException"}, {"shape":"ThrottlingException"}, @@ -205,6 +209,13 @@ "input":{"shape":"ListTagsForResourceRequest"}, "output":{"shape":"ListTagsForResourceResponse"}, "errors":[ + {"shape":"BadRequestException"}, + {"shape":"ForbiddenException"}, + {"shape":"UnauthorizedException"}, + {"shape":"LimitExceededException"}, + {"shape":"ServiceUnavailableException"}, + {"shape":"ServiceFailureException"}, + {"shape":"ThrottlingException"}, {"shape":"ResourceNotFoundException"} ] }, @@ -258,6 +269,12 @@ "output":{"shape":"TagResourceResponse"}, "errors":[ {"shape":"BadRequestException"}, + {"shape":"ForbiddenException"}, + {"shape":"UnauthorizedException"}, + {"shape":"LimitExceededException"}, + {"shape":"ServiceUnavailableException"}, + {"shape":"ServiceFailureException"}, + {"shape":"ThrottlingException"}, {"shape":"ResourceNotFoundException"}, {"shape":"TooManyTagsException"} ] @@ -273,6 +290,12 @@ "output":{"shape":"UntagResourceResponse"}, "errors":[ {"shape":"BadRequestException"}, + {"shape":"ForbiddenException"}, + {"shape":"UnauthorizedException"}, + {"shape":"LimitExceededException"}, + {"shape":"ServiceUnavailableException"}, + {"shape":"ServiceFailureException"}, + {"shape":"ThrottlingException"}, {"shape":"ResourceNotFoundException"} ] }, @@ -290,7 +313,9 @@ {"shape":"UnauthorizedException"}, {"shape":"NotFoundException"}, {"shape":"ForbiddenException"}, - {"shape":"ServiceUnavailableException"} + {"shape":"ServiceUnavailableException"}, + {"shape":"ServiceFailureException"}, + {"shape":"ThrottlingException"} ] } }, diff --git a/models/apis/chime-sdk-meetings/2021-07-15/endpoint-rule-set-1.json b/models/apis/chime-sdk-meetings/2021-07-15/endpoint-rule-set-1.json index ba8bb30e19c..b1a80964628 100644 --- a/models/apis/chime-sdk-meetings/2021-07-15/endpoint-rule-set-1.json +++ b/models/apis/chime-sdk-meetings/2021-07-15/endpoint-rule-set-1.json @@ -58,52 +58,56 @@ "type": "error" }, { - "conditions": [], - "type": "tree", - "rules": [ + "conditions": [ { - "conditions": [ + "fn": "booleanEquals", + "argv": [ { - "fn": "booleanEquals", - "argv": [ - { - "ref": "UseDualStack" - }, - true - ] - } - ], - "error": "Invalid Configuration: Dualstack and custom endpoint are not supported", - "type": "error" - }, - { - "conditions": [], - "endpoint": { - "url": { - "ref": "Endpoint" + "ref": "UseDualStack" }, - "properties": {}, - "headers": {} - }, - "type": "endpoint" + true + ] } - ] + ], + "error": "Invalid Configuration: Dualstack and custom endpoint are not supported", + "type": "error" + }, + { + "conditions": [], + "endpoint": { + "url": { + "ref": "Endpoint" + }, + "properties": {}, + "headers": {} + }, + "type": "endpoint" } ] }, { - "conditions": [], + "conditions": [ + { + "fn": "isSet", + "argv": [ + { + "ref": "Region" + } + ] + } + ], "type": "tree", "rules": [ { "conditions": [ { - "fn": "isSet", + "fn": "aws.partition", "argv": [ { "ref": "Region" } - ] + ], + "assign": "PartitionResult" } ], "type": "tree", @@ -111,13 +115,22 @@ { "conditions": [ { - "fn": "aws.partition", + "fn": "booleanEquals", "argv": [ { - "ref": "Region" - } - ], - "assign": "PartitionResult" + "ref": "UseFIPS" + }, + true + ] + }, + { + "fn": "booleanEquals", + "argv": [ + { + "ref": "UseDualStack" + }, + true + ] } ], "type": "tree", @@ -127,224 +140,175 @@ { "fn": "booleanEquals", "argv": [ + true, { - "ref": "UseFIPS" - }, - true + "fn": "getAttr", + "argv": [ + { + "ref": "PartitionResult" + }, + "supportsFIPS" + ] + } ] }, { "fn": "booleanEquals", "argv": [ + true, { - "ref": "UseDualStack" - }, - true - ] - } - ], - "type": "tree", - "rules": [ - { - "conditions": [ - { - "fn": "booleanEquals", - "argv": [ - true, - { - "fn": "getAttr", - "argv": [ - { - "ref": "PartitionResult" - }, - "supportsFIPS" - ] - } - ] - }, - { - "fn": "booleanEquals", + "fn": "getAttr", "argv": [ - true, { - "fn": "getAttr", - "argv": [ - { - "ref": "PartitionResult" - }, - "supportsDualStack" - ] - } - ] - } - ], - "type": "tree", - "rules": [ - { - "conditions": [], - "type": "tree", - "rules": [ - { - "conditions": [], - "endpoint": { - "url": "https://meetings-chime-fips.{Region}.{PartitionResult#dualStackDnsSuffix}", - "properties": {}, - "headers": {} - }, - "type": "endpoint" - } + "ref": "PartitionResult" + }, + "supportsDualStack" ] } ] - }, + } + ], + "type": "tree", + "rules": [ { "conditions": [], - "error": "FIPS and DualStack are enabled, but this partition does not support one or both", - "type": "error" + "endpoint": { + "url": "https://meetings-chime-fips.{Region}.{PartitionResult#dualStackDnsSuffix}", + "properties": {}, + "headers": {} + }, + "type": "endpoint" } ] }, + { + "conditions": [], + "error": "FIPS and DualStack are enabled, but this partition does not support one or both", + "type": "error" + } + ] + }, + { + "conditions": [ + { + "fn": "booleanEquals", + "argv": [ + { + "ref": "UseFIPS" + }, + true + ] + } + ], + "type": "tree", + "rules": [ { "conditions": [ { "fn": "booleanEquals", "argv": [ + true, { - "ref": "UseFIPS" - }, - true - ] - } - ], - "type": "tree", - "rules": [ - { - "conditions": [ - { - "fn": "booleanEquals", + "fn": "getAttr", "argv": [ - true, - { - "fn": "getAttr", - "argv": [ - { - "ref": "PartitionResult" - }, - "supportsFIPS" - ] - } - ] - } - ], - "type": "tree", - "rules": [ - { - "conditions": [], - "type": "tree", - "rules": [ { - "conditions": [], - "endpoint": { - "url": "https://meetings-chime-fips.{Region}.{PartitionResult#dnsSuffix}", - "properties": {}, - "headers": {} - }, - "type": "endpoint" - } + "ref": "PartitionResult" + }, + "supportsFIPS" ] } ] - }, + } + ], + "type": "tree", + "rules": [ { "conditions": [], - "error": "FIPS is enabled but this partition does not support FIPS", - "type": "error" + "endpoint": { + "url": "https://meetings-chime-fips.{Region}.{PartitionResult#dnsSuffix}", + "properties": {}, + "headers": {} + }, + "type": "endpoint" } ] }, + { + "conditions": [], + "error": "FIPS is enabled but this partition does not support FIPS", + "type": "error" + } + ] + }, + { + "conditions": [ + { + "fn": "booleanEquals", + "argv": [ + { + "ref": "UseDualStack" + }, + true + ] + } + ], + "type": "tree", + "rules": [ { "conditions": [ { "fn": "booleanEquals", "argv": [ + true, { - "ref": "UseDualStack" - }, - true - ] - } - ], - "type": "tree", - "rules": [ - { - "conditions": [ - { - "fn": "booleanEquals", + "fn": "getAttr", "argv": [ - true, { - "fn": "getAttr", - "argv": [ - { - "ref": "PartitionResult" - }, - "supportsDualStack" - ] - } - ] - } - ], - "type": "tree", - "rules": [ - { - "conditions": [], - "type": "tree", - "rules": [ - { - "conditions": [], - "endpoint": { - "url": "https://meetings-chime.{Region}.{PartitionResult#dualStackDnsSuffix}", - "properties": {}, - "headers": {} - }, - "type": "endpoint" - } + "ref": "PartitionResult" + }, + "supportsDualStack" ] } ] - }, - { - "conditions": [], - "error": "DualStack is enabled but this partition does not support DualStack", - "type": "error" } - ] - }, - { - "conditions": [], + ], "type": "tree", "rules": [ { "conditions": [], "endpoint": { - "url": "https://meetings-chime.{Region}.{PartitionResult#dnsSuffix}", + "url": "https://meetings-chime.{Region}.{PartitionResult#dualStackDnsSuffix}", "properties": {}, "headers": {} }, "type": "endpoint" } ] + }, + { + "conditions": [], + "error": "DualStack is enabled but this partition does not support DualStack", + "type": "error" } ] + }, + { + "conditions": [], + "endpoint": { + "url": "https://meetings-chime.{Region}.{PartitionResult#dnsSuffix}", + "properties": {}, + "headers": {} + }, + "type": "endpoint" } ] - }, - { - "conditions": [], - "error": "Invalid Configuration: Missing Region", - "type": "error" } ] + }, + { + "conditions": [], + "error": "Invalid Configuration: Missing Region", + "type": "error" } ] } \ No newline at end of file diff --git a/models/apis/ec2/2016-11-15/docs-2.json b/models/apis/ec2/2016-11-15/docs-2.json index 4542d7f9702..a2740897db5 100755 --- a/models/apis/ec2/2016-11-15/docs-2.json +++ b/models/apis/ec2/2016-11-15/docs-2.json @@ -108,7 +108,7 @@ "CreateSpotDatafeedSubscription": "
Creates a data feed for Spot Instances, enabling you to view Spot Instance usage logs. You can create one data feed per Amazon Web Services account. For more information, see Spot Instance data feed in the Amazon EC2 User Guide for Linux Instances.
", "CreateStoreImageTask": "Stores an AMI as a single object in an Amazon S3 bucket.
To use this API, you must have the required permissions. For more information, see Permissions for storing and restoring AMIs using Amazon S3 in the Amazon EC2 User Guide.
For more information, see Store and restore an AMI using Amazon S3 in the Amazon EC2 User Guide.
", "CreateSubnet": "Creates a subnet in the specified VPC. For an IPv4 only subnet, specify an IPv4 CIDR block. If the VPC has an IPv6 CIDR block, you can create an IPv6 only subnet or a dual stack subnet instead. For an IPv6 only subnet, specify an IPv6 CIDR block. For a dual stack subnet, specify both an IPv4 CIDR block and an IPv6 CIDR block.
A subnet CIDR block must not overlap the CIDR block of an existing subnet in the VPC. After you create a subnet, you can't change its CIDR block.
The allowed size for an IPv4 subnet is between a /28 netmask (16 IP addresses) and a /16 netmask (65,536 IP addresses). Amazon Web Services reserves both the first four and the last IPv4 address in each subnet's CIDR block. They're not available for your use.
If you've associated an IPv6 CIDR block with your VPC, you can associate an IPv6 CIDR block with a subnet when you create it. The allowed block size for an IPv6 subnet is a /64 netmask.
If you add more than one subnet to a VPC, they're set up in a star topology with a logical router in the middle.
When you stop an instance in a subnet, it retains its private IPv4 address. It's therefore possible to have a subnet with no running instances (they're all stopped), but no remaining IP addresses available.
For more information, see Subnets in the Amazon VPC User Guide.
", - "CreateSubnetCidrReservation": "Creates a subnet CIDR reservation. For information about subnet CIDR reservations, see Subnet CIDR reservations in the Amazon Virtual Private Cloud User Guide.
", + "CreateSubnetCidrReservation": "Creates a subnet CIDR reservation. For more information, see Subnet CIDR reservations in the Amazon Virtual Private Cloud User Guide and Assign prefixes to network interfaces in the Amazon Elastic Compute Cloud User Guide.
", "CreateTags": "Adds or overwrites only the specified tags for the specified Amazon EC2 resource or resources. When you specify an existing tag key, the value is overwritten with the new value. Each resource can have a maximum of 50 tags. Each tag consists of a key and optional value. Tag keys must be unique per resource.
For more information about tags, see Tag your Amazon EC2 resources in the Amazon Elastic Compute Cloud User Guide. For more information about creating IAM policies that control users' access to resources based on tags, see Supported resource-level permissions for Amazon EC2 API actions in the Amazon Elastic Compute Cloud User Guide.
", "CreateTrafficMirrorFilter": "Creates a Traffic Mirror filter.
A Traffic Mirror filter is a set of rules that defines the traffic to mirror.
By default, no traffic is mirrored. To mirror traffic, use CreateTrafficMirrorFilterRule to add Traffic Mirror rules to the filter. The rules you add define what traffic gets mirrored. You can also use ModifyTrafficMirrorFilterNetworkServices to mirror supported network services.
", "CreateTrafficMirrorFilterRule": "Creates a Traffic Mirror filter rule.
A Traffic Mirror rule defines the Traffic Mirror source traffic to mirror.
You need the Traffic Mirror filter ID when you create the rule.
", @@ -158,7 +158,7 @@ "DeleteIpamScope": "Delete the scope for an IPAM. You cannot delete the default scopes.
For more information, see Delete a scope in the Amazon VPC IPAM User Guide.
", "DeleteKeyPair": "Deletes the specified key pair, by removing the public key from Amazon EC2.
", "DeleteLaunchTemplate": "Deletes a launch template. Deleting a launch template deletes all of its versions.
", - "DeleteLaunchTemplateVersions": "Deletes one or more versions of a launch template. You cannot delete the default version of a launch template; you must first assign a different version as the default. If the default version is the only version for the launch template, you must delete the entire launch template using DeleteLaunchTemplate.
", + "DeleteLaunchTemplateVersions": "Deletes one or more versions of a launch template.
You can't delete the default version of a launch template; you must first assign a different version as the default. If the default version is the only version for the launch template, you must delete the entire launch template using DeleteLaunchTemplate.
You can delete up to 200 launch template versions in a single request. To delete more than 200 versions in a single request, use DeleteLaunchTemplate, which deletes the launch template and all of its versions.
For more information, see Delete a launch template version in the EC2 User Guide.
", "DeleteLocalGatewayRoute": "Deletes the specified route from the specified local gateway route table.
", "DeleteLocalGatewayRouteTable": "Deletes a local gateway route table.
", "DeleteLocalGatewayRouteTableVirtualInterfaceGroupAssociation": "Deletes a local gateway route table virtual interface group association.
", @@ -9065,7 +9065,7 @@ "DescribeInstanceStatusRequest$Filters": "The filters.
availability-zone
- The Availability Zone of the instance.
event.code
- The code for the scheduled event (instance-reboot
| system-reboot
| system-maintenance
| instance-retirement
| instance-stop
).
event.description
- A description of the event.
event.instance-event-id
- The ID of the event whose date and time you are modifying.
event.not-after
- The latest end time for the scheduled event (for example, 2014-09-15T17:15:20.000Z
).
event.not-before
- The earliest start time for the scheduled event (for example, 2014-09-15T17:15:20.000Z
).
event.not-before-deadline
- The deadline for starting the event (for example, 2014-09-15T17:15:20.000Z
).
instance-state-code
- The code for the instance state, as a 16-bit unsigned integer. The high byte is used for internal purposes and should be ignored. The low byte is set based on the state represented. The valid values are 0 (pending), 16 (running), 32 (shutting-down), 48 (terminated), 64 (stopping), and 80 (stopped).
instance-state-name
- The state of the instance (pending
| running
| shutting-down
| terminated
| stopping
| stopped
).
instance-status.reachability
- Filters on instance status where the name is reachability
(passed
| failed
| initializing
| insufficient-data
).
instance-status.status
- The status of the instance (ok
| impaired
| initializing
| insufficient-data
| not-applicable
).
system-status.reachability
- Filters on system status where the name is reachability
(passed
| failed
| initializing
| insufficient-data
).
system-status.status
- The system status of the instance (ok
| impaired
| initializing
| insufficient-data
| not-applicable
).
One or more filters. Filter names and values are case-sensitive.
location
- This depends on the location type. For example, if the location type is region
(default), the location is the Region code (for example, us-east-2
.)
instance-type
- The instance type. For example, c5.2xlarge
.
One or more filters. Filter names and values are case-sensitive.
auto-recovery-supported
- Indicates whether Amazon CloudWatch action based recovery is supported (true
| false
).
bare-metal
- Indicates whether it is a bare metal instance type (true
| false
).
burstable-performance-supported
- Indicates whether the instance type is a burstable performance T instance type (true
| false
).
current-generation
- Indicates whether this instance type is the latest generation instance type of an instance family (true
| false
).
ebs-info.ebs-optimized-info.baseline-bandwidth-in-mbps
- The baseline bandwidth performance for an EBS-optimized instance type, in Mbps.
ebs-info.ebs-optimized-info.baseline-iops
- The baseline input/output storage operations per second for an EBS-optimized instance type.
ebs-info.ebs-optimized-info.baseline-throughput-in-mbps
- The baseline throughput performance for an EBS-optimized instance type, in MB/s.
ebs-info.ebs-optimized-info.maximum-bandwidth-in-mbps
- The maximum bandwidth performance for an EBS-optimized instance type, in Mbps.
ebs-info.ebs-optimized-info.maximum-iops
- The maximum input/output storage operations per second for an EBS-optimized instance type.
ebs-info.ebs-optimized-info.maximum-throughput-in-mbps
- The maximum throughput performance for an EBS-optimized instance type, in MB/s.
ebs-info.ebs-optimized-support
- Indicates whether the instance type is EBS-optimized (supported
| unsupported
| default
).
ebs-info.encryption-support
- Indicates whether EBS encryption is supported (supported
| unsupported
).
ebs-info.nvme-support
- Indicates whether non-volatile memory express (NVMe) is supported for EBS volumes (required
| supported
| unsupported
).
free-tier-eligible
- Indicates whether the instance type is eligible to use in the free tier (true
| false
).
hibernation-supported
- Indicates whether On-Demand hibernation is supported (true
| false
).
hypervisor
- The hypervisor (nitro
| xen
).
instance-storage-info.disk.count
- The number of local disks.
instance-storage-info.disk.size-in-gb
- The storage size of each instance storage disk, in GB.
instance-storage-info.disk.type
- The storage technology for the local instance storage disks (hdd
| ssd
).
instance-storage-info.encryption-support
- Indicates whether data is encrypted at rest (required
| supported
| unsupported
).
instance-storage-info.nvme-support
- Indicates whether non-volatile memory express (NVMe) is supported for instance store (required
| supported
| unsupported
).
instance-storage-info.total-size-in-gb
- The total amount of storage available from all local instance storage, in GB.
instance-storage-supported
- Indicates whether the instance type has local instance storage (true
| false
).
instance-type
- The instance type (for example c5.2xlarge
or c5*).
memory-info.size-in-mib
- The memory size.
network-info.efa-info.maximum-efa-interfaces
- The maximum number of Elastic Fabric Adapters (EFAs) per instance.
network-info.efa-supported
- Indicates whether the instance type supports Elastic Fabric Adapter (EFA) (true
| false
).
network-info.ena-support
- Indicates whether Elastic Network Adapter (ENA) is supported or required (required
| supported
| unsupported
).
network-info.encryption-in-transit-supported
- Indicates whether the instance type automatically encrypts in-transit traffic between instances (true
| false
).
network-info.ipv4-addresses-per-interface
- The maximum number of private IPv4 addresses per network interface.
network-info.ipv6-addresses-per-interface
- The maximum number of private IPv6 addresses per network interface.
network-info.ipv6-supported
- Indicates whether the instance type supports IPv6 (true
| false
).
network-info.maximum-network-cards
- The maximum number of network cards per instance.
network-info.maximum-network-interfaces
- The maximum number of network interfaces per instance.
network-info.network-performance
- The network performance (for example, \"25 Gigabit\").
nitro-enclaves-support
- Indicates whether Nitro Enclaves is supported (supported
| unsupported
).
nitro-tpm-support
- Indicates whether NitroTPM is supported (supported
| unsupported
).
nitro-tpm-info.supported-versions
- The supported NitroTPM version (2.0
).
processor-info.supported-architecture
- The CPU architecture (arm64
| i386
| x86_64
).
processor-info.sustained-clock-speed-in-ghz
- The CPU clock speed, in GHz.
processor-info.supported-features
- The supported CPU features (amd-sev-snp
).
supported-boot-mode
- The boot mode (legacy-bios
| uefi
).
supported-root-device-type
- The root device type (ebs
| instance-store
).
supported-usage-class
- The usage class (on-demand
| spot
).
supported-virtualization-type
- The virtualization type (hvm
| paravirtual
).
vcpu-info.default-cores
- The default number of cores for the instance type.
vcpu-info.default-threads-per-core
- The default number of threads per core for the instance type.
vcpu-info.default-vcpus
- The default number of vCPUs for the instance type.
vcpu-info.valid-cores
- The number of cores that can be configured for the instance type.
vcpu-info.valid-threads-per-core
- The number of threads per core that can be configured for the instance type. For example, \"1\" or \"1,2\".
The filters.
affinity
- The affinity setting for an instance running on a Dedicated Host (default
| host
).
architecture
- The instance architecture (i386
| x86_64
| arm64
).
availability-zone
- The Availability Zone of the instance.
block-device-mapping.attach-time
- The attach time for an EBS volume mapped to the instance, for example, 2010-09-15T17:15:20.000Z
.
block-device-mapping.delete-on-termination
- A Boolean that indicates whether the EBS volume is deleted on instance termination.
block-device-mapping.device-name
- The device name specified in the block device mapping (for example, /dev/sdh
or xvdh
).
block-device-mapping.status
- The status for the EBS volume (attaching
| attached
| detaching
| detached
).
block-device-mapping.volume-id
- The volume ID of the EBS volume.
capacity-reservation-id
- The ID of the Capacity Reservation into which the instance was launched.
client-token
- The idempotency token you provided when you launched the instance.
dns-name
- The public DNS name of the instance.
hibernation-options.configured
- A Boolean that indicates whether the instance is enabled for hibernation. A value of true
means that the instance is enabled for hibernation.
host-id
- The ID of the Dedicated Host on which the instance is running, if applicable.
hypervisor
- The hypervisor type of the instance (ovm
| xen
). The value xen
is used for both Xen and Nitro hypervisors.
iam-instance-profile.arn
- The instance profile associated with the instance. Specified as an ARN.
image-id
- The ID of the image used to launch the instance.
instance-id
- The ID of the instance.
instance-lifecycle
- Indicates whether this is a Spot Instance or a Scheduled Instance (spot
| scheduled
).
instance-state-code
- The state of the instance, as a 16-bit unsigned integer. The high byte is used for internal purposes and should be ignored. The low byte is set based on the state represented. The valid values are: 0 (pending), 16 (running), 32 (shutting-down), 48 (terminated), 64 (stopping), and 80 (stopped).
instance-state-name
- The state of the instance (pending
| running
| shutting-down
| terminated
| stopping
| stopped
).
instance-type
- The type of instance (for example, t2.micro
).
instance.group-id
- The ID of the security group for the instance.
instance.group-name
- The name of the security group for the instance.
ip-address
- The public IPv4 address of the instance.
kernel-id
- The kernel ID.
key-name
- The name of the key pair used when the instance was launched.
launch-index
- When launching multiple instances, this is the index for the instance in the launch group (for example, 0, 1, 2, and so on).
launch-time
- The time when the instance was launched, in the ISO 8601 format in the UTC time zone (YYYY-MM-DDThh:mm:ss.sssZ), for example, 2021-09-29T11:04:43.305Z
. You can use a wildcard (*
), for example, 2021-09-29T*
, which matches an entire day.
metadata-options.http-tokens
- The metadata request authorization state (optional
| required
)
metadata-options.http-put-response-hop-limit
- The HTTP metadata request put response hop limit (integer, possible values 1
to 64
)
metadata-options.http-endpoint
- The status of access to the HTTP metadata endpoint on your instance (enabled
| disabled
)
metadata-options.instance-metadata-tags
- The status of access to instance tags from the instance metadata (enabled
| disabled
)
monitoring-state
- Indicates whether detailed monitoring is enabled (disabled
| enabled
).
network-interface.addresses.private-ip-address
- The private IPv4 address associated with the network interface.
network-interface.addresses.primary
- Specifies whether the IPv4 address of the network interface is the primary private IPv4 address.
network-interface.addresses.association.public-ip
- The ID of the association of an Elastic IP address (IPv4) with a network interface.
network-interface.addresses.association.ip-owner-id
- The owner ID of the private IPv4 address associated with the network interface.
network-interface.association.public-ip
- The address of the Elastic IP address (IPv4) bound to the network interface.
network-interface.association.ip-owner-id
- The owner of the Elastic IP address (IPv4) associated with the network interface.
network-interface.association.allocation-id
- The allocation ID returned when you allocated the Elastic IP address (IPv4) for your network interface.
network-interface.association.association-id
- The association ID returned when the network interface was associated with an IPv4 address.
network-interface.attachment.attachment-id
- The ID of the interface attachment.
network-interface.attachment.instance-id
- The ID of the instance to which the network interface is attached.
network-interface.attachment.instance-owner-id
- The owner ID of the instance to which the network interface is attached.
network-interface.attachment.device-index
- The device index to which the network interface is attached.
network-interface.attachment.status
- The status of the attachment (attaching
| attached
| detaching
| detached
).
network-interface.attachment.attach-time
- The time that the network interface was attached to an instance.
network-interface.attachment.delete-on-termination
- Specifies whether the attachment is deleted when an instance is terminated.
network-interface.availability-zone
- The Availability Zone for the network interface.
network-interface.description
- The description of the network interface.
network-interface.group-id
- The ID of a security group associated with the network interface.
network-interface.group-name
- The name of a security group associated with the network interface.
network-interface.ipv6-addresses.ipv6-address
- The IPv6 address associated with the network interface.
network-interface.mac-address
- The MAC address of the network interface.
network-interface.network-interface-id
- The ID of the network interface.
network-interface.owner-id
- The ID of the owner of the network interface.
network-interface.private-dns-name
- The private DNS name of the network interface.
network-interface.requester-id
- The requester ID for the network interface.
network-interface.requester-managed
- Indicates whether the network interface is being managed by Amazon Web Services.
network-interface.status
- The status of the network interface (available
) | in-use
).
network-interface.source-dest-check
- Whether the network interface performs source/destination checking. A value of true
means that checking is enabled, and false
means that checking is disabled. The value must be false
for the network interface to perform network address translation (NAT) in your VPC.
network-interface.subnet-id
- The ID of the subnet for the network interface.
network-interface.vpc-id
- The ID of the VPC for the network interface.
outpost-arn
- The Amazon Resource Name (ARN) of the Outpost.
owner-id
- The Amazon Web Services account ID of the instance owner.
placement-group-name
- The name of the placement group for the instance.
placement-partition-number
- The partition in which the instance is located.
platform
- The platform. To list only Windows instances, use windows
.
private-dns-name
- The private IPv4 DNS name of the instance.
private-ip-address
- The private IPv4 address of the instance.
product-code
- The product code associated with the AMI used to launch the instance.
product-code.type
- The type of product code (devpay
| marketplace
).
ramdisk-id
- The RAM disk ID.
reason
- The reason for the current state of the instance (for example, shows \"User Initiated [date]\" when you stop or terminate the instance). Similar to the state-reason-code filter.
requester-id
- The ID of the entity that launched the instance on your behalf (for example, Amazon Web Services Management Console, Auto Scaling, and so on).
reservation-id
- The ID of the instance's reservation. A reservation ID is created any time you launch an instance. A reservation ID has a one-to-one relationship with an instance launch request, but can be associated with more than one instance if you launch multiple instances using the same launch request. For example, if you launch one instance, you get one reservation ID. If you launch ten instances using the same launch request, you also get one reservation ID.
root-device-name
- The device name of the root device volume (for example, /dev/sda1
).
root-device-type
- The type of the root device volume (ebs
| instance-store
).
source-dest-check
- Indicates whether the instance performs source/destination checking. A value of true
means that checking is enabled, and false
means that checking is disabled. The value must be false
for the instance to perform network address translation (NAT) in your VPC.
spot-instance-request-id
- The ID of the Spot Instance request.
state-reason-code
- The reason code for the state change.
state-reason-message
- A message that describes the state change.
subnet-id
- The ID of the subnet for the instance.
tag:<key>
- The key/value combination of a tag assigned to the resource. Use the tag key in the filter name and the tag value as the filter value. For example, to find all resources that have a tag with the key Owner
and the value TeamA
, specify tag:Owner
for the filter name and TeamA
for the filter value.
tag-key
- The key of a tag assigned to the resource. Use this filter to find all resources that have a tag with a specific key, regardless of the tag value.
tenancy
- The tenancy of an instance (dedicated
| default
| host
).
virtualization-type
- The virtualization type of the instance (paravirtual
| hvm
).
vpc-id
- The ID of the VPC that the instance is running in.
The filters.
affinity
- The affinity setting for an instance running on a Dedicated Host (default
| host
).
architecture
- The instance architecture (i386
| x86_64
| arm64
).
availability-zone
- The Availability Zone of the instance.
block-device-mapping.attach-time
- The attach time for an EBS volume mapped to the instance, for example, 2022-09-15T17:15:20.000Z
.
block-device-mapping.delete-on-termination
- A Boolean that indicates whether the EBS volume is deleted on instance termination.
block-device-mapping.device-name
- The device name specified in the block device mapping (for example, /dev/sdh
or xvdh
).
block-device-mapping.status
- The status for the EBS volume (attaching
| attached
| detaching
| detached
).
block-device-mapping.volume-id
- The volume ID of the EBS volume.
boot-mode
- The boot mode that was specified by the AMI (legacy-bios
| uefi
| uefi-preferred
).
capacity-reservation-id
- The ID of the Capacity Reservation into which the instance was launched.
capacity-reservation-specification.capacity-reservation-preference
- The instance's Capacity Reservation preference (open
| none
).
capacity-reservation-specification.capacity-reservation-target.capacity-reservation-id
- The ID of the targeted Capacity Reservation.
capacity-reservation-specification.capacity-reservation-target.capacity-reservation-resource-group-arn
- The ARN of the targeted Capacity Reservation group.
client-token
- The idempotency token you provided when you launched the instance.
current-instance-boot-mode
- The boot mode that is used to launch the instance at launch or start (legacy-bios
| uefi
).
dns-name
- The public DNS name of the instance.
ebs-optimized
- A Boolean that indicates whether the instance is optimized for Amazon EBS I/O.
ena-support
- A Boolean that indicates whether the instance is enabled for enhanced networking with ENA.
enclave-options.enabled
- A Boolean that indicates whether the instance is enabled for Amazon Web Services Nitro Enclaves.
hibernation-options.configured
- A Boolean that indicates whether the instance is enabled for hibernation. A value of true
means that the instance is enabled for hibernation.
host-id
- The ID of the Dedicated Host on which the instance is running, if applicable.
hypervisor
- The hypervisor type of the instance (ovm
| xen
). The value xen
is used for both Xen and Nitro hypervisors.
iam-instance-profile.arn
- The instance profile associated with the instance. Specified as an ARN.
iam-instance-profile.id
- The instance profile associated with the instance. Specified as an ID.
iam-instance-profile.name
- The instance profile associated with the instance. Specified as an name.
image-id
- The ID of the image used to launch the instance.
instance-id
- The ID of the instance.
instance-lifecycle
- Indicates whether this is a Spot Instance or a Scheduled Instance (spot
| scheduled
).
instance-state-code
- The state of the instance, as a 16-bit unsigned integer. The high byte is used for internal purposes and should be ignored. The low byte is set based on the state represented. The valid values are: 0 (pending), 16 (running), 32 (shutting-down), 48 (terminated), 64 (stopping), and 80 (stopped).
instance-state-name
- The state of the instance (pending
| running
| shutting-down
| terminated
| stopping
| stopped
).
instance-type
- The type of instance (for example, t2.micro
).
instance.group-id
- The ID of the security group for the instance.
instance.group-name
- The name of the security group for the instance.
ip-address
- The public IPv4 address of the instance.
ipv6-address
- The IPv6 address of the instance.
kernel-id
- The kernel ID.
key-name
- The name of the key pair used when the instance was launched.
launch-index
- When launching multiple instances, this is the index for the instance in the launch group (for example, 0, 1, 2, and so on).
launch-time
- The time when the instance was launched, in the ISO 8601 format in the UTC time zone (YYYY-MM-DDThh:mm:ss.sssZ), for example, 2021-09-29T11:04:43.305Z
. You can use a wildcard (*
), for example, 2021-09-29T*
, which matches an entire day.
license-pool
-
maintenance-options.auto-recovery
- The current automatic recovery behavior of the instance (disabled
| default
).
metadata-options.http-endpoint
- The status of access to the HTTP metadata endpoint on your instance (enabled
| disabled
)
metadata-options.http-protocol-ipv4
- Indicates whether the IPv4 endpoint is enabled (disabled
| enabled
).
metadata-options.http-protocol-ipv6
- Indicates whether the IPv6 endpoint is enabled (disabled
| enabled
).
metadata-options.http-put-response-hop-limit
- The HTTP metadata request put response hop limit (integer, possible values 1
to 64
)
metadata-options.http-tokens
- The metadata request authorization state (optional
| required
)
metadata-options.instance-metadata-tags
- The status of access to instance tags from the instance metadata (enabled
| disabled
)
metadata-options.state
- The state of the metadata option changes (pending
| applied
).
monitoring-state
- Indicates whether detailed monitoring is enabled (disabled
| enabled
).
network-interface.addresses.primary
- Specifies whether the IPv4 address of the network interface is the primary private IPv4 address.
network-interface.addresses.private-ip-address
- The private IPv4 address associated with the network interface.
network-interface.addresses.association.public-ip
- The ID of the association of an Elastic IP address (IPv4) with a network interface.
network-interface.addresses.association.ip-owner-id
- The owner ID of the private IPv4 address associated with the network interface.
network-interface.association.public-ip
- The address of the Elastic IP address (IPv4) bound to the network interface.
network-interface.association.ip-owner-id
- The owner of the Elastic IP address (IPv4) associated with the network interface.
network-interface.association.allocation-id
- The allocation ID returned when you allocated the Elastic IP address (IPv4) for your network interface.
network-interface.association.association-id
- The association ID returned when the network interface was associated with an IPv4 address.
network-interface.attachment.attachment-id
- The ID of the interface attachment.
network-interface.attachment.instance-id
- The ID of the instance to which the network interface is attached.
network-interface.attachment.instance-owner-id
- The owner ID of the instance to which the network interface is attached.
network-interface.attachment.device-index
- The device index to which the network interface is attached.
network-interface.attachment.status
- The status of the attachment (attaching
| attached
| detaching
| detached
).
network-interface.attachment.attach-time
- The time that the network interface was attached to an instance.
network-interface.attachment.delete-on-termination
- Specifies whether the attachment is deleted when an instance is terminated.
network-interface.availability-zone
- The Availability Zone for the network interface.
network-interface.description
- The description of the network interface.
network-interface.group-id
- The ID of a security group associated with the network interface.
network-interface.group-name
- The name of a security group associated with the network interface.
network-interface.ipv6-addresses.ipv6-address
- The IPv6 address associated with the network interface.
network-interface.mac-address
- The MAC address of the network interface.
network-interface.network-interface-id
- The ID of the network interface.
network-interface.owner-id
- The ID of the owner of the network interface.
network-interface.private-dns-name
- The private DNS name of the network interface.
network-interface.requester-id
- The requester ID for the network interface.
network-interface.requester-managed
- Indicates whether the network interface is being managed by Amazon Web Services.
network-interface.status
- The status of the network interface (available
) | in-use
).
network-interface.source-dest-check
- Whether the network interface performs source/destination checking. A value of true
means that checking is enabled, and false
means that checking is disabled. The value must be false
for the network interface to perform network address translation (NAT) in your VPC.
network-interface.subnet-id
- The ID of the subnet for the network interface.
network-interface.vpc-id
- The ID of the VPC for the network interface.
outpost-arn
- The Amazon Resource Name (ARN) of the Outpost.
owner-id
- The Amazon Web Services account ID of the instance owner.
placement-group-name
- The name of the placement group for the instance.
placement-partition-number
- The partition in which the instance is located.
platform
- The platform. To list only Windows instances, use windows
.
platform-details
- The platform (Linux/UNIX
| Red Hat BYOL Linux
| Red Hat Enterprise Linux
| Red Hat Enterprise Linux with HA
| Red Hat Enterprise Linux with SQL Server Standard and HA
| Red Hat Enterprise Linux with SQL Server Enterprise and HA
| Red Hat Enterprise Linux with SQL Server Standard
| Red Hat Enterprise Linux with SQL Server Web
| Red Hat Enterprise Linux with SQL Server Enterprise
| SQL Server Enterprise
| SQL Server Standard
| SQL Server Web
| SUSE Linux
| Ubuntu Pro
| Windows
| Windows BYOL
| Windows with SQL Server Enterprise
| Windows with SQL Server Standard
| Windows with SQL Server Web
).
private-dns-name
- The private IPv4 DNS name of the instance.
private-dns-name-options.enable-resource-name-dns-a-record
- A Boolean that indicates whether to respond to DNS queries for instance hostnames with DNS A records.
private-dns-name-options.enable-resource-name-dns-aaaa-record
- A Boolean that indicates whether to respond to DNS queries for instance hostnames with DNS AAAA records.
private-dns-name-options.hostname-type
- The type of hostname (ip-name
| resource-name
).
private-ip-address
- The private IPv4 address of the instance.
product-code
- The product code associated with the AMI used to launch the instance.
product-code.type
- The type of product code (devpay
| marketplace
).
ramdisk-id
- The RAM disk ID.
reason
- The reason for the current state of the instance (for example, shows \"User Initiated [date]\" when you stop or terminate the instance). Similar to the state-reason-code filter.
requester-id
- The ID of the entity that launched the instance on your behalf (for example, Amazon Web Services Management Console, Auto Scaling, and so on).
reservation-id
- The ID of the instance's reservation. A reservation ID is created any time you launch an instance. A reservation ID has a one-to-one relationship with an instance launch request, but can be associated with more than one instance if you launch multiple instances using the same launch request. For example, if you launch one instance, you get one reservation ID. If you launch ten instances using the same launch request, you also get one reservation ID.
root-device-name
- The device name of the root device volume (for example, /dev/sda1
).
root-device-type
- The type of the root device volume (ebs
| instance-store
).
source-dest-check
- Indicates whether the instance performs source/destination checking. A value of true
means that checking is enabled, and false
means that checking is disabled. The value must be false
for the instance to perform network address translation (NAT) in your VPC.
spot-instance-request-id
- The ID of the Spot Instance request.
state-reason-code
- The reason code for the state change.
state-reason-message
- A message that describes the state change.
subnet-id
- The ID of the subnet for the instance.
tag:<key>
- The key/value combination of a tag assigned to the resource. Use the tag key in the filter name and the tag value as the filter value. For example, to find all resources that have a tag with the key Owner
and the value TeamA
, specify tag:Owner
for the filter name and TeamA
for the filter value.
tag-key
- The key of a tag assigned to the resource. Use this filter to find all resources that have a tag with a specific key, regardless of the tag value.
tenancy
- The tenancy of an instance (dedicated
| default
| host
).
tpm-support
- Indicates if the instance is configured for NitroTPM support (v2.0
).
usage-operation
- The usage operation value for the instance (RunInstances
| RunInstances:00g0
| RunInstances:0010
| RunInstances:1010
| RunInstances:1014
| RunInstances:1110
| RunInstances:0014
| RunInstances:0210
| RunInstances:0110
| RunInstances:0100
| RunInstances:0004
| RunInstances:0200
| RunInstances:000g
| RunInstances:0g00
| RunInstances:0002
| RunInstances:0800
| RunInstances:0102
| RunInstances:0006
| RunInstances:0202
).
usage-operation-update-time
- The time that the usage operation was last updated, for example, 2022-09-15T17:15:20.000Z
.
virtualization-type
- The virtualization type of the instance (paravirtual
| hvm
).
vpc-id
- The ID of the VPC that the instance is running in.
The filters.
attachment.state
- The current state of the attachment between the gateway and the VPC (available
). Present only if a VPC is attached.
attachment.vpc-id
- The ID of an attached VPC.
internet-gateway-id
- The ID of the Internet gateway.
owner-id
- The ID of the Amazon Web Services account that owns the internet gateway.
tag
:<key> - The key/value combination of a tag assigned to the resource. Use the tag key in the filter name and the tag value as the filter value. For example, to find all resources that have a tag with the key Owner
and the value TeamA
, specify tag:Owner
for the filter name and TeamA
for the filter value.
tag-key
- The key of a tag assigned to the resource. Use this filter to find all resources assigned a tag with a specific key, regardless of the tag value.
One or more filters for the request. For more information about filtering, see Filtering CLI output.
", "DescribeIpamResourceDiscoveriesRequest$Filters": "The resource discovery filters.
", @@ -11606,7 +11606,7 @@ "CreateReservedInstancesListingRequest$InstanceCount": "The number of instances that are a part of a Reserved Instance account to be listed in the Reserved Instance Marketplace. This number should be less than or equal to the instance count associated with the Reserved Instance ID specified in this call.
", "CreateTrafficMirrorFilterRuleRequest$RuleNumber": "The number of the Traffic Mirror rule. This number must be unique for each Traffic Mirror rule in a given direction. The rules are processed in ascending order by rule number.
", "CreateTrafficMirrorFilterRuleRequest$Protocol": "The protocol, for example UDP, to assign to the Traffic Mirror rule.
For information about the protocol value, see Protocol Numbers on the Internet Assigned Numbers Authority (IANA) website.
", - "CreateTrafficMirrorSessionRequest$PacketLength": "The number of bytes in each packet to mirror. These are bytes after the VXLAN header. Do not specify this parameter when you want to mirror the entire packet. To mirror a subset of the packet, set this to the length (in bytes) that you want to mirror. For example, if you set this value to 100, then the first 100 bytes that meet the filter criteria are copied to the target.
If you do not want to mirror the entire packet, use the PacketLength
parameter to specify the number of bytes in each packet to mirror.
The number of bytes in each packet to mirror. These are bytes after the VXLAN header. Do not specify this parameter when you want to mirror the entire packet. To mirror a subset of the packet, set this to the length (in bytes) that you want to mirror. For example, if you set this value to 100, then the first 100 bytes that meet the filter criteria are copied to the target.
If you do not want to mirror the entire packet, use the PacketLength
parameter to specify the number of bytes in each packet to mirror.
For sessions with Network Load Balancer (NLB) Traffic Mirror targets the default PacketLength
will be set to 8500. Valid values are 1-8500. Setting a PacketLength
greater than 8500 will result in an error response.
The session number determines the order in which sessions are evaluated when an interface is used by multiple sessions. The first session with a matching filter is the one that mirrors the packets.
Valid values are 1-32766.
", "CreateTrafficMirrorSessionRequest$VirtualNetworkId": "The VXLAN ID for the Traffic Mirror session. For more information about the VXLAN protocol, see RFC 7348. If you do not specify a VirtualNetworkId
, an account-wide unique id is chosen at random.
The number of I/O operations per second (IOPS). For gp3
, io1
, and io2
volumes, this represents the number of IOPS that are provisioned for the volume. For gp2
volumes, this represents the baseline performance of the volume and the rate at which the volume accumulates I/O credits for bursting.
The following are the supported values for each volume type:
gp3
: 3,000-16,000 IOPS
io1
: 100-64,000 IOPS
io2
: 100-64,000 IOPS
io1
and io2
volumes support up to 64,000 IOPS only on Instances built on the Nitro System. Other instance families support performance up to 32,000 IOPS.
This parameter is required for io1
and io2
volumes. The default for gp3
volumes is 3,000 IOPS. This parameter is not supported for gp2
, st1
, sc1
, or standard
volumes.
Indicates the device position for local network interfaces in this subnet. For example, 1
indicates local network interfaces in this subnet are the secondary network interface (eth1). A local network interface cannot be the primary network interface (eth0).
The number of the Traffic Mirror rule. This number must be unique for each Traffic Mirror rule in a given direction. The rules are processed in ascending order by rule number.
", "ModifyTrafficMirrorFilterRuleRequest$Protocol": "The protocol, for example TCP, to assign to the Traffic Mirror rule.
", - "ModifyTrafficMirrorSessionRequest$PacketLength": "The number of bytes in each packet to mirror. These are bytes after the VXLAN header. To mirror a subset, set this to the length (in bytes) to mirror. For example, if you set this value to 100, then the first 100 bytes that meet the filter criteria are copied to the target. Do not specify this parameter when you want to mirror the entire packet.
", + "ModifyTrafficMirrorSessionRequest$PacketLength": "The number of bytes in each packet to mirror. These are bytes after the VXLAN header. To mirror a subset, set this to the length (in bytes) to mirror. For example, if you set this value to 100, then the first 100 bytes that meet the filter criteria are copied to the target. Do not specify this parameter when you want to mirror the entire packet.
For sessions with Network Load Balancer (NLB) traffic mirror targets, the default PacketLength
will be set to 8500. Valid values are 1-8500. Setting a PacketLength
greater than 8500 will result in an error response.
The session number determines the order in which sessions are evaluated when an interface is used by multiple sessions. The first session with a matching filter is the one that mirrors the packets.
Valid values are 1-32766.
", "ModifyTrafficMirrorSessionRequest$VirtualNetworkId": "The virtual network ID of the Traffic Mirror session.
", "ModifyVolumeRequest$Size": "The target size of the volume, in GiB. The target volume size must be greater than or equal to the existing size of the volume.
The following are the supported volumes sizes for each volume type:
gp2
and gp3
: 1-16,384
io1
and io2
: 4-16,384
st1
and sc1
: 125-16,384
standard
: 1-1,024
Default: The existing size is retained.
", @@ -18608,7 +18608,7 @@ "CreateFlowLogsRequest$DeliverCrossAccountRole": "The ARN of the IAM role that allows Amazon EC2 to publish flow logs across accounts.
", "CreateFlowLogsRequest$LogGroupName": "The name of a new or existing CloudWatch Logs log group where Amazon EC2 publishes your flow logs.
This parameter is valid only if the destination type is cloud-watch-logs
.
The destination for the flow log data. The meaning of this parameter depends on the destination type.
If the destination type is cloud-watch-logs
, specify the ARN of a CloudWatch Logs log group. For example:
arn:aws:logs:region:account_id:log-group:my_group
Alternatively, use the LogGroupName
parameter.
If the destination type is s3
, specify the ARN of an S3 bucket. For example:
arn:aws:s3:::my_bucket/my_subfolder/
The subfolder is optional. Note that you can't use AWSLogs
as a subfolder name.
If the destination type is kinesis-data-firehose
, specify the ARN of a Kinesis Data Firehose delivery stream. For example:
arn:aws:firehose:region:account_id:deliverystream:my_stream
The fields to include in the flow log record. List the fields in the order in which they should appear. If you omit this parameter, the flow log is created using the default format. If you specify this parameter, you must include at least one field. For more information about the available fields, see Flow log records in the Amazon VPC User Guide or Transit Gateway Flow Log records in the Amazon Web Services Transit Gateway Guide.
Specify the fields using the ${field-id}
format, separated by spaces. For the CLI, surround this parameter value with single quotes on Linux or double quotes on Windows.
The fields to include in the flow log record. List the fields in the order in which they should appear. If you omit this parameter, the flow log is created using the default format. If you specify this parameter, you must include at least one field. For more information about the available fields, see Flow log records in the Amazon VPC User Guide or Transit Gateway Flow Log records in the Amazon Web Services Transit Gateway Guide.
Specify the fields using the ${field-id}
format, separated by spaces.
Unique, case-sensitive identifier that you provide to ensure the idempotency of the request.
", "CreateFpgaImageRequest$Description": "A description for the AFI.
", "CreateFpgaImageRequest$Name": "A name for the AFI.
", @@ -20425,7 +20425,7 @@ "SubnetCidrReservationType": { "base": null, "refs": { - "CreateSubnetCidrReservationRequest$ReservationType": "The type of reservation.
The following are valid values:
prefix
: The Amazon EC2 Prefix Delegation feature assigns the IP addresses to network interfaces that are associated with an instance. For information about Prefix Delegation, see Prefix Delegation for Amazon EC2 network interfaces in the Amazon Elastic Compute Cloud User Guide.
explicit
: You manually assign the IP addresses to resources that reside in your subnet.
The type of reservation. The reservation type determines how the reserved IP addresses are assigned to resources.
prefix
- Amazon Web Services assigns the reserved IP addresses to network interfaces.
explicit
- You assign the reserved IP addresses to network interfaces.
The type of reservation.
" } }, @@ -22633,7 +22633,7 @@ "VersionStringList": { "base": null, "refs": { - "DeleteLaunchTemplateVersionsRequest$Versions": "The version numbers of one or more launch template versions to delete.
", + "DeleteLaunchTemplateVersionsRequest$Versions": "The version numbers of one or more launch template versions to delete. You can specify up to 200 launch template version numbers.
", "DescribeLaunchTemplateVersionsRequest$Versions": "One or more versions of the launch template. Valid values depend on whether you are describing a specified launch template (by ID or name) or all launch templates in your account.
To describe one or more versions of a specified launch template, valid values are $Latest
, $Default
, and numbers.
To describe all launch templates in your account that are defined as the latest version, the valid value is $Latest
. To describe all launch templates in your account that are defined as the default version, the valid value is $Default
. You can specify $Latest
and $Default
in the same request. You cannot specify numbers.
A custom symbol to denote what combines content into a single column value. It must be different from the column delimiter.
" } }, + "CsvSerdeOption": { + "base": null, + "refs": { + "CreateCsvClassifierRequest$Serde": "Sets the SerDe for processing CSV in the classifier, which will be applied in the Data Catalog. Valid values are OpenCSVSerDe
, LazySimpleSerDe
, and None
. You can specify the None
value when you want the crawler to do the detection.
Sets the SerDe for processing CSV in the classifier, which will be applied in the Data Catalog. Valid values are OpenCSVSerDe
, LazySimpleSerDe
, and None
. You can specify the None
value when you want the crawler to do the detection.
Sets the SerDe for processing CSV in the classifier, which will be applied in the Data Catalog. Valid values are OpenCSVSerDe
, LazySimpleSerDe
, and None
. You can specify the None
value when you want the crawler to do the detection.
Specifies a transform that uses custom code you provide to perform the data transformation. The output is a collection of DynamicFrames.
", "refs": { diff --git a/models/apis/pi/2018-02-27/api-2.json b/models/apis/pi/2018-02-27/api-2.json index 199ffe2e37d..e30c4b44b48 100644 --- a/models/apis/pi/2018-02-27/api-2.json +++ b/models/apis/pi/2018-02-27/api-2.json @@ -14,6 +14,34 @@ "uid":"pi-2018-02-27" }, "operations":{ + "CreatePerformanceAnalysisReport":{ + "name":"CreatePerformanceAnalysisReport", + "http":{ + "method":"POST", + "requestUri":"/" + }, + "input":{"shape":"CreatePerformanceAnalysisReportRequest"}, + "output":{"shape":"CreatePerformanceAnalysisReportResponse"}, + "errors":[ + {"shape":"InvalidArgumentException"}, + {"shape":"InternalServiceError"}, + {"shape":"NotAuthorizedException"} + ] + }, + "DeletePerformanceAnalysisReport":{ + "name":"DeletePerformanceAnalysisReport", + "http":{ + "method":"POST", + "requestUri":"/" + }, + "input":{"shape":"DeletePerformanceAnalysisReportRequest"}, + "output":{"shape":"DeletePerformanceAnalysisReportResponse"}, + "errors":[ + {"shape":"InvalidArgumentException"}, + {"shape":"InternalServiceError"}, + {"shape":"NotAuthorizedException"} + ] + }, "DescribeDimensionKeys":{ "name":"DescribeDimensionKeys", "http":{ @@ -42,6 +70,20 @@ {"shape":"NotAuthorizedException"} ] }, + "GetPerformanceAnalysisReport":{ + "name":"GetPerformanceAnalysisReport", + "http":{ + "method":"POST", + "requestUri":"/" + }, + "input":{"shape":"GetPerformanceAnalysisReportRequest"}, + "output":{"shape":"GetPerformanceAnalysisReportResponse"}, + "errors":[ + {"shape":"InvalidArgumentException"}, + {"shape":"InternalServiceError"}, + {"shape":"NotAuthorizedException"} + ] + }, "GetResourceMetadata":{ "name":"GetResourceMetadata", "http":{ @@ -97,9 +139,69 @@ {"shape":"InternalServiceError"}, {"shape":"NotAuthorizedException"} ] + }, + "ListPerformanceAnalysisReports":{ + "name":"ListPerformanceAnalysisReports", + "http":{ + "method":"POST", + "requestUri":"/" + }, + "input":{"shape":"ListPerformanceAnalysisReportsRequest"}, + "output":{"shape":"ListPerformanceAnalysisReportsResponse"}, + "errors":[ + {"shape":"InvalidArgumentException"}, + {"shape":"InternalServiceError"}, + {"shape":"NotAuthorizedException"} + ] + }, + "ListTagsForResource":{ + "name":"ListTagsForResource", + "http":{ + "method":"POST", + "requestUri":"/" + }, + "input":{"shape":"ListTagsForResourceRequest"}, + "output":{"shape":"ListTagsForResourceResponse"}, + "errors":[ + {"shape":"InvalidArgumentException"}, + {"shape":"InternalServiceError"}, + {"shape":"NotAuthorizedException"} + ] + }, + "TagResource":{ + "name":"TagResource", + "http":{ + "method":"POST", + "requestUri":"/" + }, + "input":{"shape":"TagResourceRequest"}, + "output":{"shape":"TagResourceResponse"}, + "errors":[ + {"shape":"InvalidArgumentException"}, + {"shape":"InternalServiceError"}, + {"shape":"NotAuthorizedException"} + ] + }, + "UntagResource":{ + "name":"UntagResource", + "http":{ + "method":"POST", + "requestUri":"/" + }, + "input":{"shape":"UntagResourceRequest"}, + "output":{"shape":"UntagResourceResponse"}, + "errors":[ + {"shape":"InvalidArgumentException"}, + {"shape":"InternalServiceError"}, + {"shape":"NotAuthorizedException"} + ] } }, "shapes":{ + "AcceptLanguage":{ + "type":"string", + "enum":["EN_US"] + }, "AdditionalMetricsList":{ "type":"list", "member":{"shape":"RequestString"}, @@ -111,6 +213,95 @@ "key":{"shape":"RequestString"}, "value":{"shape":"Double"} }, + "AmazonResourceName":{ + "type":"string", + "max":1011, + "min":1, + "pattern":"^arn:.*:pi:.*$" + }, + "AnalysisReport":{ + "type":"structure", + "required":["AnalysisReportId"], + "members":{ + "AnalysisReportId":{"shape":"AnalysisReportId"}, + "Identifier":{"shape":"IdentifierString"}, + "ServiceType":{"shape":"ServiceType"}, + "CreateTime":{"shape":"ISOTimestamp"}, + "StartTime":{"shape":"ISOTimestamp"}, + "EndTime":{"shape":"ISOTimestamp"}, + "Status":{"shape":"AnalysisStatus"}, + "Insights":{"shape":"InsightList"} + } + }, + "AnalysisReportId":{ + "type":"string", + "max":100, + "min":1, + "pattern":"report-[0-9a-f]{17}" + }, + "AnalysisReportSummary":{ + "type":"structure", + "members":{ + "AnalysisReportId":{"shape":"String"}, + "CreateTime":{"shape":"ISOTimestamp"}, + "StartTime":{"shape":"ISOTimestamp"}, + "EndTime":{"shape":"ISOTimestamp"}, + "Status":{"shape":"AnalysisStatus"}, + "Tags":{"shape":"TagList"} + } + }, + "AnalysisReportSummaryList":{ + "type":"list", + "member":{"shape":"AnalysisReportSummary"} + }, + "AnalysisStatus":{ + "type":"string", + "enum":[ + "RUNNING", + "SUCCEEDED", + "FAILED" + ] + }, + "Boolean":{"type":"boolean"}, + "ContextType":{ + "type":"string", + "enum":[ + "CAUSAL", + "CONTEXTUAL" + ] + }, + "CreatePerformanceAnalysisReportRequest":{ + "type":"structure", + "required":[ + "ServiceType", + "Identifier", + "StartTime", + "EndTime" + ], + "members":{ + "ServiceType":{"shape":"ServiceType"}, + "Identifier":{"shape":"IdentifierString"}, + "StartTime":{"shape":"ISOTimestamp"}, + "EndTime":{"shape":"ISOTimestamp"}, + "Tags":{"shape":"TagList"} + } + }, + "CreatePerformanceAnalysisReportResponse":{ + "type":"structure", + "members":{ + "AnalysisReportId":{"shape":"AnalysisReportId"} + } + }, + "Data":{ + "type":"structure", + "members":{ + "PerformanceInsightsMetric":{"shape":"PerformanceInsightsMetric"} + } + }, + "DataList":{ + "type":"list", + "member":{"shape":"Data"} + }, "DataPoint":{ "type":"structure", "required":[ @@ -126,6 +317,24 @@ "type":"list", "member":{"shape":"DataPoint"} }, + "DeletePerformanceAnalysisReportRequest":{ + "type":"structure", + "required":[ + "ServiceType", + "Identifier", + "AnalysisReportId" + ], + "members":{ + "ServiceType":{"shape":"ServiceType"}, + "Identifier":{"shape":"IdentifierString"}, + "AnalysisReportId":{"shape":"AnalysisReportId"} + } + }, + "DeletePerformanceAnalysisReportResponse":{ + "type":"structure", + "members":{ + } + }, "DescribeDimensionKeysRequest":{ "type":"structure", "required":[ @@ -138,7 +347,7 @@ ], "members":{ "ServiceType":{"shape":"ServiceType"}, - "Identifier":{"shape":"RequestString"}, + "Identifier":{"shape":"IdentifierString"}, "StartTime":{"shape":"ISOTimestamp"}, "EndTime":{"shape":"ISOTimestamp"}, "Metric":{"shape":"RequestString"}, @@ -166,6 +375,17 @@ "max":2048, "min":1 }, + "DescriptiveMap":{ + "type":"map", + "key":{"shape":"DescriptiveString"}, + "value":{"shape":"DescriptiveString"} + }, + "DescriptiveString":{ + "type":"string", + "max":2000, + "min":1, + "pattern":"^.*$" + }, "DetailStatus":{ "type":"string", "enum":[ @@ -286,6 +506,27 @@ "Dimensions":{"shape":"DimensionKeyDetailList"} } }, + "GetPerformanceAnalysisReportRequest":{ + "type":"structure", + "required":[ + "ServiceType", + "Identifier", + "AnalysisReportId" + ], + "members":{ + "ServiceType":{"shape":"ServiceType"}, + "Identifier":{"shape":"IdentifierString"}, + "AnalysisReportId":{"shape":"AnalysisReportId"}, + "TextFormat":{"shape":"TextFormat"}, + "AcceptLanguage":{"shape":"AcceptLanguage"} + } + }, + "GetPerformanceAnalysisReportResponse":{ + "type":"structure", + "members":{ + "AnalysisReport":{"shape":"AnalysisReport"} + } + }, "GetResourceMetadataRequest":{ "type":"structure", "required":[ @@ -294,7 +535,7 @@ ], "members":{ "ServiceType":{"shape":"ServiceType"}, - "Identifier":{"shape":"RequestString"} + "Identifier":{"shape":"IdentifierString"} } }, "GetResourceMetadataResponse":{ @@ -315,7 +556,7 @@ ], "members":{ "ServiceType":{"shape":"ServiceType"}, - "Identifier":{"shape":"RequestString"}, + "Identifier":{"shape":"IdentifierString"}, "MetricQueries":{"shape":"MetricQueryList"}, "StartTime":{"shape":"ISOTimestamp"}, "EndTime":{"shape":"ISOTimestamp"}, @@ -340,7 +581,28 @@ "type":"string", "max":256, "min":0, - "pattern":"^db-[a-zA-Z0-9-]*$" + "pattern":"^[a-zA-Z0-9-]+$" + }, + "Insight":{ + "type":"structure", + "required":["InsightId"], + "members":{ + "InsightId":{"shape":"String"}, + "InsightType":{"shape":"String"}, + "Context":{"shape":"ContextType"}, + "StartTime":{"shape":"ISOTimestamp"}, + "EndTime":{"shape":"ISOTimestamp"}, + "Severity":{"shape":"Severity"}, + "SupportingInsights":{"shape":"InsightList"}, + "Description":{"shape":"MarkdownString"}, + "Recommendations":{"shape":"RecommendationList"}, + "InsightData":{"shape":"DataList"}, + "BaselineData":{"shape":"DataList"} + } + }, + "InsightList":{ + "type":"list", + "member":{"shape":"Insight"} }, "Integer":{"type":"integer"}, "InternalServiceError":{ @@ -372,7 +634,7 @@ ], "members":{ "ServiceType":{"shape":"ServiceType"}, - "Identifier":{"shape":"RequestString"}, + "Identifier":{"shape":"IdentifierString"}, "Metrics":{"shape":"DimensionsMetricList"}, "MaxResults":{"shape":"MaxResults"}, "NextToken":{"shape":"NextToken"} @@ -394,7 +656,7 @@ ], "members":{ "ServiceType":{"shape":"ServiceType"}, - "Identifier":{"shape":"RequestString"}, + "Identifier":{"shape":"IdentifierString"}, "MetricTypes":{"shape":"MetricTypeList"}, "NextToken":{"shape":"NextToken"}, "MaxResults":{"shape":"MaxResults"} @@ -407,6 +669,51 @@ "NextToken":{"shape":"NextToken"} } }, + "ListPerformanceAnalysisReportsRequest":{ + "type":"structure", + "required":[ + "ServiceType", + "Identifier" + ], + "members":{ + "ServiceType":{"shape":"ServiceType"}, + "Identifier":{"shape":"IdentifierString"}, + "NextToken":{"shape":"NextToken"}, + "MaxResults":{"shape":"MaxResults"}, + "ListTags":{"shape":"Boolean"} + } + }, + "ListPerformanceAnalysisReportsResponse":{ + "type":"structure", + "members":{ + "AnalysisReports":{"shape":"AnalysisReportSummaryList"}, + "NextToken":{"shape":"NextToken"} + } + }, + "ListTagsForResourceRequest":{ + "type":"structure", + "required":[ + "ServiceType", + "ResourceARN" + ], + "members":{ + "ServiceType":{"shape":"ServiceType"}, + "ResourceARN":{"shape":"AmazonResourceName"} + } + }, + "ListTagsForResourceResponse":{ + "type":"structure", + "members":{ + "Tags":{"shape":"TagList"} + } + }, + "MarkdownString":{ + "type":"string", + "max":8000, + "min":0, + "pattern":"(.|\\n)*", + "sensitive":true + }, "MaxResults":{ "type":"integer", "max":25, @@ -466,7 +773,7 @@ "type":"string", "max":8192, "min":1, - "pattern":"[\\s\\S]*" + "pattern":"^[a-zA-Z0-9_=-]+$" }, "NotAuthorizedException":{ "type":"structure", @@ -475,6 +782,15 @@ }, "exception":true }, + "PerformanceInsightsMetric":{ + "type":"structure", + "members":{ + "Metric":{"shape":"DescriptiveString"}, + "DisplayName":{"shape":"DescriptiveString"}, + "Dimensions":{"shape":"DescriptiveMap"}, + "Value":{"shape":"Double"} + } + }, "PeriodAlignment":{ "type":"string", "enum":[ @@ -482,6 +798,17 @@ "START_TIME" ] }, + "Recommendation":{ + "type":"structure", + "members":{ + "RecommendationId":{"shape":"String"}, + "RecommendationDescription":{"shape":"MarkdownString"} + } + }, + "RecommendationList":{ + "type":"list", + "member":{"shape":"Recommendation"} + }, "RequestString":{ "type":"string", "max":256, @@ -538,11 +865,97 @@ "DOCDB" ] }, + "Severity":{ + "type":"string", + "enum":[ + "LOW", + "MEDIUM", + "HIGH" + ] + }, "String":{ "type":"string", "max":256, "min":0, "pattern":".*\\S.*" + }, + "Tag":{ + "type":"structure", + "required":[ + "Key", + "Value" + ], + "members":{ + "Key":{"shape":"TagKey"}, + "Value":{"shape":"TagValue"} + } + }, + "TagKey":{ + "type":"string", + "max":128, + "min":1, + "pattern":"^.*$" + }, + "TagKeyList":{ + "type":"list", + "member":{"shape":"TagKey"}, + "max":200, + "min":0 + }, + "TagList":{ + "type":"list", + "member":{"shape":"Tag"}, + "max":200, + "min":0 + }, + "TagResourceRequest":{ + "type":"structure", + "required":[ + "ServiceType", + "ResourceARN", + "Tags" + ], + "members":{ + "ServiceType":{"shape":"ServiceType"}, + "ResourceARN":{"shape":"AmazonResourceName"}, + "Tags":{"shape":"TagList"} + } + }, + "TagResourceResponse":{ + "type":"structure", + "members":{ + } + }, + "TagValue":{ + "type":"string", + "max":256, + "min":0, + "pattern":"^.*$" + }, + "TextFormat":{ + "type":"string", + "enum":[ + "PLAIN_TEXT", + "MARKDOWN" + ] + }, + "UntagResourceRequest":{ + "type":"structure", + "required":[ + "ServiceType", + "ResourceARN", + "TagKeys" + ], + "members":{ + "ServiceType":{"shape":"ServiceType"}, + "ResourceARN":{"shape":"AmazonResourceName"}, + "TagKeys":{"shape":"TagKeyList"} + } + }, + "UntagResourceResponse":{ + "type":"structure", + "members":{ + } } } } diff --git a/models/apis/pi/2018-02-27/docs-2.json b/models/apis/pi/2018-02-27/docs-2.json index 328bb1c5fd5..5687cc097e3 100644 --- a/models/apis/pi/2018-02-27/docs-2.json +++ b/models/apis/pi/2018-02-27/docs-2.json @@ -2,14 +2,27 @@ "version": "2.0", "service": "Amazon RDS Performance Insights enables you to monitor and explore different dimensions of database load based on data captured from a running DB instance. The guide provides detailed information about Performance Insights data types, parameters and errors.
When Performance Insights is enabled, the Amazon RDS Performance Insights API provides visibility into the performance of your DB instance. Amazon CloudWatch provides the authoritative source for Amazon Web Services service-vended monitoring metrics. Performance Insights offers a domain-specific view of DB load.
DB load is measured as average active sessions. Performance Insights provides the data to API consumers as a two-dimensional time-series dataset. The time dimension provides DB load data for each time point in the queried time range. Each time point decomposes overall load in relation to the requested dimensions, measured at that time point. Examples include SQL, Wait event, User, and Host.
To learn more about Performance Insights and Amazon Aurora DB instances, go to the Amazon Aurora User Guide .
To learn more about Performance Insights and Amazon RDS DB instances, go to the Amazon RDS User Guide .
To learn more about Performance Insights and Amazon DocumentDB clusters, go to the Amazon DocumentDB Developer Guide .
Creates a new performance analysis report for a specific time period for the DB instance.
", + "DeletePerformanceAnalysisReport": "Deletes a performance analysis report.
", "DescribeDimensionKeys": "For a specific time period, retrieve the top N
dimension keys for a metric.
Each response element returns a maximum of 500 bytes. For larger elements, such as SQL statements, only the first 500 bytes are returned.
Get the attributes of the specified dimension group for a DB instance or data source. For example, if you specify a SQL ID, GetDimensionKeyDetails
retrieves the full text of the dimension db.sql.statement
associated with this ID. This operation is useful because GetResourceMetrics
and DescribeDimensionKeys
don't support retrieval of large SQL statement text.
Retrieves the report including the report ID, status, time details, and the insights with recommendations. The report status can be RUNNING
, SUCCEEDED
, or FAILED
. The insights include the description
and recommendation
fields.
Retrieve the metadata for different features. For example, the metadata might indicate that a feature is turned on or off on a specific DB instance.
", "GetResourceMetrics": "Retrieve Performance Insights metrics for a set of data sources over a time period. You can provide specific dimension groups and dimensions, and provide aggregation and filtering criteria for each group.
Each response element returns a maximum of 500 bytes. For larger elements, such as SQL statements, only the first 500 bytes are returned.
Retrieve the dimensions that can be queried for each specified metric type on a specified DB instance.
", - "ListAvailableResourceMetrics": "Retrieve metrics of the specified types that can be queried for a specified DB instance.
" + "ListAvailableResourceMetrics": "Retrieve metrics of the specified types that can be queried for a specified DB instance.
", + "ListPerformanceAnalysisReports": "Lists all the analysis reports created for the DB instance. The reports are sorted based on the start time of each report.
", + "ListTagsForResource": "Retrieves all the metadata tags associated with Amazon RDS Performance Insights resource.
", + "TagResource": "Adds metadata tags to the Amazon RDS Performance Insights resource.
", + "UntagResource": "Deletes the metadata tags from the Amazon RDS Performance Insights resource.
" }, "shapes": { + "AcceptLanguage": { + "base": null, + "refs": { + "GetPerformanceAnalysisReportRequest$AcceptLanguage": "The text language in the report. The default language is EN_US
(English).
A map that contains the value for each additional metric.
" } }, + "AmazonResourceName": { + "base": null, + "refs": { + "ListTagsForResourceRequest$ResourceARN": "Lists all the tags for the Amazon RDS Performance Insights resource. This value is an Amazon Resource Name (ARN). For information about creating an ARN, see Constructing an RDS Amazon Resource Name (ARN).
", + "TagResourceRequest$ResourceARN": "The Amazon RDS Performance Insights resource that the tags are added to. This value is an Amazon Resource Name (ARN). For information about creating an ARN, see Constructing an RDS Amazon Resource Name (ARN).
", + "UntagResourceRequest$ResourceARN": "The Amazon RDS Performance Insights resource that the tags are added to. This value is an Amazon Resource Name (ARN). For information about creating an ARN, see Constructing an RDS Amazon Resource Name (ARN).
" + } + }, + "AnalysisReport": { + "base": "Retrieves the summary of the performance analysis report created for a time period.
", + "refs": { + "GetPerformanceAnalysisReportResponse$AnalysisReport": "The summary of the performance analysis report created for a time period.
" + } + }, + "AnalysisReportId": { + "base": null, + "refs": { + "AnalysisReport$AnalysisReportId": "The name of the analysis report.
", + "CreatePerformanceAnalysisReportResponse$AnalysisReportId": "A unique identifier for the created analysis report.
", + "DeletePerformanceAnalysisReportRequest$AnalysisReportId": "The unique identifier of the analysis report for deletion.
", + "GetPerformanceAnalysisReportRequest$AnalysisReportId": "A unique identifier of the created analysis report. For example, report-12345678901234567
Retrieves the details of the performance analysis report.
", + "refs": { + "AnalysisReportSummaryList$member": null + } + }, + "AnalysisReportSummaryList": { + "base": null, + "refs": { + "ListPerformanceAnalysisReportsResponse$AnalysisReports": "List of reports including the report identifier, start and end time, creation time, and status.
" + } + }, + "AnalysisStatus": { + "base": null, + "refs": { + "AnalysisReport$Status": "The status of the created analysis report.
", + "AnalysisReportSummary$Status": "The status of the analysis report.
" + } + }, + "Boolean": { + "base": null, + "refs": { + "ListPerformanceAnalysisReportsRequest$ListTags": "Specifies whether or not to include the list of tags in the response.
" + } + }, + "ContextType": { + "base": null, + "refs": { + "Insight$Context": "Indicates if the insight is causal or correlated insight.
" + } + }, + "CreatePerformanceAnalysisReportRequest": { + "base": null, + "refs": { + } + }, + "CreatePerformanceAnalysisReportResponse": { + "base": null, + "refs": { + } + }, + "Data": { + "base": "List of data objects which provide details about source metrics. This field can be used to determine the PI metric to render for the insight. This data type also includes static values for the metrics for the Insight that were calculated and included in text and annotations on the DB load chart.
", + "refs": { + "DataList$member": null + } + }, + "DataList": { + "base": null, + "refs": { + "Insight$InsightData": "List of data objects containing metrics and references from the time range while generating the insight.
", + "Insight$BaselineData": "Metric names and values from the timeframe used as baseline to generate the insight.
" + } + }, "DataPoint": { "base": "A timestamp, and a single numerical value, which together represent a measurement at a particular point in time.
", "refs": { @@ -34,6 +124,16 @@ "MetricKeyDataPoints$DataPoints": "An array of timestamp-value pairs, representing measurements over a period of time.
" } }, + "DeletePerformanceAnalysisReportRequest": { + "base": null, + "refs": { + } + }, + "DeletePerformanceAnalysisReportResponse": { + "base": null, + "refs": { + } + }, "DescribeDimensionKeysRequest": { "base": null, "refs": { @@ -50,6 +150,21 @@ "ResponseResourceMetric$Description": "The description of the metric.
" } }, + "DescriptiveMap": { + "base": null, + "refs": { + "PerformanceInsightsMetric$Dimensions": "A dimension map that contains the dimensions for this partition.
" + } + }, + "DescriptiveString": { + "base": null, + "refs": { + "DescriptiveMap$key": null, + "DescriptiveMap$value": null, + "PerformanceInsightsMetric$Metric": "The Performance Insights metric.
", + "PerformanceInsightsMetric$DisplayName": "The Performance Insights metric name.
" + } + }, "DetailStatus": { "base": null, "refs": { @@ -132,7 +247,8 @@ "AdditionalMetricsMap$value": null, "DataPoint$Value": "The actual value associated with a particular Timestamp
.
The aggregated metric value for the dimensions, over the requested time range.
", - "MetricValuesList$member": null + "MetricValuesList$member": null, + "PerformanceInsightsMetric$Value": "The value of the metric. For example, 9
for db.load.avg
.
The time you created the analysis report.
", + "AnalysisReport$StartTime": "The analysis start time in the report.
", + "AnalysisReport$EndTime": "The analysis end time in the report.
", + "AnalysisReportSummary$CreateTime": "The time you created the analysis report.
", + "AnalysisReportSummary$StartTime": "The start time of the analysis in the report.
", + "AnalysisReportSummary$EndTime": "The end time of the analysis in the report.
", + "CreatePerformanceAnalysisReportRequest$StartTime": "The start time defined for the analysis report.
", + "CreatePerformanceAnalysisReportRequest$EndTime": "The end time defined for the analysis report.
", "DataPoint$Timestamp": "The time, in epoch format, associated with a particular Value
.
The date and time specifying the beginning of the requested time series data. You must specify a StartTime
within the past 7 days. The value specified is inclusive, which means that data points equal to or greater than StartTime
are returned.
The value for StartTime
must be earlier than the value for EndTime
.
The date and time specifying the end of the requested time series data. The value specified is exclusive, which means that data points less than (but not equal to) EndTime
are returned.
The value for EndTime
must be later than the value for StartTime
.
The date and time specifying the beginning of the requested time series query range. You can't specify a StartTime
that is earlier than 7 days ago. By default, Performance Insights has 7 days of retention, but you can extend this range up to 2 years. The value specified is inclusive. Thus, the command returns data points equal to or greater than StartTime
.
The value for StartTime
must be earlier than the value for EndTime
.
The date and time specifying the end of the requested time series query range. The value specified is exclusive. Thus, the command returns data points less than (but not equal to) EndTime
.
The value for EndTime
must be later than the value for StartTime
.
The start time for the returned metrics, after alignment to a granular boundary (as specified by PeriodInSeconds
). AlignedStartTime
will be less than or equal to the value of the user-specified StartTime
.
The end time for the returned metrics, after alignment to a granular boundary (as specified by PeriodInSeconds
). AlignedEndTime
will be greater than or equal to the value of the user-specified Endtime
.
The end time for the returned metrics, after alignment to a granular boundary (as specified by PeriodInSeconds
). AlignedEndTime
will be greater than or equal to the value of the user-specified Endtime
.
The start time of the insight. For example, 2018-10-30T00:00:00Z
.
The end time of the insight. For example, 2018-10-30T00:00:00Z
.
The ID for a data source from which to gather dimension data. This ID must be immutable and unique within an Amazon Web Services Region. When a DB instance is the data source, specify its DbiResourceId
value. For example, specify db-ABCDEFGHIJKLMNOPQRSTU1VW2X
.
The unique identifier of the analysis report.
", + "CreatePerformanceAnalysisReportRequest$Identifier": "An immutable, Amazon Web Services Region-unique identifier for a data source. Performance Insights gathers metrics from this data source.
To use an Amazon RDS instance as a data source, you specify its DbiResourceId
value. For example, specify db-ADECBTYHKTSAUMUZQYPDS2GW4A
.
An immutable identifier for a data source that is unique for an Amazon Web Services Region. Performance Insights gathers metrics from this data source. In the console, the identifier is shown as ResourceID. When you call DescribeDBInstances
, the identifier is returned as DbiResourceId
.
To use a DB instance as a data source, specify its DbiResourceId
value. For example, specify db-ABCDEFGHIJKLMNOPQRSTU1VW2X
.
An immutable, Amazon Web Services Region-unique identifier for a data source. Performance Insights gathers metrics from this data source.
To use an Amazon RDS instance as a data source, you specify its DbiResourceId
value. For example, specify db-FAIHNTYBKTGAUSUZQYPDS2GW4A
.
The ID for a data source from which to gather dimension data. This ID must be immutable and unique within an Amazon Web Services Region. When a DB instance is the data source, specify its DbiResourceId
value. For example, specify db-ABCDEFGHIJKLMNOPQRSTU1VW2X
.
An immutable identifier for a data source that is unique for an Amazon Web Services Region. Performance Insights gathers metrics from this data source. In the console, the identifier is shown as ResourceID. When you call DescribeDBInstances
, the identifier is returned as DbiResourceId
.
To use a DB instance as a data source, specify its DbiResourceId
value. For example, specify db-ABCDEFGHIJKLMNOPQRSTU1VW2X
.
An immutable identifier for a data source that is unique for an Amazon Web Services Region. Performance Insights gathers metrics from this data source. To use a DB instance as a data source, specify its DbiResourceId
value. For example, specify db-ABCDEFGHIJKLMNOPQRSTU1VW2X
.
An immutable identifier for a data source that is unique for an Amazon Web Services Region. Performance Insights gathers metrics from this data source. In the console, the identifier is shown as ResourceID. When you call DescribeDBInstances
, the identifier is returned as DbiResourceId
.
To use a DB instance as a data source, specify its DbiResourceId
value. For example, specify db-ABCDEFGHIJKLMNOPQRSTU1VW2X
.
An immutable identifier for a data source that is unique within an Amazon Web Services Region. Performance Insights gathers metrics from this data source. To use an Amazon RDS DB instance as a data source, specify its DbiResourceId
value. For example, specify db-ABCDEFGHIJKLMNOPQRSTU1VWZ
.
An immutable identifier for a data source that is unique within an Amazon Web Services Region. Performance Insights gathers metrics from this data source. To use an Amazon RDS DB instance as a data source, specify its DbiResourceId
value. For example, specify db-ABCDEFGHIJKLMNOPQRSTU1VWZ
.
An immutable identifier for a data source that is unique for an Amazon Web Services Region. Performance Insights gathers metrics from this data source. In the console, the identifier is shown as ResourceID. When you call DescribeDBInstances
, the identifier is returned as DbiResourceId
.
To use a DB instance as a data source, specify its DbiResourceId
value. For example, specify db-ABCDEFGHIJKLMNOPQRSTU1VW2X
.
Retrieves the list of performance issues which are identified.
", + "refs": { + "InsightList$member": null + } + }, + "InsightList": { + "base": null, + "refs": { + "AnalysisReport$Insights": "The list of identified insights in the analysis report.
", + "Insight$SupportingInsights": "List of supporting insights that provide additional factors for the insight.
" } }, "Integer": { @@ -254,13 +413,41 @@ "refs": { } }, + "ListPerformanceAnalysisReportsRequest": { + "base": null, + "refs": { + } + }, + "ListPerformanceAnalysisReportsResponse": { + "base": null, + "refs": { + } + }, + "ListTagsForResourceRequest": { + "base": null, + "refs": { + } + }, + "ListTagsForResourceResponse": { + "base": null, + "refs": { + } + }, + "MarkdownString": { + "base": null, + "refs": { + "Insight$Description": "Description of the insight. For example: A high severity Insight found between 02:00 to 02:30, where there was an unusually high DB load 600x above baseline. Likely performance impact
.
The recommendation details to help resolve the performance issue. For example, Investigate the following SQLs that contributed to 100% of the total DBLoad during that time period: sql-id
The maximum number of items to return in the response. If more items exist than the specified MaxRecords
value, a pagination token is included in the response so that the remaining results can be retrieved.
The maximum number of items to return in the response. If more items exist than the specified MaxRecords
value, a pagination token is included in the response so that the remaining results can be retrieved.
The maximum number of items to return in the response. If more items exist than the specified MaxRecords
value, a pagination token is included in the response so that the remaining results can be retrieved.
The maximum number of items to return. If the MaxRecords
value is less than the number of existing items, the response includes a pagination token.
The maximum number of items to return. If the MaxRecords
value is less than the number of existing items, the response includes a pagination token.
The maximum number of items to return in the response. If more items exist than the specified MaxResults
value, a pagination token is included in the response so that the remaining results can be retrieved.
An optional pagination token provided by a previous request. If this parameter is specified, the response includes only records beyond the token, up to the value specified by MaxRecords
.
An optional pagination token provided by a previous request. If this parameter is specified, the response includes only records beyond the token, up to the value specified by MaxRecords
.
An optional pagination token provided by a previous request. If this parameter is specified, the response includes only records beyond the token, up to the value specified by MaxRecords
.
A pagination token that indicates the response didn’t return all available records because MaxRecords
was specified in the previous request. To get the remaining records, specify NextToken
in a separate request with this value.
A pagination token that indicates the response didn’t return all available records because MaxRecords
was specified in the previous request. To get the remaining records, specify NextToken
in a separate request with this value.
An optional pagination token provided by a previous request. If this parameter is specified, the response includes only records beyond the token, up to the value specified by MaxResults
.
An optional pagination token provided by a previous request. If this parameter is specified, the response includes only records beyond the token, up to the value specified by MaxResults
.
This data type helps to determine Performance Insights metric to render for the insight.
", + "refs": { + "Data$PerformanceInsightsMetric": "This field determines the Performance Insights metric to render for the insight. The name
field refers to a Performance Insights metric.
The returned timestamp which is the start or end time of the time periods. The default value is END_TIME
.
The list of recommendations for the insight.
", + "refs": { + "RecommendationList$member": null + } + }, + "RecommendationList": { + "base": null, + "refs": { + "Insight$Recommendations": "List of recommendations for the insight. For example, Investigate the following SQLs that contributed to 100% of the total DBLoad during that time period: sql-id
.
An immutable, Amazon Web Services Region-unique identifier for a data source. Performance Insights gathers metrics from this data source.
To use an Amazon RDS instance as a data source, you specify its DbiResourceId
value. For example, specify db-FAIHNTYBKTGAUSUZQYPDS2GW4A
.
The name of a Performance Insights metric to be measured.
Valid values for Metric
are:
db.load.avg
- A scaled representation of the number of active sessions for the database engine.
db.sampledload.avg
- The raw number of active sessions for the database engine.
If the number of active sessions is less than an internal Performance Insights threshold, db.load.avg
and db.sampledload.avg
are the same value. If the number of active sessions is greater than the internal threshold, Performance Insights samples the active sessions, with db.load.avg
showing the scaled values, db.sampledload.avg
showing the raw values, and db.sampledload.avg
less than db.load.avg
. For most use cases, you can query db.load.avg
only.
The name of the dimension group. Valid values are as follows:
db
- The name of the database to which the client is connected. The following values are permitted:
Aurora PostgreSQL
Amazon RDS PostgreSQL
Aurora MySQL
Amazon RDS MySQL
Amazon RDS MariaDB
Amazon DocumentDB
db.application
- The name of the application that is connected to the database. The following values are permitted:
Aurora PostgreSQL
Amazon RDS PostgreSQL
Amazon DocumentDB
db.host
- The host name of the connected client (all engines).
db.query
- The query that is currently running (only Amazon DocumentDB).
db.query_tokenized
- The digest query (only Amazon DocumentDB).
db.session_type
- The type of the current session (only Aurora PostgreSQL and RDS PostgreSQL).
db.sql
- The text of the SQL statement that is currently running (all engines except Amazon DocumentDB).
db.sql_tokenized
- The SQL digest (all engines except Amazon DocumentDB).
db.user
- The user logged in to the database (all engines except Amazon DocumentDB).
db.wait_event
- The event for which the database backend is waiting (all engines except Amazon DocumentDB).
db.wait_event_type
- The type of event for which the database backend is waiting (all engines except Amazon DocumentDB).
db.wait_state
- The event for which the database backend is waiting (only Amazon DocumentDB).
The name of the dimension group. Performance Insights searches the specified group for the dimension group ID. The following group name values are valid:
db.query
(Amazon DocumentDB only)
db.sql
(Amazon RDS and Aurora only)
The ID of the dimension group from which to retrieve dimension details. For dimension group db.sql
, the group ID is db.sql.id
. The following group ID values are valid:
db.sql.id
for dimension group db.sql
(Aurora and RDS only)
db.query.id
for dimension group db.query
(DocumentDB only)
An immutable identifier for a data source that is unique for an Amazon Web Services Region. Performance Insights gathers metrics from this data source. To use a DB instance as a data source, specify its DbiResourceId
value. For example, specify db-ABCDEFGHIJKLMNOPQRSTU1VW2X
.
An immutable identifier for a data source that is unique for an Amazon Web Services Region. Performance Insights gathers metrics from this data source. In the console, the identifier is shown as ResourceID. When you call DescribeDBInstances
, the identifier is returned as DbiResourceId
.
To use a DB instance as a data source, specify its DbiResourceId
value. For example, specify db-ABCDEFGHIJKLMNOPQRSTU1VW2X
.
An immutable identifier for a data source that is unique within an Amazon Web Services Region. Performance Insights gathers metrics from this data source. To use an Amazon RDS DB instance as a data source, specify its DbiResourceId
value. For example, specify db-ABCDEFGHIJKLMNOPQRSTU1VWZ
.
An immutable identifier for a data source that is unique within an Amazon Web Services Region. Performance Insights gathers metrics from this data source. To use an Amazon RDS DB instance as a data source, specify its DbiResourceId
value. For example, specify db-ABCDEFGHIJKLMNOPQRSTU1VWZ
.
The name of a Performance Insights metric to be measured.
Valid values for Metric
are:
db.load.avg
- A scaled representation of the number of active sessions for the database engine.
db.sampledload.avg
- The raw number of active sessions for the database engine.
The counter metrics listed in Performance Insights operating system counters in the Amazon Aurora User Guide.
If the number of active sessions is less than an internal Performance Insights threshold, db.load.avg
and db.sampledload.avg
are the same value. If the number of active sessions is greater than the internal threshold, Performance Insights samples the active sessions, with db.load.avg
showing the scaled values, db.sampledload.avg
showing the raw values, and db.sampledload.avg
less than db.load.avg
. For most use cases, you can query db.load.avg
only.
List the tags for the Amazon Web Services service for which Performance Insights returns metrics. Valid values are as follows:
RDS
DOCDB
The Amazon Web Services service for which Performance Insights will return metrics. Valid value is RDS
.
The Amazon Web Services service for which Performance Insights will return metrics. Valid value is RDS
.
The Amazon Web Services service for which Performance Insights will return metrics. Valid values are as follows:
RDS
DOCDB
The Amazon Web Services service for which Performance Insights returns data. The only valid value is RDS
.
The Amazon Web Services service for which Performance Insights will return metrics. Valid value is RDS
.
The Amazon Web Services service for which Performance Insights returns metrics.
", "GetResourceMetricsRequest$ServiceType": "The Amazon Web Services service for which Performance Insights returns metrics. Valid values are as follows:
RDS
DOCDB
The Amazon Web Services service for which Performance Insights returns metrics.
", - "ListAvailableResourceMetricsRequest$ServiceType": "The Amazon Web Services service for which Performance Insights returns metrics.
" + "ListAvailableResourceMetricsRequest$ServiceType": "The Amazon Web Services service for which Performance Insights returns metrics.
", + "ListPerformanceAnalysisReportsRequest$ServiceType": "The Amazon Web Services service for which Performance Insights returns metrics. Valid value is RDS
.
List the tags for the Amazon Web Services service for which Performance Insights returns metrics. Valid value is RDS
.
The Amazon Web Services service for which Performance Insights returns metrics. Valid value is RDS
.
List the tags for the Amazon Web Services service for which Performance Insights returns metrics. Valid value is RDS
.
The severity of the insight. The values are: Low
, Medium
, or High
.
The name of the analysis report.
", "DimensionDetail$Identifier": "The identifier of a dimension.
", "DimensionGroupDetail$Group": "The name of the dimension group.
", "DimensionKeyDetail$Value": "The value of the dimension detail data. Depending on the return status, this value is either the full or truncated SQL query for the following dimensions:
db.query.statement
(Amazon DocumentDB)
db.sql.statement
(Amazon RDS and Aurora)
An immutable identifier for a data source that is unique for an Amazon Web Services Region. Performance Insights gathers metrics from this data source. To use a DB instance as a data source, specify its DbiResourceId
value. For example, specify db-ABCDEFGHIJKLMNOPQRSTU1VW2X
.
An immutable identifier for a data source that is unique for an Amazon Web Services Region. Performance Insights gathers metrics from this data source. In the console, the identifier is shown as ResourceID. When you call DescribeDBInstances
, the identifier is returned as DbiResourceId
.
The unique identifier for the insight. For example, insight-12345678901234567
.
The type of insight. For example, HighDBLoad
, HighCPU
, or DominatingSQLs
.
The metric type to which the dimension information belongs.
", + "Recommendation$RecommendationId": "The unique identifier for the recommendation.
", "ResponseResourceMetric$Metric": "The full name of the metric.
", "ResponseResourceMetric$Unit": "The unit of the metric.
", "ResponseResourceMetricKey$Metric": "The name of a Performance Insights metric to be measured.
Valid values for Metric
are:
db.load.avg
- A scaled representation of the number of active sessions for the database engine.
db.sampledload.avg
- The raw number of active sessions for the database engine.
The counter metrics listed in Performance Insights operating system counters in the Amazon Aurora User Guide.
If the number of active sessions is less than an internal Performance Insights threshold, db.load.avg
and db.sampledload.avg
are the same value. If the number of active sessions is greater than the internal threshold, Performance Insights samples the active sessions, with db.load.avg
showing the scaled values, db.sampledload.avg
showing the raw values, and db.sampledload.avg
less than db.load.avg
. For most use cases, you can query db.load.avg
only.
Metadata assigned to an Amazon RDS resource consisting of a key-value pair.
", + "refs": { + "TagList$member": null + } + }, + "TagKey": { + "base": null, + "refs": { + "Tag$Key": "A key is the required name of the tag. The string value can be from 1 to 128 Unicode characters in length and can't be prefixed with aws:
or rds:
. The string can only contain only the set of Unicode letters, digits, white-space, '_', '.', ':', '/', '=', '+', '-', '@' (Java regex: \"^([\\\\p{L}\\\\p{Z}\\\\p{N}_.:/=+\\\\-@]*)$\"
).
The metadata assigned to an Amazon RDS Performance Insights resource consisting of a key-value pair.
" + } + }, + "TagList": { + "base": null, + "refs": { + "AnalysisReportSummary$Tags": "List of all the tags added to the analysis report.
", + "CreatePerformanceAnalysisReportRequest$Tags": "The metadata assigned to the analysis report consisting of a key-value pair.
", + "ListTagsForResourceResponse$Tags": "The metadata assigned to an Amazon RDS resource consisting of a key-value pair.
", + "TagResourceRequest$Tags": "The metadata assigned to an Amazon RDS resource consisting of a key-value pair.
" + } + }, + "TagResourceRequest": { + "base": null, + "refs": { + } + }, + "TagResourceResponse": { + "base": null, + "refs": { + } + }, + "TagValue": { + "base": null, + "refs": { + "Tag$Value": "A value is the optional value of the tag. The string value can be from 1 to 256 Unicode characters in length and can't be prefixed with aws:
or rds:
. The string can only contain only the set of Unicode letters, digits, white-space, '_', '.', ':', '/', '=', '+', '-', '@' (Java regex: \"^([\\\\p{L}\\\\p{Z}\\\\p{N}_.:/=+\\\\-@]*)$\").
Indicates the text format in the report. The options are PLAIN_TEXT
or MARKDOWN
. The default value is plain text
.
Provides an explanation for when a domain can't be transferred.
" + } + }, "Nameserver": { "base": "Name server includes the following elements.
", "refs": { @@ -780,6 +786,13 @@ "ViewBillingRequest$MaxItems": "The number of billing records to be returned.
Default: 20
" } }, + "Password": { + "base": null, + "refs": { + "AcceptDomainTransferFromAnotherAwsAccountRequest$Password": "The password that was returned by the TransferDomainToAnotherAwsAccount request.
", + "TransferDomainToAnotherAwsAccountResponse$Password": "To finish transferring a domain to another Amazon Web Services account, the account that the domain is being transferred to must submit an AcceptDomainTransferFromAnotherAwsAccount request. The request must include the value of the Password
element that was returned in the TransferDomainToAnotherAwsAccount
response.
ID of the request operation.
" + } + }, "Reseller": { "base": null, "refs": { @@ -923,12 +942,10 @@ "String": { "base": null, "refs": { - "AcceptDomainTransferFromAnotherAwsAccountRequest$Password": "The password that was returned by the TransferDomainToAnotherAwsAccount request.
", "DisassociateDelegationSignerFromDomainRequest$Id": "An internal identification number assigned to each DS record after it’s created. You can retrieve it as part of DNSSEC information returned by GetDomainDetail.
", "DnssecKey$Digest": "The delegation signer digest.
Digest is calculated from the public key provided using specified digest algorithm and this digest is the actual value returned from the registry nameservers as the value of DS records.
", "DnssecKey$Id": "An ID assigned to each DS record created by AssociateDelegationSignerToDomain.
", - "DomainSuggestion$Availability": "Whether the domain name is available for registering.
You can register only the domains that are designated as AVAILABLE
.
Valid values:
The domain name is available.
The domain name is reserved under specific conditions.
The domain name is available and can be preordered.
The TLD registry didn't reply with a definitive answer about whether the domain name is available. Route 53 can return this response for a variety of reasons, for example, the registry is performing maintenance. Try again later.
The TLD registry didn't return a response in the expected amount of time. When the response is delayed, it usually takes just a few extra seconds. You can resubmit the request immediately.
The domain name has been reserved for another person or organization.
The domain name is not available.
The domain name is not available.
The domain name is forbidden.
To finish transferring a domain to another Amazon Web Services account, the account that the domain is being transferred to must submit an AcceptDomainTransferFromAnotherAwsAccount request. The request must include the value of the Password
element that was returned in the TransferDomainToAnotherAwsAccount
response.
Whether the domain name is available for registering.
You can register only the domains that are designated as AVAILABLE
.
Valid values:
The domain name is available.
The domain name is reserved under specific conditions.
The domain name is available and can be preordered.
The TLD registry didn't reply with a definitive answer about whether the domain name is available. Route 53 can return this response for a variety of reasons, for example, the registry is performing maintenance. Try again later.
The TLD registry didn't return a response in the expected amount of time. When the response is delayed, it usually takes just a few extra seconds. You can resubmit the request immediately.
The domain name has been reserved for another person or organization.
The domain name is not available.
The domain name is not available.
The domain name is forbidden.
Whether the domain name can be transferred to Route 53.
You can transfer only domains that have a value of TRANSFERABLE
or Transferable
.
Valid values:
The domain name can be transferred to Route 53.
The domain name can't be transferred to Route 53.
Reserved for future use.
The domain already exists in the current Amazon Web Services account.
the domain exists in another Amazon Web Services account.
Premium domain transfer is not supported.
Whether the domain name can be transferred to Route 53.
You can transfer only domains that have a value of TRANSFERABLE
or Transferable
.
Valid values:
The domain name can be transferred to Route 53.
The domain name can't be transferred to Route 53.
Reserved for future use.
The domain already exists in the current Amazon Web Services account.
The domain exists in another Amazon Web Services account.
Premium domain transfer is not supported.
Creates an edge deployment plan, consisting of multiple stages. Each stage may have a different deployment configuration and devices.
", "CreateEdgeDeploymentStage": "Creates a new stage in an existing edge deployment plan.
", "CreateEdgePackagingJob": "Starts a SageMaker Edge Manager model packaging job. Edge Manager will use the model artifacts from the Amazon Simple Storage Service bucket that you specify. After the model has been packaged, Amazon SageMaker saves the resulting artifacts to an S3 bucket that you specify.
", - "CreateEndpoint": "Creates an endpoint using the endpoint configuration specified in the request. SageMaker uses the endpoint to provision resources and deploy models. You create the endpoint configuration with the CreateEndpointConfig API.
Use this API to deploy models using SageMaker hosting services.
For an example that calls this method when deploying a model to SageMaker hosting services, see the Create Endpoint example notebook.
You must not delete an EndpointConfig
that is in use by an endpoint that is live or while the UpdateEndpoint
or CreateEndpoint
operations are being performed on the endpoint. To update an endpoint, you must create a new EndpointConfig
.
The endpoint name must be unique within an Amazon Web Services Region in your Amazon Web Services account.
When it receives the request, SageMaker creates the endpoint, launches the resources (ML compute instances), and deploys the model(s) on them.
When you call CreateEndpoint, a load call is made to DynamoDB to verify that your endpoint configuration exists. When you read data from a DynamoDB table supporting Eventually Consistent Reads
, the response might not reflect the results of a recently completed write operation. The response might include some stale data. If the dependent entities are not yet in DynamoDB, this causes a validation error. If you repeat your read request after a short time, the response should return the latest data. So retry logic is recommended to handle these possible issues. We also recommend that customers call DescribeEndpointConfig before calling CreateEndpoint to minimize the potential impact of a DynamoDB eventually consistent read.
When SageMaker receives the request, it sets the endpoint status to Creating
. After it creates the endpoint, it sets the status to InService
. SageMaker can then process incoming requests for inferences. To check the status of an endpoint, use the DescribeEndpoint API.
If any of the models hosted at this endpoint get model data from an Amazon S3 location, SageMaker uses Amazon Web Services Security Token Service to download model artifacts from the S3 path you provided. Amazon Web Services STS is activated in your Amazon Web Services account by default. If you previously deactivated Amazon Web Services STS for a region, you need to reactivate Amazon Web Services STS for that region. For more information, see Activating and Deactivating Amazon Web Services STS in an Amazon Web Services Region in the Amazon Web Services Identity and Access Management User Guide.
To add the IAM role policies for using this API operation, go to the IAM console, and choose Roles in the left navigation pane. Search the IAM role that you want to grant access to use the CreateEndpoint and CreateEndpointConfig API operations, add the following policies to the role.
Option 1: For a full SageMaker access, search and attach the AmazonSageMakerFullAccess
policy.
Option 2: For granting a limited access to an IAM role, paste the following Action elements manually into the JSON file of the IAM role:
\"Action\": [\"sagemaker:CreateEndpoint\", \"sagemaker:CreateEndpointConfig\"]
\"Resource\": [
\"arn:aws:sagemaker:region:account-id:endpoint/endpointName\"
\"arn:aws:sagemaker:region:account-id:endpoint-config/endpointConfigName\"
]
For more information, see SageMaker API Permissions: Actions, Permissions, and Resources Reference.
Creates an endpoint using the endpoint configuration specified in the request. SageMaker uses the endpoint to provision resources and deploy models. You create the endpoint configuration with the CreateEndpointConfig API.
Use this API to deploy models using SageMaker hosting services.
You must not delete an EndpointConfig
that is in use by an endpoint that is live or while the UpdateEndpoint
or CreateEndpoint
operations are being performed on the endpoint. To update an endpoint, you must create a new EndpointConfig
.
The endpoint name must be unique within an Amazon Web Services Region in your Amazon Web Services account.
When it receives the request, SageMaker creates the endpoint, launches the resources (ML compute instances), and deploys the model(s) on them.
When you call CreateEndpoint, a load call is made to DynamoDB to verify that your endpoint configuration exists. When you read data from a DynamoDB table supporting Eventually Consistent Reads
, the response might not reflect the results of a recently completed write operation. The response might include some stale data. If the dependent entities are not yet in DynamoDB, this causes a validation error. If you repeat your read request after a short time, the response should return the latest data. So retry logic is recommended to handle these possible issues. We also recommend that customers call DescribeEndpointConfig before calling CreateEndpoint to minimize the potential impact of a DynamoDB eventually consistent read.
When SageMaker receives the request, it sets the endpoint status to Creating
. After it creates the endpoint, it sets the status to InService
. SageMaker can then process incoming requests for inferences. To check the status of an endpoint, use the DescribeEndpoint API.
If any of the models hosted at this endpoint get model data from an Amazon S3 location, SageMaker uses Amazon Web Services Security Token Service to download model artifacts from the S3 path you provided. Amazon Web Services STS is activated in your Amazon Web Services account by default. If you previously deactivated Amazon Web Services STS for a region, you need to reactivate Amazon Web Services STS for that region. For more information, see Activating and Deactivating Amazon Web Services STS in an Amazon Web Services Region in the Amazon Web Services Identity and Access Management User Guide.
To add the IAM role policies for using this API operation, go to the IAM console, and choose Roles in the left navigation pane. Search the IAM role that you want to grant access to use the CreateEndpoint and CreateEndpointConfig API operations, add the following policies to the role.
Option 1: For a full SageMaker access, search and attach the AmazonSageMakerFullAccess
policy.
Option 2: For granting a limited access to an IAM role, paste the following Action elements manually into the JSON file of the IAM role:
\"Action\": [\"sagemaker:CreateEndpoint\", \"sagemaker:CreateEndpointConfig\"]
\"Resource\": [
\"arn:aws:sagemaker:region:account-id:endpoint/endpointName\"
\"arn:aws:sagemaker:region:account-id:endpoint-config/endpointConfigName\"
]
For more information, see SageMaker API Permissions: Actions, Permissions, and Resources Reference.
Creates an endpoint configuration that SageMaker hosting services uses to deploy models. In the configuration, you identify one or more models, created using the CreateModel
API, to deploy and the resources that you want SageMaker to provision. Then you call the CreateEndpoint API.
Use this API if you want to use SageMaker hosting services to deploy models into production.
In the request, you define a ProductionVariant
, for each model that you want to deploy. Each ProductionVariant
parameter also describes the resources that you want SageMaker to provision. This includes the number and type of ML compute instances to deploy.
If you are hosting multiple models, you also assign a VariantWeight
to specify how much traffic you want to allocate to each model. For example, suppose that you want to host two models, A and B, and you assign traffic weight 2 for model A and 1 for model B. SageMaker distributes two-thirds of the traffic to Model A, and one-third to model B.
When you call CreateEndpoint, a load call is made to DynamoDB to verify that your endpoint configuration exists. When you read data from a DynamoDB table supporting Eventually Consistent Reads
, the response might not reflect the results of a recently completed write operation. The response might include some stale data. If the dependent entities are not yet in DynamoDB, this causes a validation error. If you repeat your read request after a short time, the response should return the latest data. So retry logic is recommended to handle these possible issues. We also recommend that customers call DescribeEndpointConfig before calling CreateEndpoint to minimize the potential impact of a DynamoDB eventually consistent read.
Creates a SageMaker experiment. An experiment is a collection of trials that are observed, compared and evaluated as a group. A trial is a set of steps, called trial components, that produce a machine learning model.
In the Studio UI, trials are referred to as run groups and trial components are referred to as runs.
The goal of an experiment is to determine the components that produce the best model. Multiple trials are performed, each one isolating and measuring the impact of a change to one or more inputs, while keeping the remaining inputs constant.
When you use SageMaker Studio or the SageMaker Python SDK, all experiments, trials, and trial components are automatically tracked, logged, and indexed. When you use the Amazon Web Services SDK for Python (Boto), you must use the logging APIs provided by the SDK.
You can add tags to experiments, trials, trial components and then use the Search API to search for the tags.
To add a description to an experiment, specify the optional Description
parameter. To add a description later, or to change the description, call the UpdateExperiment API.
To get a list of all your experiments, call the ListExperiments API. To view an experiment's properties, call the DescribeExperiment API. To get a list of all the trials associated with an experiment, call the ListTrials API. To create a trial call the CreateTrial API.
", "CreateFeatureGroup": "Create a new FeatureGroup
. A FeatureGroup
is a group of Features
defined in the FeatureStore
to describe a Record
.
The FeatureGroup
defines the schema and features contained in the FeatureGroup. A FeatureGroup
definition is composed of a list of Features
, a RecordIdentifierFeatureName
, an EventTimeFeatureName
and configurations for its OnlineStore
and OfflineStore
. Check Amazon Web Services service quotas to see the FeatureGroup
s quota for your Amazon Web Services account.
You must include at least one of OnlineStoreConfig
and OfflineStoreConfig
to create a FeatureGroup
.
A list of the instance types that are used to generate inferences in real-time.
" } }, + "RecommendationJobSupportedResponseMIMEType": { + "base": null, + "refs": { + "RecommendationJobSupportedResponseMIMETypes$member": null + } + }, + "RecommendationJobSupportedResponseMIMETypes": { + "base": null, + "refs": { + "RecommendationJobContainerConfig$SupportedResponseMIMETypes": "The supported MIME types for the output data.
" + } + }, "RecommendationJobType": { "base": null, "refs": { @@ -13341,7 +13353,7 @@ "CreateModelExplainabilityJobDefinitionRequest$Tags": "(Optional) An array of key-value pairs. For more information, see Using Cost Allocation Tags in the Amazon Web Services Billing and Cost Management User Guide.
", "CreateModelInput$Tags": "An array of key-value pairs. You can use tags to categorize your Amazon Web Services resources in different ways, for example, by purpose, owner, or environment. For more information, see Tagging Amazon Web Services Resources.
", "CreateModelPackageGroupInput$Tags": "A list of key value pairs associated with the model group. For more information, see Tagging Amazon Web Services resources in the Amazon Web Services General Reference Guide.
", - "CreateModelPackageInput$Tags": "A list of key value pairs associated with the model. For more information, see Tagging Amazon Web Services resources in the Amazon Web Services General Reference Guide.
", + "CreateModelPackageInput$Tags": "A list of key value pairs associated with the model. For more information, see Tagging Amazon Web Services resources in the Amazon Web Services General Reference Guide.
If you supply ModelPackageGroupName
, your model package belongs to the model group you specify and uses the tags associated with the model group. In this case, you cannot supply a tag
argument.
(Optional) An array of key-value pairs. For more information, see Using Cost Allocation Tags in the Amazon Web Services Billing and Cost Management User Guide.
", "CreateMonitoringScheduleRequest$Tags": "(Optional) An array of key-value pairs. For more information, see Using Cost Allocation Tags in the Amazon Web Services Billing and Cost Management User Guide.
", "CreateNotebookInstanceInput$Tags": "An array of key-value pairs. You can use tags to categorize your Amazon Web Services resources in different ways, for example, by purpose, owner, or environment. For more information, see Tagging Amazon Web Services Resources.
", diff --git a/models/endpoints/endpoints.json b/models/endpoints/endpoints.json index 89a1afeb6b1..f249c7a2b0b 100644 --- a/models/endpoints/endpoints.json +++ b/models/endpoints/endpoints.json @@ -1067,6 +1067,7 @@ }, "endpoints" : { "ap-south-1" : { }, + "eu-central-1" : { }, "us-east-1" : { } } }, @@ -8020,12 +8021,60 @@ "eu-west-1" : { }, "eu-west-2" : { }, "eu-west-3" : { }, + "fips-us-east-1" : { + "credentialScope" : { + "region" : "us-east-1" + }, + "deprecated" : true, + "hostname" : "inspector2-fips.us-east-1.amazonaws.com" + }, + "fips-us-east-2" : { + "credentialScope" : { + "region" : "us-east-2" + }, + "deprecated" : true, + "hostname" : "inspector2-fips.us-east-2.amazonaws.com" + }, + "fips-us-west-1" : { + "credentialScope" : { + "region" : "us-west-1" + }, + "deprecated" : true, + "hostname" : "inspector2-fips.us-west-1.amazonaws.com" + }, + "fips-us-west-2" : { + "credentialScope" : { + "region" : "us-west-2" + }, + "deprecated" : true, + "hostname" : "inspector2-fips.us-west-2.amazonaws.com" + }, "me-south-1" : { }, "sa-east-1" : { }, - "us-east-1" : { }, - "us-east-2" : { }, - "us-west-1" : { }, - "us-west-2" : { } + "us-east-1" : { + "variants" : [ { + "hostname" : "inspector2-fips.us-east-1.amazonaws.com", + "tags" : [ "fips" ] + } ] + }, + "us-east-2" : { + "variants" : [ { + "hostname" : "inspector2-fips.us-east-2.amazonaws.com", + "tags" : [ "fips" ] + } ] + }, + "us-west-1" : { + "variants" : [ { + "hostname" : "inspector2-fips.us-west-1.amazonaws.com", + "tags" : [ "fips" ] + } ] + }, + "us-west-2" : { + "variants" : [ { + "hostname" : "inspector2-fips.us-west-2.amazonaws.com", + "tags" : [ "fips" ] + } ] + } } }, "internetmonitor" : { @@ -21603,8 +21652,32 @@ }, "inspector2" : { "endpoints" : { - "us-gov-east-1" : { }, - "us-gov-west-1" : { } + "fips-us-gov-east-1" : { + "credentialScope" : { + "region" : "us-gov-east-1" + }, + "deprecated" : true, + "hostname" : "inspector2-fips.us-gov-east-1.amazonaws.com" + }, + "fips-us-gov-west-1" : { + "credentialScope" : { + "region" : "us-gov-west-1" + }, + "deprecated" : true, + "hostname" : "inspector2-fips.us-gov-west-1.amazonaws.com" + }, + "us-gov-east-1" : { + "variants" : [ { + "hostname" : "inspector2-fips.us-gov-east-1.amazonaws.com", + "tags" : [ "fips" ] + } ] + }, + "us-gov-west-1" : { + "variants" : [ { + "hostname" : "inspector2-fips.us-gov-west-1.amazonaws.com", + "tags" : [ "fips" ] + } ] + } } }, "internetmonitor" : { diff --git a/service/chimesdkmeetings/api.go b/service/chimesdkmeetings/api.go index a932eed2d20..19fc3ea3011 100644 --- a/service/chimesdkmeetings/api.go +++ b/service/chimesdkmeetings/api.go @@ -213,6 +213,12 @@ func (c *ChimeSDKMeetings) BatchUpdateAttendeeCapabilitiesExceptRequest(input *B // - ServiceUnavailableException // The service is currently unavailable. // +// - ServiceFailureException +// The service encountered an unexpected error. +// +// - ThrottlingException +// The number of customer requests exceeds the request rate limit. +// // See also, https://docs.aws.amazon.com/goto/WebAPI/chime-sdk-meetings-2021-07-15/BatchUpdateAttendeeCapabilitiesExcept func (c *ChimeSDKMeetings) BatchUpdateAttendeeCapabilitiesExcept(input *BatchUpdateAttendeeCapabilitiesExceptInput) (*BatchUpdateAttendeeCapabilitiesExceptOutput, error) { req, out := c.BatchUpdateAttendeeCapabilitiesExceptRequest(input) @@ -403,6 +409,9 @@ func (c *ChimeSDKMeetings) CreateMeetingRequest(input *CreateMeetingInput) (req // - BadRequestException // The input parameters don't match the service's restrictions. // +// - ConflictException +// Multiple instances of the same request have been made simultaneously. +// // - ForbiddenException // The client is permanently forbidden from making the request. // @@ -505,6 +514,9 @@ func (c *ChimeSDKMeetings) CreateMeetingWithAttendeesRequest(input *CreateMeetin // - BadRequestException // The input parameters don't match the service's restrictions. // +// - ConflictException +// Multiple instances of the same request have been made simultaneously. +// // - ForbiddenException // The client is permanently forbidden from making the request. // @@ -1158,6 +1170,28 @@ func (c *ChimeSDKMeetings) ListTagsForResourceRequest(input *ListTagsForResource // API operation ListTagsForResource for usage and error information. // // Returned Error Types: +// +// - BadRequestException +// The input parameters don't match the service's restrictions. +// +// - ForbiddenException +// The client is permanently forbidden from making the request. +// +// - UnauthorizedException +// The user isn't authorized to request a resource. +// +// - LimitExceededException +// The request exceeds the resource limit. +// +// - ServiceUnavailableException +// The service is currently unavailable. +// +// - ServiceFailureException +// The service encountered an unexpected error. +// +// - ThrottlingException +// The number of customer requests exceeds the request rate limit. +// // - ResourceNotFoundException // The resource that you want to tag couldn't be found. // @@ -1468,6 +1502,24 @@ func (c *ChimeSDKMeetings) TagResourceRequest(input *TagResourceInput) (req *req // - BadRequestException // The input parameters don't match the service's restrictions. // +// - ForbiddenException +// The client is permanently forbidden from making the request. +// +// - UnauthorizedException +// The user isn't authorized to request a resource. +// +// - LimitExceededException +// The request exceeds the resource limit. +// +// - ServiceUnavailableException +// The service is currently unavailable. +// +// - ServiceFailureException +// The service encountered an unexpected error. +// +// - ThrottlingException +// The number of customer requests exceeds the request rate limit. +// // - ResourceNotFoundException // The resource that you want to tag couldn't be found. // @@ -1577,6 +1629,24 @@ func (c *ChimeSDKMeetings) UntagResourceRequest(input *UntagResourceInput) (req // - BadRequestException // The input parameters don't match the service's restrictions. // +// - ForbiddenException +// The client is permanently forbidden from making the request. +// +// - UnauthorizedException +// The user isn't authorized to request a resource. +// +// - LimitExceededException +// The request exceeds the resource limit. +// +// - ServiceUnavailableException +// The service is currently unavailable. +// +// - ServiceFailureException +// The service encountered an unexpected error. +// +// - ThrottlingException +// The number of customer requests exceeds the request rate limit. +// // - ResourceNotFoundException // The resource that you want to tag couldn't be found. // @@ -1695,6 +1765,12 @@ func (c *ChimeSDKMeetings) UpdateAttendeeCapabilitiesRequest(input *UpdateAttend // - ServiceUnavailableException // The service is currently unavailable. // +// - ServiceFailureException +// The service encountered an unexpected error. +// +// - ThrottlingException +// The number of customer requests exceeds the request rate limit. +// // See also, https://docs.aws.amazon.com/goto/WebAPI/chime-sdk-meetings-2021-07-15/UpdateAttendeeCapabilities func (c *ChimeSDKMeetings) UpdateAttendeeCapabilities(input *UpdateAttendeeCapabilitiesInput) (*UpdateAttendeeCapabilitiesOutput, error) { req, out := c.UpdateAttendeeCapabilitiesRequest(input) diff --git a/service/ec2/api.go b/service/ec2/api.go index c1ddd39b453..e13d0eaf252 100644 --- a/service/ec2/api.go +++ b/service/ec2/api.go @@ -8685,9 +8685,11 @@ func (c *EC2) CreateSubnetCidrReservationRequest(input *CreateSubnetCidrReservat // CreateSubnetCidrReservation API operation for Amazon Elastic Compute Cloud. // -// Creates a subnet CIDR reservation. For information about subnet CIDR reservations, -// see Subnet CIDR reservations (https://docs.aws.amazon.com/vpc/latest/userguide/subnet-cidr-reservation.html) -// in the Amazon Virtual Private Cloud User Guide. +// Creates a subnet CIDR reservation. For more information, see Subnet CIDR +// reservations (https://docs.aws.amazon.com/vpc/latest/userguide/subnet-cidr-reservation.html) +// in the Amazon Virtual Private Cloud User Guide and Assign prefixes to network +// interfaces (https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-prefix-eni.html) +// in the Amazon Elastic Compute Cloud User Guide. // // Returns awserr.Error for service API and SDK errors. Use runtime type assertions // with awserr.Error's Code and Message methods to get detailed information about @@ -12609,10 +12611,19 @@ func (c *EC2) DeleteLaunchTemplateVersionsRequest(input *DeleteLaunchTemplateVer // DeleteLaunchTemplateVersions API operation for Amazon Elastic Compute Cloud. // -// Deletes one or more versions of a launch template. You cannot delete the -// default version of a launch template; you must first assign a different version -// as the default. If the default version is the only version for the launch -// template, you must delete the entire launch template using DeleteLaunchTemplate. +// Deletes one or more versions of a launch template. +// +// You can't delete the default version of a launch template; you must first +// assign a different version as the default. If the default version is the +// only version for the launch template, you must delete the entire launch template +// using DeleteLaunchTemplate. +// +// You can delete up to 200 launch template versions in a single request. To +// delete more than 200 versions in a single request, use DeleteLaunchTemplate, +// which deletes the launch template and all of its versions. +// +// For more information, see Delete a launch template version (https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/manage-launch-template-versions.html#delete-launch-template-version) +// in the EC2 User Guide. // // Returns awserr.Error for service API and SDK errors. Use runtime type assertions // with awserr.Error's Code and Message methods to get detailed information about @@ -69416,9 +69427,7 @@ type CreateFlowLogsInput struct { // in the Amazon VPC User Guide or Transit Gateway Flow Log records (https://docs.aws.amazon.com/vpc/latest/tgw/tgw-flow-logs.html#flow-log-records) // in the Amazon Web Services Transit Gateway Guide. // - // Specify the fields using the ${field-id} format, separated by spaces. For - // the CLI, surround this parameter value with single quotes on Linux or double - // quotes on Windows. + // Specify the fields using the ${field-id} format, separated by spaces. LogFormat *string `type:"string"` // The name of a new or existing CloudWatch Logs log group where Amazon EC2 @@ -74866,18 +74875,13 @@ type CreateSubnetCidrReservationInput struct { // it is UnauthorizedOperation. DryRun *bool `type:"boolean"` - // The type of reservation. + // The type of reservation. The reservation type determines how the reserved + // IP addresses are assigned to resources. // - // The following are valid values: + // * prefix - Amazon Web Services assigns the reserved IP addresses to network + // interfaces. // - // * prefix: The Amazon EC2 Prefix Delegation feature assigns the IP addresses - // to network interfaces that are associated with an instance. For information - // about Prefix Delegation, see Prefix Delegation for Amazon EC2 network - // interfaces (https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-prefix-delegation.html) - // in the Amazon Elastic Compute Cloud User Guide. - // - // * explicit: You manually assign the IP addresses to resources that reside - // in your subnet. + // * explicit - You assign the reserved IP addresses to network interfaces. // // ReservationType is a required field ReservationType *string `type:"string" required:"true" enum:"SubnetCidrReservationType"` @@ -75617,6 +75621,10 @@ type CreateTrafficMirrorSessionInput struct { // // If you do not want to mirror the entire packet, use the PacketLength parameter // to specify the number of bytes in each packet to mirror. + // + // For sessions with Network Load Balancer (NLB) Traffic Mirror targets the + // default PacketLength will be set to 8500. Valid values are 1-8500. Setting + // a PacketLength greater than 8500 will result in an error response. PacketLength *int64 `type:"integer"` // The session number determines the order in which sessions are evaluated when @@ -82180,7 +82188,8 @@ type DeleteLaunchTemplateVersionsInput struct { // not both. LaunchTemplateName *string `min:"3" type:"string"` - // The version numbers of one or more launch template versions to delete. + // The version numbers of one or more launch template versions to delete. You + // can specify up to 200 launch template version numbers. // // Versions is a required field Versions []*string `locationName:"LaunchTemplateVersion" locationNameList:"item" type:"list" required:"true"` @@ -95325,7 +95334,7 @@ type DescribeInstancesInput struct { // * availability-zone - The Availability Zone of the instance. // // * block-device-mapping.attach-time - The attach time for an EBS volume - // mapped to the instance, for example, 2010-09-15T17:15:20.000Z. + // mapped to the instance, for example, 2022-09-15T17:15:20.000Z. // // * block-device-mapping.delete-on-termination - A Boolean that indicates // whether the EBS volume is deleted on instance termination. @@ -95338,14 +95347,38 @@ type DescribeInstancesInput struct { // // * block-device-mapping.volume-id - The volume ID of the EBS volume. // + // * boot-mode - The boot mode that was specified by the AMI (legacy-bios + // | uefi | uefi-preferred). + // // * capacity-reservation-id - The ID of the Capacity Reservation into which // the instance was launched. // + // * capacity-reservation-specification.capacity-reservation-preference - + // The instance's Capacity Reservation preference (open | none). + // + // * capacity-reservation-specification.capacity-reservation-target.capacity-reservation-id + // - The ID of the targeted Capacity Reservation. + // + // * capacity-reservation-specification.capacity-reservation-target.capacity-reservation-resource-group-arn + // - The ARN of the targeted Capacity Reservation group. + // // * client-token - The idempotency token you provided when you launched // the instance. // + // * current-instance-boot-mode - The boot mode that is used to launch the + // instance at launch or start (legacy-bios | uefi). + // // * dns-name - The public DNS name of the instance. // + // * ebs-optimized - A Boolean that indicates whether the instance is optimized + // for Amazon EBS I/O. + // + // * ena-support - A Boolean that indicates whether the instance is enabled + // for enhanced networking with ENA. + // + // * enclave-options.enabled - A Boolean that indicates whether the instance + // is enabled for Amazon Web Services Nitro Enclaves. + // // * hibernation-options.configured - A Boolean that indicates whether the // instance is enabled for hibernation. A value of true means that the instance // is enabled for hibernation. @@ -95359,6 +95392,12 @@ type DescribeInstancesInput struct { // * iam-instance-profile.arn - The instance profile associated with the // instance. Specified as an ARN. // + // * iam-instance-profile.id - The instance profile associated with the instance. + // Specified as an ID. + // + // * iam-instance-profile.name - The instance profile associated with the + // instance. Specified as an name. + // // * image-id - The ID of the image used to launch the instance. // // * instance-id - The ID of the instance. @@ -95383,6 +95422,8 @@ type DescribeInstancesInput struct { // // * ip-address - The public IPv4 address of the instance. // + // * ipv6-address - The IPv6 address of the instance. + // // * kernel-id - The kernel ID. // // * key-name - The name of the key pair used when the instance was launched. @@ -95395,27 +95436,41 @@ type DescribeInstancesInput struct { // You can use a wildcard (*), for example, 2021-09-29T*, which matches an // entire day. // - // * metadata-options.http-tokens - The metadata request authorization state - // (optional | required) + // * license-pool - // - // * metadata-options.http-put-response-hop-limit - The HTTP metadata request - // put response hop limit (integer, possible values 1 to 64) + // * maintenance-options.auto-recovery - The current automatic recovery behavior + // of the instance (disabled | default). // // * metadata-options.http-endpoint - The status of access to the HTTP metadata // endpoint on your instance (enabled | disabled) // + // * metadata-options.http-protocol-ipv4 - Indicates whether the IPv4 endpoint + // is enabled (disabled | enabled). + // + // * metadata-options.http-protocol-ipv6 - Indicates whether the IPv6 endpoint + // is enabled (disabled | enabled). + // + // * metadata-options.http-put-response-hop-limit - The HTTP metadata request + // put response hop limit (integer, possible values 1 to 64) + // + // * metadata-options.http-tokens - The metadata request authorization state + // (optional | required) + // // * metadata-options.instance-metadata-tags - The status of access to instance // tags from the instance metadata (enabled | disabled) // + // * metadata-options.state - The state of the metadata option changes (pending + // | applied). + // // * monitoring-state - Indicates whether detailed monitoring is enabled // (disabled | enabled). // - // * network-interface.addresses.private-ip-address - The private IPv4 address - // associated with the network interface. - // // * network-interface.addresses.primary - Specifies whether the IPv4 address // of the network interface is the primary private IPv4 address. // + // * network-interface.addresses.private-ip-address - The private IPv4 address + // associated with the network interface. + // // * network-interface.addresses.association.public-ip - The ID of the association // of an Elastic IP address (IPv4) with a network interface. // @@ -95507,8 +95562,29 @@ type DescribeInstancesInput struct { // // * platform - The platform. To list only Windows instances, use windows. // + // * platform-details - The platform (Linux/UNIX | Red Hat BYOL Linux | Red + // Hat Enterprise Linux | Red Hat Enterprise Linux with HA | Red Hat Enterprise + // Linux with SQL Server Standard and HA | Red Hat Enterprise Linux with + // SQL Server Enterprise and HA | Red Hat Enterprise Linux with SQL Server + // Standard | Red Hat Enterprise Linux with SQL Server Web | Red Hat Enterprise + // Linux with SQL Server Enterprise | SQL Server Enterprise | SQL Server + // Standard | SQL Server Web | SUSE Linux | Ubuntu Pro | Windows | Windows + // BYOL | Windows with SQL Server Enterprise | Windows with SQL Server Standard + // | Windows with SQL Server Web). + // // * private-dns-name - The private IPv4 DNS name of the instance. // + // * private-dns-name-options.enable-resource-name-dns-a-record - A Boolean + // that indicates whether to respond to DNS queries for instance hostnames + // with DNS A records. + // + // * private-dns-name-options.enable-resource-name-dns-aaaa-record - A Boolean + // that indicates whether to respond to DNS queries for instance hostnames + // with DNS AAAA records. + // + // * private-dns-name-options.hostname-type - The type of hostname (ip-name + // | resource-name). + // // * private-ip-address - The private IPv4 address of the instance. // // * product-code - The product code associated with the AMI used to launch @@ -95564,6 +95640,19 @@ type DescribeInstancesInput struct { // // * tenancy - The tenancy of an instance (dedicated | default | host). // + // * tpm-support - Indicates if the instance is configured for NitroTPM support + // (v2.0). + // + // * usage-operation - The usage operation value for the instance (RunInstances + // | RunInstances:00g0 | RunInstances:0010 | RunInstances:1010 | RunInstances:1014 + // | RunInstances:1110 | RunInstances:0014 | RunInstances:0210 | RunInstances:0110 + // | RunInstances:0100 | RunInstances:0004 | RunInstances:0200 | RunInstances:000g + // | RunInstances:0g00 | RunInstances:0002 | RunInstances:0800 | RunInstances:0102 + // | RunInstances:0006 | RunInstances:0202). + // + // * usage-operation-update-time - The time that the usage operation was + // last updated, for example, 2022-09-15T17:15:20.000Z. + // // * virtualization-type - The virtualization type of the instance (paravirtual // | hvm). // @@ -145835,6 +145924,10 @@ type ModifyTrafficMirrorSessionInput struct { // For example, if you set this value to 100, then the first 100 bytes that // meet the filter criteria are copied to the target. Do not specify this parameter // when you want to mirror the entire packet. + // + // For sessions with Network Load Balancer (NLB) traffic mirror targets, the + // default PacketLength will be set to 8500. Valid values are 1-8500. Setting + // a PacketLength greater than 8500 will result in an error response. PacketLength *int64 `type:"integer"` // The properties that you want to remove from the Traffic Mirror session. diff --git a/service/glue/api.go b/service/glue/api.go index dfc638bde4a..dcc5b0a781d 100644 --- a/service/glue/api.go +++ b/service/glue/api.go @@ -29882,6 +29882,12 @@ type CreateCsvClassifierRequest struct { // A custom symbol to denote what combines content into a single column value. // Must be different from the column delimiter. QuoteSymbol *string `min:"1" type:"string"` + + // Sets the SerDe for processing CSV in the classifier, which will be applied + // in the Data Catalog. Valid values are OpenCSVSerDe, LazySimpleSerDe, and + // None. You can specify the None value when you want the crawler to do the + // detection. + Serde *string `type:"string" enum:"CsvSerdeOption"` } // String returns the string representation. @@ -29978,6 +29984,12 @@ func (s *CreateCsvClassifierRequest) SetQuoteSymbol(v string) *CreateCsvClassifi return s } +// SetSerde sets the Serde field's value. +func (s *CreateCsvClassifierRequest) SetSerde(v string) *CreateCsvClassifierRequest { + s.Serde = &v + return s +} + type CreateCustomEntityTypeInput struct { _ struct{} `type:"structure"` @@ -33561,6 +33573,12 @@ type CsvClassifier struct { // It must be different from the column delimiter. QuoteSymbol *string `min:"1" type:"string"` + // Sets the SerDe for processing CSV in the classifier, which will be applied + // in the Data Catalog. Valid values are OpenCSVSerDe, LazySimpleSerDe, and + // None. You can specify the None value when you want the crawler to do the + // detection. + Serde *string `type:"string" enum:"CsvSerdeOption"` + // The version of this classifier. Version *int64 `type:"long"` } @@ -33649,6 +33667,12 @@ func (s *CsvClassifier) SetQuoteSymbol(v string) *CsvClassifier { return s } +// SetSerde sets the Serde field's value. +func (s *CsvClassifier) SetSerde(v string) *CsvClassifier { + s.Serde = &v + return s +} + // SetVersion sets the Version field's value. func (s *CsvClassifier) SetVersion(v int64) *CsvClassifier { s.Version = &v @@ -70738,6 +70762,12 @@ type UpdateCsvClassifierRequest struct { // A custom symbol to denote what combines content into a single column value. // It must be different from the column delimiter. QuoteSymbol *string `min:"1" type:"string"` + + // Sets the SerDe for processing CSV in the classifier, which will be applied + // in the Data Catalog. Valid values are OpenCSVSerDe, LazySimpleSerDe, and + // None. You can specify the None value when you want the crawler to do the + // detection. + Serde *string `type:"string" enum:"CsvSerdeOption"` } // String returns the string representation. @@ -70834,6 +70864,12 @@ func (s *UpdateCsvClassifierRequest) SetQuoteSymbol(v string) *UpdateCsvClassifi return s } +// SetSerde sets the Serde field's value. +func (s *UpdateCsvClassifierRequest) SetSerde(v string) *UpdateCsvClassifierRequest { + s.Serde = &v + return s +} + type UpdateDataQualityRulesetInput struct { _ struct{} `type:"structure"` @@ -74364,6 +74400,26 @@ func CsvHeaderOption_Values() []string { } } +const ( + // CsvSerdeOptionOpenCsvserDe is a CsvSerdeOption enum value + CsvSerdeOptionOpenCsvserDe = "OpenCSVSerDe" + + // CsvSerdeOptionLazySimpleSerDe is a CsvSerdeOption enum value + CsvSerdeOptionLazySimpleSerDe = "LazySimpleSerDe" + + // CsvSerdeOptionNone is a CsvSerdeOption enum value + CsvSerdeOptionNone = "None" +) + +// CsvSerdeOption_Values returns all elements of the CsvSerdeOption enum +func CsvSerdeOption_Values() []string { + return []string{ + CsvSerdeOptionOpenCsvserDe, + CsvSerdeOptionLazySimpleSerDe, + CsvSerdeOptionNone, + } +} + const ( // DQStopJobOnFailureTimingImmediate is a DQStopJobOnFailureTiming enum value DQStopJobOnFailureTimingImmediate = "Immediate" diff --git a/service/pi/api.go b/service/pi/api.go index 72cd1fcc1cb..d61557d6602 100644 --- a/service/pi/api.go +++ b/service/pi/api.go @@ -10,8 +10,181 @@ import ( "github.com/aws/aws-sdk-go/aws/awsutil" "github.com/aws/aws-sdk-go/aws/request" "github.com/aws/aws-sdk-go/private/protocol" + "github.com/aws/aws-sdk-go/private/protocol/jsonrpc" ) +const opCreatePerformanceAnalysisReport = "CreatePerformanceAnalysisReport" + +// CreatePerformanceAnalysisReportRequest generates a "aws/request.Request" representing the +// client's request for the CreatePerformanceAnalysisReport operation. The "output" return +// value will be populated with the request's response once the request completes +// successfully. +// +// Use "Send" method on the returned Request to send the API call to the service. +// the "output" return value is not valid until after Send returns without error. +// +// See CreatePerformanceAnalysisReport for more information on using the CreatePerformanceAnalysisReport +// API call, and error handling. +// +// This method is useful when you want to inject custom logic or configuration +// into the SDK's request lifecycle. Such as custom headers, or retry logic. +// +// // Example sending a request using the CreatePerformanceAnalysisReportRequest method. +// req, resp := client.CreatePerformanceAnalysisReportRequest(params) +// +// err := req.Send() +// if err == nil { // resp is now filled +// fmt.Println(resp) +// } +// +// See also, https://docs.aws.amazon.com/goto/WebAPI/pi-2018-02-27/CreatePerformanceAnalysisReport +func (c *PI) CreatePerformanceAnalysisReportRequest(input *CreatePerformanceAnalysisReportInput) (req *request.Request, output *CreatePerformanceAnalysisReportOutput) { + op := &request.Operation{ + Name: opCreatePerformanceAnalysisReport, + HTTPMethod: "POST", + HTTPPath: "/", + } + + if input == nil { + input = &CreatePerformanceAnalysisReportInput{} + } + + output = &CreatePerformanceAnalysisReportOutput{} + req = c.newRequest(op, input, output) + return +} + +// CreatePerformanceAnalysisReport API operation for AWS Performance Insights. +// +// Creates a new performance analysis report for a specific time period for +// the DB instance. +// +// Returns awserr.Error for service API and SDK errors. Use runtime type assertions +// with awserr.Error's Code and Message methods to get detailed information about +// the error. +// +// See the AWS API reference guide for AWS Performance Insights's +// API operation CreatePerformanceAnalysisReport for usage and error information. +// +// Returned Error Types: +// +// - InvalidArgumentException +// One of the arguments provided is invalid for this request. +// +// - InternalServiceError +// The request failed due to an unknown error. +// +// - NotAuthorizedException +// The user is not authorized to perform this request. +// +// See also, https://docs.aws.amazon.com/goto/WebAPI/pi-2018-02-27/CreatePerformanceAnalysisReport +func (c *PI) CreatePerformanceAnalysisReport(input *CreatePerformanceAnalysisReportInput) (*CreatePerformanceAnalysisReportOutput, error) { + req, out := c.CreatePerformanceAnalysisReportRequest(input) + return out, req.Send() +} + +// CreatePerformanceAnalysisReportWithContext is the same as CreatePerformanceAnalysisReport with the addition of +// the ability to pass a context and additional request options. +// +// See CreatePerformanceAnalysisReport 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 *PI) CreatePerformanceAnalysisReportWithContext(ctx aws.Context, input *CreatePerformanceAnalysisReportInput, opts ...request.Option) (*CreatePerformanceAnalysisReportOutput, error) { + req, out := c.CreatePerformanceAnalysisReportRequest(input) + req.SetContext(ctx) + req.ApplyOptions(opts...) + return out, req.Send() +} + +const opDeletePerformanceAnalysisReport = "DeletePerformanceAnalysisReport" + +// DeletePerformanceAnalysisReportRequest generates a "aws/request.Request" representing the +// client's request for the DeletePerformanceAnalysisReport operation. The "output" return +// value will be populated with the request's response once the request completes +// successfully. +// +// Use "Send" method on the returned Request to send the API call to the service. +// the "output" return value is not valid until after Send returns without error. +// +// See DeletePerformanceAnalysisReport for more information on using the DeletePerformanceAnalysisReport +// API call, and error handling. +// +// This method is useful when you want to inject custom logic or configuration +// into the SDK's request lifecycle. Such as custom headers, or retry logic. +// +// // Example sending a request using the DeletePerformanceAnalysisReportRequest method. +// req, resp := client.DeletePerformanceAnalysisReportRequest(params) +// +// err := req.Send() +// if err == nil { // resp is now filled +// fmt.Println(resp) +// } +// +// See also, https://docs.aws.amazon.com/goto/WebAPI/pi-2018-02-27/DeletePerformanceAnalysisReport +func (c *PI) DeletePerformanceAnalysisReportRequest(input *DeletePerformanceAnalysisReportInput) (req *request.Request, output *DeletePerformanceAnalysisReportOutput) { + op := &request.Operation{ + Name: opDeletePerformanceAnalysisReport, + HTTPMethod: "POST", + HTTPPath: "/", + } + + if input == nil { + input = &DeletePerformanceAnalysisReportInput{} + } + + output = &DeletePerformanceAnalysisReportOutput{} + req = c.newRequest(op, input, output) + req.Handlers.Unmarshal.Swap(jsonrpc.UnmarshalHandler.Name, protocol.UnmarshalDiscardBodyHandler) + return +} + +// DeletePerformanceAnalysisReport API operation for AWS Performance Insights. +// +// Deletes a performance analysis report. +// +// Returns awserr.Error for service API and SDK errors. Use runtime type assertions +// with awserr.Error's Code and Message methods to get detailed information about +// the error. +// +// See the AWS API reference guide for AWS Performance Insights's +// API operation DeletePerformanceAnalysisReport for usage and error information. +// +// Returned Error Types: +// +// - InvalidArgumentException +// One of the arguments provided is invalid for this request. +// +// - InternalServiceError +// The request failed due to an unknown error. +// +// - NotAuthorizedException +// The user is not authorized to perform this request. +// +// See also, https://docs.aws.amazon.com/goto/WebAPI/pi-2018-02-27/DeletePerformanceAnalysisReport +func (c *PI) DeletePerformanceAnalysisReport(input *DeletePerformanceAnalysisReportInput) (*DeletePerformanceAnalysisReportOutput, error) { + req, out := c.DeletePerformanceAnalysisReportRequest(input) + return out, req.Send() +} + +// DeletePerformanceAnalysisReportWithContext is the same as DeletePerformanceAnalysisReport with the addition of +// the ability to pass a context and additional request options. +// +// See DeletePerformanceAnalysisReport 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 *PI) DeletePerformanceAnalysisReportWithContext(ctx aws.Context, input *DeletePerformanceAnalysisReportInput, opts ...request.Option) (*DeletePerformanceAnalysisReportOutput, error) { + req, out := c.DeletePerformanceAnalysisReportRequest(input) + req.SetContext(ctx) + req.ApplyOptions(opts...) + return out, req.Send() +} + const opDescribeDimensionKeys = "DescribeDimensionKeys" // DescribeDimensionKeysRequest generates a "aws/request.Request" representing the @@ -246,6 +419,93 @@ func (c *PI) GetDimensionKeyDetailsWithContext(ctx aws.Context, input *GetDimens return out, req.Send() } +const opGetPerformanceAnalysisReport = "GetPerformanceAnalysisReport" + +// GetPerformanceAnalysisReportRequest generates a "aws/request.Request" representing the +// client's request for the GetPerformanceAnalysisReport operation. The "output" return +// value will be populated with the request's response once the request completes +// successfully. +// +// Use "Send" method on the returned Request to send the API call to the service. +// the "output" return value is not valid until after Send returns without error. +// +// See GetPerformanceAnalysisReport for more information on using the GetPerformanceAnalysisReport +// API call, and error handling. +// +// This method is useful when you want to inject custom logic or configuration +// into the SDK's request lifecycle. Such as custom headers, or retry logic. +// +// // Example sending a request using the GetPerformanceAnalysisReportRequest method. +// req, resp := client.GetPerformanceAnalysisReportRequest(params) +// +// err := req.Send() +// if err == nil { // resp is now filled +// fmt.Println(resp) +// } +// +// See also, https://docs.aws.amazon.com/goto/WebAPI/pi-2018-02-27/GetPerformanceAnalysisReport +func (c *PI) GetPerformanceAnalysisReportRequest(input *GetPerformanceAnalysisReportInput) (req *request.Request, output *GetPerformanceAnalysisReportOutput) { + op := &request.Operation{ + Name: opGetPerformanceAnalysisReport, + HTTPMethod: "POST", + HTTPPath: "/", + } + + if input == nil { + input = &GetPerformanceAnalysisReportInput{} + } + + output = &GetPerformanceAnalysisReportOutput{} + req = c.newRequest(op, input, output) + return +} + +// GetPerformanceAnalysisReport API operation for AWS Performance Insights. +// +// Retrieves the report including the report ID, status, time details, and the +// insights with recommendations. The report status can be RUNNING, SUCCEEDED, +// or FAILED. The insights include the description and recommendation fields. +// +// Returns awserr.Error for service API and SDK errors. Use runtime type assertions +// with awserr.Error's Code and Message methods to get detailed information about +// the error. +// +// See the AWS API reference guide for AWS Performance Insights's +// API operation GetPerformanceAnalysisReport for usage and error information. +// +// Returned Error Types: +// +// - InvalidArgumentException +// One of the arguments provided is invalid for this request. +// +// - InternalServiceError +// The request failed due to an unknown error. +// +// - NotAuthorizedException +// The user is not authorized to perform this request. +// +// See also, https://docs.aws.amazon.com/goto/WebAPI/pi-2018-02-27/GetPerformanceAnalysisReport +func (c *PI) GetPerformanceAnalysisReport(input *GetPerformanceAnalysisReportInput) (*GetPerformanceAnalysisReportOutput, error) { + req, out := c.GetPerformanceAnalysisReportRequest(input) + return out, req.Send() +} + +// GetPerformanceAnalysisReportWithContext is the same as GetPerformanceAnalysisReport with the addition of +// the ability to pass a context and additional request options. +// +// See GetPerformanceAnalysisReport 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 *PI) GetPerformanceAnalysisReportWithContext(ctx aws.Context, input *GetPerformanceAnalysisReportInput, opts ...request.Option) (*GetPerformanceAnalysisReportOutput, error) { + req, out := c.GetPerformanceAnalysisReportRequest(input) + req.SetContext(ctx) + req.ApplyOptions(opts...) + return out, req.Send() +} + const opGetResourceMetadata = "GetResourceMetadata" // GetResourceMetadataRequest generates a "aws/request.Request" representing the @@ -765,44 +1025,804 @@ func (c *PI) ListAvailableResourceMetricsPagesWithContext(ctx aws.Context, input return p.Err() } -// A timestamp, and a single numerical value, which together represent a measurement -// at a particular point in time. -type DataPoint struct { - _ struct{} `type:"structure"` - - // The time, in epoch format, associated with a particular Value. - // - // Timestamp is a required field - Timestamp *time.Time `type:"timestamp" required:"true"` - - // The actual value associated with a particular Timestamp. - // - // Value is a required field - Value *float64 `type:"double" required:"true"` -} +const opListPerformanceAnalysisReports = "ListPerformanceAnalysisReports" -// String returns the string representation. +// ListPerformanceAnalysisReportsRequest generates a "aws/request.Request" representing the +// client's request for the ListPerformanceAnalysisReports operation. The "output" return +// value will be populated with the request's response once the request completes +// successfully. // -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s DataPoint) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. +// Use "Send" method on the returned Request to send the API call to the service. +// the "output" return value is not valid until after Send returns without error. // -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s DataPoint) GoString() string { - return s.String() -} +// See ListPerformanceAnalysisReports for more information on using the ListPerformanceAnalysisReports +// API call, and error handling. +// +// This method is useful when you want to inject custom logic or configuration +// into the SDK's request lifecycle. Such as custom headers, or retry logic. +// +// // Example sending a request using the ListPerformanceAnalysisReportsRequest method. +// req, resp := client.ListPerformanceAnalysisReportsRequest(params) +// +// err := req.Send() +// if err == nil { // resp is now filled +// fmt.Println(resp) +// } +// +// See also, https://docs.aws.amazon.com/goto/WebAPI/pi-2018-02-27/ListPerformanceAnalysisReports +func (c *PI) ListPerformanceAnalysisReportsRequest(input *ListPerformanceAnalysisReportsInput) (req *request.Request, output *ListPerformanceAnalysisReportsOutput) { + op := &request.Operation{ + Name: opListPerformanceAnalysisReports, + HTTPMethod: "POST", + HTTPPath: "/", + Paginator: &request.Paginator{ + InputTokens: []string{"NextToken"}, + OutputTokens: []string{"NextToken"}, + LimitToken: "MaxResults", + TruncationToken: "", + }, + } -// SetTimestamp sets the Timestamp field's value. -func (s *DataPoint) SetTimestamp(v time.Time) *DataPoint { - s.Timestamp = &v - return s + if input == nil { + input = &ListPerformanceAnalysisReportsInput{} + } + + output = &ListPerformanceAnalysisReportsOutput{} + req = c.newRequest(op, input, output) + return +} + +// ListPerformanceAnalysisReports API operation for AWS Performance Insights. +// +// Lists all the analysis reports created for the DB instance. The reports are +// sorted based on the start time of each report. +// +// Returns awserr.Error for service API and SDK errors. Use runtime type assertions +// with awserr.Error's Code and Message methods to get detailed information about +// the error. +// +// See the AWS API reference guide for AWS Performance Insights's +// API operation ListPerformanceAnalysisReports for usage and error information. +// +// Returned Error Types: +// +// - InvalidArgumentException +// One of the arguments provided is invalid for this request. +// +// - InternalServiceError +// The request failed due to an unknown error. +// +// - NotAuthorizedException +// The user is not authorized to perform this request. +// +// See also, https://docs.aws.amazon.com/goto/WebAPI/pi-2018-02-27/ListPerformanceAnalysisReports +func (c *PI) ListPerformanceAnalysisReports(input *ListPerformanceAnalysisReportsInput) (*ListPerformanceAnalysisReportsOutput, error) { + req, out := c.ListPerformanceAnalysisReportsRequest(input) + return out, req.Send() +} + +// ListPerformanceAnalysisReportsWithContext is the same as ListPerformanceAnalysisReports with the addition of +// the ability to pass a context and additional request options. +// +// See ListPerformanceAnalysisReports 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 *PI) ListPerformanceAnalysisReportsWithContext(ctx aws.Context, input *ListPerformanceAnalysisReportsInput, opts ...request.Option) (*ListPerformanceAnalysisReportsOutput, error) { + req, out := c.ListPerformanceAnalysisReportsRequest(input) + req.SetContext(ctx) + req.ApplyOptions(opts...) + return out, req.Send() +} + +// ListPerformanceAnalysisReportsPages iterates over the pages of a ListPerformanceAnalysisReports operation, +// calling the "fn" function with the response data for each page. To stop +// iterating, return false from the fn function. +// +// See ListPerformanceAnalysisReports method for more information on how to use this operation. +// +// Note: This operation can generate multiple requests to a service. +// +// // Example iterating over at most 3 pages of a ListPerformanceAnalysisReports operation. +// pageNum := 0 +// err := client.ListPerformanceAnalysisReportsPages(params, +// func(page *pi.ListPerformanceAnalysisReportsOutput, lastPage bool) bool { +// pageNum++ +// fmt.Println(page) +// return pageNum <= 3 +// }) +func (c *PI) ListPerformanceAnalysisReportsPages(input *ListPerformanceAnalysisReportsInput, fn func(*ListPerformanceAnalysisReportsOutput, bool) bool) error { + return c.ListPerformanceAnalysisReportsPagesWithContext(aws.BackgroundContext(), input, fn) +} + +// ListPerformanceAnalysisReportsPagesWithContext same as ListPerformanceAnalysisReportsPages except +// it takes a Context and allows setting request options on the pages. +// +// The context must be non-nil and will be used for request cancellation. If +// the context is nil a panic will occur. In the future the SDK may create +// sub-contexts for http.Requests. See https://golang.org/pkg/context/ +// for more information on using Contexts. +func (c *PI) ListPerformanceAnalysisReportsPagesWithContext(ctx aws.Context, input *ListPerformanceAnalysisReportsInput, fn func(*ListPerformanceAnalysisReportsOutput, bool) bool, opts ...request.Option) error { + p := request.Pagination{ + NewRequest: func() (*request.Request, error) { + var inCpy *ListPerformanceAnalysisReportsInput + if input != nil { + tmp := *input + inCpy = &tmp + } + req, _ := c.ListPerformanceAnalysisReportsRequest(inCpy) + req.SetContext(ctx) + req.ApplyOptions(opts...) + return req, nil + }, + } + + for p.Next() { + if !fn(p.Page().(*ListPerformanceAnalysisReportsOutput), !p.HasNextPage()) { + break + } + } + + return p.Err() +} + +const opListTagsForResource = "ListTagsForResource" + +// ListTagsForResourceRequest generates a "aws/request.Request" representing the +// client's request for the ListTagsForResource operation. The "output" return +// value will be populated with the request's response once the request completes +// successfully. +// +// Use "Send" method on the returned Request to send the API call to the service. +// the "output" return value is not valid until after Send returns without error. +// +// See ListTagsForResource for more information on using the ListTagsForResource +// API call, and error handling. +// +// This method is useful when you want to inject custom logic or configuration +// into the SDK's request lifecycle. Such as custom headers, or retry logic. +// +// // Example sending a request using the ListTagsForResourceRequest method. +// req, resp := client.ListTagsForResourceRequest(params) +// +// err := req.Send() +// if err == nil { // resp is now filled +// fmt.Println(resp) +// } +// +// See also, https://docs.aws.amazon.com/goto/WebAPI/pi-2018-02-27/ListTagsForResource +func (c *PI) ListTagsForResourceRequest(input *ListTagsForResourceInput) (req *request.Request, output *ListTagsForResourceOutput) { + op := &request.Operation{ + Name: opListTagsForResource, + HTTPMethod: "POST", + HTTPPath: "/", + } + + if input == nil { + input = &ListTagsForResourceInput{} + } + + output = &ListTagsForResourceOutput{} + req = c.newRequest(op, input, output) + return +} + +// ListTagsForResource API operation for AWS Performance Insights. +// +// Retrieves all the metadata tags associated with Amazon RDS Performance Insights +// resource. +// +// Returns awserr.Error for service API and SDK errors. Use runtime type assertions +// with awserr.Error's Code and Message methods to get detailed information about +// the error. +// +// See the AWS API reference guide for AWS Performance Insights's +// API operation ListTagsForResource for usage and error information. +// +// Returned Error Types: +// +// - InvalidArgumentException +// One of the arguments provided is invalid for this request. +// +// - InternalServiceError +// The request failed due to an unknown error. +// +// - NotAuthorizedException +// The user is not authorized to perform this request. +// +// See also, https://docs.aws.amazon.com/goto/WebAPI/pi-2018-02-27/ListTagsForResource +func (c *PI) ListTagsForResource(input *ListTagsForResourceInput) (*ListTagsForResourceOutput, error) { + req, out := c.ListTagsForResourceRequest(input) + return out, req.Send() +} + +// ListTagsForResourceWithContext is the same as ListTagsForResource with the addition of +// the ability to pass a context and additional request options. +// +// See ListTagsForResource 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 *PI) ListTagsForResourceWithContext(ctx aws.Context, input *ListTagsForResourceInput, opts ...request.Option) (*ListTagsForResourceOutput, error) { + req, out := c.ListTagsForResourceRequest(input) + req.SetContext(ctx) + req.ApplyOptions(opts...) + return out, req.Send() +} + +const opTagResource = "TagResource" + +// TagResourceRequest generates a "aws/request.Request" representing the +// client's request for the TagResource operation. The "output" return +// value will be populated with the request's response once the request completes +// successfully. +// +// Use "Send" method on the returned Request to send the API call to the service. +// the "output" return value is not valid until after Send returns without error. +// +// See TagResource for more information on using the TagResource +// API call, and error handling. +// +// This method is useful when you want to inject custom logic or configuration +// into the SDK's request lifecycle. Such as custom headers, or retry logic. +// +// // Example sending a request using the TagResourceRequest method. +// req, resp := client.TagResourceRequest(params) +// +// err := req.Send() +// if err == nil { // resp is now filled +// fmt.Println(resp) +// } +// +// See also, https://docs.aws.amazon.com/goto/WebAPI/pi-2018-02-27/TagResource +func (c *PI) TagResourceRequest(input *TagResourceInput) (req *request.Request, output *TagResourceOutput) { + op := &request.Operation{ + Name: opTagResource, + HTTPMethod: "POST", + HTTPPath: "/", + } + + if input == nil { + input = &TagResourceInput{} + } + + output = &TagResourceOutput{} + req = c.newRequest(op, input, output) + req.Handlers.Unmarshal.Swap(jsonrpc.UnmarshalHandler.Name, protocol.UnmarshalDiscardBodyHandler) + return +} + +// TagResource API operation for AWS Performance Insights. +// +// Adds metadata tags to the Amazon RDS Performance Insights resource. +// +// Returns awserr.Error for service API and SDK errors. Use runtime type assertions +// with awserr.Error's Code and Message methods to get detailed information about +// the error. +// +// See the AWS API reference guide for AWS Performance Insights's +// API operation TagResource for usage and error information. +// +// Returned Error Types: +// +// - InvalidArgumentException +// One of the arguments provided is invalid for this request. +// +// - InternalServiceError +// The request failed due to an unknown error. +// +// - NotAuthorizedException +// The user is not authorized to perform this request. +// +// See also, https://docs.aws.amazon.com/goto/WebAPI/pi-2018-02-27/TagResource +func (c *PI) TagResource(input *TagResourceInput) (*TagResourceOutput, error) { + req, out := c.TagResourceRequest(input) + return out, req.Send() +} + +// TagResourceWithContext is the same as TagResource with the addition of +// the ability to pass a context and additional request options. +// +// See TagResource 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 *PI) TagResourceWithContext(ctx aws.Context, input *TagResourceInput, opts ...request.Option) (*TagResourceOutput, error) { + req, out := c.TagResourceRequest(input) + req.SetContext(ctx) + req.ApplyOptions(opts...) + return out, req.Send() +} + +const opUntagResource = "UntagResource" + +// UntagResourceRequest generates a "aws/request.Request" representing the +// client's request for the UntagResource operation. The "output" return +// value will be populated with the request's response once the request completes +// successfully. +// +// Use "Send" method on the returned Request to send the API call to the service. +// the "output" return value is not valid until after Send returns without error. +// +// See UntagResource for more information on using the UntagResource +// API call, and error handling. +// +// This method is useful when you want to inject custom logic or configuration +// into the SDK's request lifecycle. Such as custom headers, or retry logic. +// +// // Example sending a request using the UntagResourceRequest method. +// req, resp := client.UntagResourceRequest(params) +// +// err := req.Send() +// if err == nil { // resp is now filled +// fmt.Println(resp) +// } +// +// See also, https://docs.aws.amazon.com/goto/WebAPI/pi-2018-02-27/UntagResource +func (c *PI) UntagResourceRequest(input *UntagResourceInput) (req *request.Request, output *UntagResourceOutput) { + op := &request.Operation{ + Name: opUntagResource, + HTTPMethod: "POST", + HTTPPath: "/", + } + + if input == nil { + input = &UntagResourceInput{} + } + + output = &UntagResourceOutput{} + req = c.newRequest(op, input, output) + req.Handlers.Unmarshal.Swap(jsonrpc.UnmarshalHandler.Name, protocol.UnmarshalDiscardBodyHandler) + return +} + +// UntagResource API operation for AWS Performance Insights. +// +// Deletes the metadata tags from the Amazon RDS Performance Insights resource. +// +// Returns awserr.Error for service API and SDK errors. Use runtime type assertions +// with awserr.Error's Code and Message methods to get detailed information about +// the error. +// +// See the AWS API reference guide for AWS Performance Insights's +// API operation UntagResource for usage and error information. +// +// Returned Error Types: +// +// - InvalidArgumentException +// One of the arguments provided is invalid for this request. +// +// - InternalServiceError +// The request failed due to an unknown error. +// +// - NotAuthorizedException +// The user is not authorized to perform this request. +// +// See also, https://docs.aws.amazon.com/goto/WebAPI/pi-2018-02-27/UntagResource +func (c *PI) UntagResource(input *UntagResourceInput) (*UntagResourceOutput, error) { + req, out := c.UntagResourceRequest(input) + return out, req.Send() +} + +// UntagResourceWithContext is the same as UntagResource with the addition of +// the ability to pass a context and additional request options. +// +// See UntagResource 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 *PI) UntagResourceWithContext(ctx aws.Context, input *UntagResourceInput, opts ...request.Option) (*UntagResourceOutput, error) { + req, out := c.UntagResourceRequest(input) + req.SetContext(ctx) + req.ApplyOptions(opts...) + return out, req.Send() +} + +// Retrieves the summary of the performance analysis report created for a time +// period. +type AnalysisReport struct { + _ struct{} `type:"structure"` + + // The name of the analysis report. + // + // AnalysisReportId is a required field + AnalysisReportId *string `min:"1" type:"string" required:"true"` + + // The time you created the analysis report. + CreateTime *time.Time `type:"timestamp"` + + // The analysis end time in the report. + EndTime *time.Time `type:"timestamp"` + + // The unique identifier of the analysis report. + Identifier *string `type:"string"` + + // The list of identified insights in the analysis report. + Insights []*Insight `type:"list"` + + // List the tags for the Amazon Web Services service for which Performance Insights + // returns metrics. Valid values are as follows: + // + // * RDS + // + // * DOCDB + ServiceType *string `type:"string" enum:"ServiceType"` + + // The analysis start time in the report. + StartTime *time.Time `type:"timestamp"` + + // The status of the created analysis report. + Status *string `type:"string" enum:"AnalysisStatus"` +} + +// String returns the string representation. +// +// API parameter values that are decorated as "sensitive" in the API will not +// be included in the string output. The member name will be present, but the +// value will be replaced with "sensitive". +func (s AnalysisReport) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation. +// +// API parameter values that are decorated as "sensitive" in the API will not +// be included in the string output. The member name will be present, but the +// value will be replaced with "sensitive". +func (s AnalysisReport) GoString() string { + return s.String() +} + +// SetAnalysisReportId sets the AnalysisReportId field's value. +func (s *AnalysisReport) SetAnalysisReportId(v string) *AnalysisReport { + s.AnalysisReportId = &v + return s +} + +// SetCreateTime sets the CreateTime field's value. +func (s *AnalysisReport) SetCreateTime(v time.Time) *AnalysisReport { + s.CreateTime = &v + return s +} + +// SetEndTime sets the EndTime field's value. +func (s *AnalysisReport) SetEndTime(v time.Time) *AnalysisReport { + s.EndTime = &v + return s +} + +// SetIdentifier sets the Identifier field's value. +func (s *AnalysisReport) SetIdentifier(v string) *AnalysisReport { + s.Identifier = &v + return s +} + +// SetInsights sets the Insights field's value. +func (s *AnalysisReport) SetInsights(v []*Insight) *AnalysisReport { + s.Insights = v + return s +} + +// SetServiceType sets the ServiceType field's value. +func (s *AnalysisReport) SetServiceType(v string) *AnalysisReport { + s.ServiceType = &v + return s +} + +// SetStartTime sets the StartTime field's value. +func (s *AnalysisReport) SetStartTime(v time.Time) *AnalysisReport { + s.StartTime = &v + return s +} + +// SetStatus sets the Status field's value. +func (s *AnalysisReport) SetStatus(v string) *AnalysisReport { + s.Status = &v + return s +} + +// Retrieves the details of the performance analysis report. +type AnalysisReportSummary struct { + _ struct{} `type:"structure"` + + // The name of the analysis report. + AnalysisReportId *string `type:"string"` + + // The time you created the analysis report. + CreateTime *time.Time `type:"timestamp"` + + // The end time of the analysis in the report. + EndTime *time.Time `type:"timestamp"` + + // The start time of the analysis in the report. + StartTime *time.Time `type:"timestamp"` + + // The status of the analysis report. + Status *string `type:"string" enum:"AnalysisStatus"` + + // List of all the tags added to the analysis report. + Tags []*Tag `type:"list"` +} + +// String returns the string representation. +// +// API parameter values that are decorated as "sensitive" in the API will not +// be included in the string output. The member name will be present, but the +// value will be replaced with "sensitive". +func (s AnalysisReportSummary) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation. +// +// API parameter values that are decorated as "sensitive" in the API will not +// be included in the string output. The member name will be present, but the +// value will be replaced with "sensitive". +func (s AnalysisReportSummary) GoString() string { + return s.String() +} + +// SetAnalysisReportId sets the AnalysisReportId field's value. +func (s *AnalysisReportSummary) SetAnalysisReportId(v string) *AnalysisReportSummary { + s.AnalysisReportId = &v + return s +} + +// SetCreateTime sets the CreateTime field's value. +func (s *AnalysisReportSummary) SetCreateTime(v time.Time) *AnalysisReportSummary { + s.CreateTime = &v + return s +} + +// SetEndTime sets the EndTime field's value. +func (s *AnalysisReportSummary) SetEndTime(v time.Time) *AnalysisReportSummary { + s.EndTime = &v + return s +} + +// SetStartTime sets the StartTime field's value. +func (s *AnalysisReportSummary) SetStartTime(v time.Time) *AnalysisReportSummary { + s.StartTime = &v + return s +} + +// SetStatus sets the Status field's value. +func (s *AnalysisReportSummary) SetStatus(v string) *AnalysisReportSummary { + s.Status = &v + return s +} + +// SetTags sets the Tags field's value. +func (s *AnalysisReportSummary) SetTags(v []*Tag) *AnalysisReportSummary { + s.Tags = v + return s +} + +type CreatePerformanceAnalysisReportInput struct { + _ struct{} `type:"structure"` + + // The end time defined for the analysis report. + // + // EndTime is a required field + EndTime *time.Time `type:"timestamp" required:"true"` + + // An immutable, Amazon Web Services Region-unique identifier for a data source. + // Performance Insights gathers metrics from this data source. + // + // To use an Amazon RDS instance as a data source, you specify its DbiResourceId + // value. For example, specify db-ADECBTYHKTSAUMUZQYPDS2GW4A. + // + // Identifier is a required field + Identifier *string `type:"string" required:"true"` + + // The Amazon Web Services service for which Performance Insights will return + // metrics. Valid value is RDS. + // + // ServiceType is a required field + ServiceType *string `type:"string" required:"true" enum:"ServiceType"` + + // The start time defined for the analysis report. + // + // StartTime is a required field + StartTime *time.Time `type:"timestamp" required:"true"` + + // The metadata assigned to the analysis report consisting of a key-value pair. + Tags []*Tag `type:"list"` +} + +// String returns the string representation. +// +// API parameter values that are decorated as "sensitive" in the API will not +// be included in the string output. The member name will be present, but the +// value will be replaced with "sensitive". +func (s CreatePerformanceAnalysisReportInput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation. +// +// API parameter values that are decorated as "sensitive" in the API will not +// be included in the string output. The member name will be present, but the +// value will be replaced with "sensitive". +func (s CreatePerformanceAnalysisReportInput) GoString() string { + return s.String() +} + +// Validate inspects the fields of the type to determine if they are valid. +func (s *CreatePerformanceAnalysisReportInput) Validate() error { + invalidParams := request.ErrInvalidParams{Context: "CreatePerformanceAnalysisReportInput"} + if s.EndTime == nil { + invalidParams.Add(request.NewErrParamRequired("EndTime")) + } + if s.Identifier == nil { + invalidParams.Add(request.NewErrParamRequired("Identifier")) + } + if s.ServiceType == nil { + invalidParams.Add(request.NewErrParamRequired("ServiceType")) + } + if s.StartTime == nil { + invalidParams.Add(request.NewErrParamRequired("StartTime")) + } + if s.Tags != nil { + for i, v := range s.Tags { + if v == nil { + continue + } + if err := v.Validate(); err != nil { + invalidParams.AddNested(fmt.Sprintf("%s[%v]", "Tags", i), err.(request.ErrInvalidParams)) + } + } + } + + if invalidParams.Len() > 0 { + return invalidParams + } + return nil +} + +// SetEndTime sets the EndTime field's value. +func (s *CreatePerformanceAnalysisReportInput) SetEndTime(v time.Time) *CreatePerformanceAnalysisReportInput { + s.EndTime = &v + return s +} + +// SetIdentifier sets the Identifier field's value. +func (s *CreatePerformanceAnalysisReportInput) SetIdentifier(v string) *CreatePerformanceAnalysisReportInput { + s.Identifier = &v + return s +} + +// SetServiceType sets the ServiceType field's value. +func (s *CreatePerformanceAnalysisReportInput) SetServiceType(v string) *CreatePerformanceAnalysisReportInput { + s.ServiceType = &v + return s +} + +// SetStartTime sets the StartTime field's value. +func (s *CreatePerformanceAnalysisReportInput) SetStartTime(v time.Time) *CreatePerformanceAnalysisReportInput { + s.StartTime = &v + return s +} + +// SetTags sets the Tags field's value. +func (s *CreatePerformanceAnalysisReportInput) SetTags(v []*Tag) *CreatePerformanceAnalysisReportInput { + s.Tags = v + return s +} + +type CreatePerformanceAnalysisReportOutput struct { + _ struct{} `type:"structure"` + + // A unique identifier for the created analysis report. + AnalysisReportId *string `min:"1" type:"string"` +} + +// String returns the string representation. +// +// API parameter values that are decorated as "sensitive" in the API will not +// be included in the string output. The member name will be present, but the +// value will be replaced with "sensitive". +func (s CreatePerformanceAnalysisReportOutput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation. +// +// API parameter values that are decorated as "sensitive" in the API will not +// be included in the string output. The member name will be present, but the +// value will be replaced with "sensitive". +func (s CreatePerformanceAnalysisReportOutput) GoString() string { + return s.String() +} + +// SetAnalysisReportId sets the AnalysisReportId field's value. +func (s *CreatePerformanceAnalysisReportOutput) SetAnalysisReportId(v string) *CreatePerformanceAnalysisReportOutput { + s.AnalysisReportId = &v + return s +} + +// List of data objects which provide details about source metrics. This field +// can be used to determine the PI metric to render for the insight. This data +// type also includes static values for the metrics for the Insight that were +// calculated and included in text and annotations on the DB load chart. +type Data struct { + _ struct{} `type:"structure"` + + // This field determines the Performance Insights metric to render for the insight. + // The name field refers to a Performance Insights metric. + PerformanceInsightsMetric *PerformanceInsightsMetric `type:"structure"` +} + +// String returns the string representation. +// +// API parameter values that are decorated as "sensitive" in the API will not +// be included in the string output. The member name will be present, but the +// value will be replaced with "sensitive". +func (s Data) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation. +// +// API parameter values that are decorated as "sensitive" in the API will not +// be included in the string output. The member name will be present, but the +// value will be replaced with "sensitive". +func (s Data) GoString() string { + return s.String() +} + +// SetPerformanceInsightsMetric sets the PerformanceInsightsMetric field's value. +func (s *Data) SetPerformanceInsightsMetric(v *PerformanceInsightsMetric) *Data { + s.PerformanceInsightsMetric = v + return s +} + +// A timestamp, and a single numerical value, which together represent a measurement +// at a particular point in time. +type DataPoint struct { + _ struct{} `type:"structure"` + + // The time, in epoch format, associated with a particular Value. + // + // Timestamp is a required field + Timestamp *time.Time `type:"timestamp" required:"true"` + + // The actual value associated with a particular Timestamp. + // + // Value is a required field + Value *float64 `type:"double" required:"true"` +} + +// String returns the string representation. +// +// API parameter values that are decorated as "sensitive" in the API will not +// be included in the string output. The member name will be present, but the +// value will be replaced with "sensitive". +func (s DataPoint) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation. +// +// API parameter values that are decorated as "sensitive" in the API will not +// be included in the string output. The member name will be present, but the +// value will be replaced with "sensitive". +func (s DataPoint) GoString() string { + return s.String() +} + +// SetTimestamp sets the Timestamp field's value. +func (s *DataPoint) SetTimestamp(v time.Time) *DataPoint { + s.Timestamp = &v + return s } // SetValue sets the Value field's value. @@ -811,6 +1831,112 @@ func (s *DataPoint) SetValue(v float64) *DataPoint { return s } +type DeletePerformanceAnalysisReportInput struct { + _ struct{} `type:"structure"` + + // The unique identifier of the analysis report for deletion. + // + // AnalysisReportId is a required field + AnalysisReportId *string `min:"1" type:"string" required:"true"` + + // An immutable identifier for a data source that is unique for an Amazon Web + // Services Region. Performance Insights gathers metrics from this data source. + // In the console, the identifier is shown as ResourceID. When you call DescribeDBInstances, + // the identifier is returned as DbiResourceId. + // + // To use a DB instance as a data source, specify its DbiResourceId value. For + // example, specify db-ABCDEFGHIJKLMNOPQRSTU1VW2X. + // + // Identifier is a required field + Identifier *string `type:"string" required:"true"` + + // The Amazon Web Services service for which Performance Insights will return + // metrics. Valid value is RDS. + // + // ServiceType is a required field + ServiceType *string `type:"string" required:"true" enum:"ServiceType"` +} + +// String returns the string representation. +// +// API parameter values that are decorated as "sensitive" in the API will not +// be included in the string output. The member name will be present, but the +// value will be replaced with "sensitive". +func (s DeletePerformanceAnalysisReportInput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation. +// +// API parameter values that are decorated as "sensitive" in the API will not +// be included in the string output. The member name will be present, but the +// value will be replaced with "sensitive". +func (s DeletePerformanceAnalysisReportInput) GoString() string { + return s.String() +} + +// Validate inspects the fields of the type to determine if they are valid. +func (s *DeletePerformanceAnalysisReportInput) Validate() error { + invalidParams := request.ErrInvalidParams{Context: "DeletePerformanceAnalysisReportInput"} + if s.AnalysisReportId == nil { + invalidParams.Add(request.NewErrParamRequired("AnalysisReportId")) + } + if s.AnalysisReportId != nil && len(*s.AnalysisReportId) < 1 { + invalidParams.Add(request.NewErrParamMinLen("AnalysisReportId", 1)) + } + if s.Identifier == nil { + invalidParams.Add(request.NewErrParamRequired("Identifier")) + } + if s.ServiceType == nil { + invalidParams.Add(request.NewErrParamRequired("ServiceType")) + } + + if invalidParams.Len() > 0 { + return invalidParams + } + return nil +} + +// SetAnalysisReportId sets the AnalysisReportId field's value. +func (s *DeletePerformanceAnalysisReportInput) SetAnalysisReportId(v string) *DeletePerformanceAnalysisReportInput { + s.AnalysisReportId = &v + return s +} + +// SetIdentifier sets the Identifier field's value. +func (s *DeletePerformanceAnalysisReportInput) SetIdentifier(v string) *DeletePerformanceAnalysisReportInput { + s.Identifier = &v + return s +} + +// SetServiceType sets the ServiceType field's value. +func (s *DeletePerformanceAnalysisReportInput) SetServiceType(v string) *DeletePerformanceAnalysisReportInput { + s.ServiceType = &v + return s +} + +type DeletePerformanceAnalysisReportOutput struct { + _ struct{} `type:"structure"` +} + +// String returns the string representation. +// +// API parameter values that are decorated as "sensitive" in the API will not +// be included in the string output. The member name will be present, but the +// value will be replaced with "sensitive". +func (s DeletePerformanceAnalysisReportOutput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation. +// +// API parameter values that are decorated as "sensitive" in the API will not +// be included in the string output. The member name will be present, but the +// value will be replaced with "sensitive". +func (s DeletePerformanceAnalysisReportOutput) GoString() string { + return s.String() +} + type DescribeDimensionKeysInput struct { _ struct{} `type:"structure"` @@ -1746,6 +2872,140 @@ func (s *GetDimensionKeyDetailsOutput) SetDimensions(v []*DimensionKeyDetail) *G return s } +type GetPerformanceAnalysisReportInput struct { + _ struct{} `type:"structure"` + + // The text language in the report. The default language is EN_US (English). + AcceptLanguage *string `type:"string" enum:"AcceptLanguage"` + + // A unique identifier of the created analysis report. For example, report-12345678901234567 + // + // AnalysisReportId is a required field + AnalysisReportId *string `min:"1" type:"string" required:"true"` + + // An immutable identifier for a data source that is unique for an Amazon Web + // Services Region. Performance Insights gathers metrics from this data source. + // In the console, the identifier is shown as ResourceID. When you call DescribeDBInstances, + // the identifier is returned as DbiResourceId. + // + // To use a DB instance as a data source, specify its DbiResourceId value. For + // example, specify db-ABCDEFGHIJKLMNOPQRSTU1VW2X. + // + // Identifier is a required field + Identifier *string `type:"string" required:"true"` + + // The Amazon Web Services service for which Performance Insights will return + // metrics. Valid value is RDS. + // + // ServiceType is a required field + ServiceType *string `type:"string" required:"true" enum:"ServiceType"` + + // Indicates the text format in the report. The options are PLAIN_TEXT or MARKDOWN. + // The default value is plain text. + TextFormat *string `type:"string" enum:"TextFormat"` +} + +// String returns the string representation. +// +// API parameter values that are decorated as "sensitive" in the API will not +// be included in the string output. The member name will be present, but the +// value will be replaced with "sensitive". +func (s GetPerformanceAnalysisReportInput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation. +// +// API parameter values that are decorated as "sensitive" in the API will not +// be included in the string output. The member name will be present, but the +// value will be replaced with "sensitive". +func (s GetPerformanceAnalysisReportInput) GoString() string { + return s.String() +} + +// Validate inspects the fields of the type to determine if they are valid. +func (s *GetPerformanceAnalysisReportInput) Validate() error { + invalidParams := request.ErrInvalidParams{Context: "GetPerformanceAnalysisReportInput"} + if s.AnalysisReportId == nil { + invalidParams.Add(request.NewErrParamRequired("AnalysisReportId")) + } + if s.AnalysisReportId != nil && len(*s.AnalysisReportId) < 1 { + invalidParams.Add(request.NewErrParamMinLen("AnalysisReportId", 1)) + } + if s.Identifier == nil { + invalidParams.Add(request.NewErrParamRequired("Identifier")) + } + if s.ServiceType == nil { + invalidParams.Add(request.NewErrParamRequired("ServiceType")) + } + + if invalidParams.Len() > 0 { + return invalidParams + } + return nil +} + +// SetAcceptLanguage sets the AcceptLanguage field's value. +func (s *GetPerformanceAnalysisReportInput) SetAcceptLanguage(v string) *GetPerformanceAnalysisReportInput { + s.AcceptLanguage = &v + return s +} + +// SetAnalysisReportId sets the AnalysisReportId field's value. +func (s *GetPerformanceAnalysisReportInput) SetAnalysisReportId(v string) *GetPerformanceAnalysisReportInput { + s.AnalysisReportId = &v + return s +} + +// SetIdentifier sets the Identifier field's value. +func (s *GetPerformanceAnalysisReportInput) SetIdentifier(v string) *GetPerformanceAnalysisReportInput { + s.Identifier = &v + return s +} + +// SetServiceType sets the ServiceType field's value. +func (s *GetPerformanceAnalysisReportInput) SetServiceType(v string) *GetPerformanceAnalysisReportInput { + s.ServiceType = &v + return s +} + +// SetTextFormat sets the TextFormat field's value. +func (s *GetPerformanceAnalysisReportInput) SetTextFormat(v string) *GetPerformanceAnalysisReportInput { + s.TextFormat = &v + return s +} + +type GetPerformanceAnalysisReportOutput struct { + _ struct{} `type:"structure"` + + // The summary of the performance analysis report created for a time period. + AnalysisReport *AnalysisReport `type:"structure"` +} + +// String returns the string representation. +// +// API parameter values that are decorated as "sensitive" in the API will not +// be included in the string output. The member name will be present, but the +// value will be replaced with "sensitive". +func (s GetPerformanceAnalysisReportOutput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation. +// +// API parameter values that are decorated as "sensitive" in the API will not +// be included in the string output. The member name will be present, but the +// value will be replaced with "sensitive". +func (s GetPerformanceAnalysisReportOutput) GoString() string { + return s.String() +} + +// SetAnalysisReport sets the AnalysisReport field's value. +func (s *GetPerformanceAnalysisReportOutput) SetAnalysisReport(v *AnalysisReport) *GetPerformanceAnalysisReportOutput { + s.AnalysisReport = v + return s +} + type GetResourceMetadataInput struct { _ struct{} `type:"structure"` @@ -2121,9 +3381,143 @@ func (s *GetResourceMetricsOutput) SetMetricList(v []*MetricKeyDataPoints) *GetR return s } -// SetNextToken sets the NextToken field's value. -func (s *GetResourceMetricsOutput) SetNextToken(v string) *GetResourceMetricsOutput { - s.NextToken = &v +// SetNextToken sets the NextToken field's value. +func (s *GetResourceMetricsOutput) SetNextToken(v string) *GetResourceMetricsOutput { + s.NextToken = &v + return s +} + +// Retrieves the list of performance issues which are identified. +type Insight struct { + _ struct{} `type:"structure"` + + // Metric names and values from the timeframe used as baseline to generate the + // insight. + BaselineData []*Data `type:"list"` + + // Indicates if the insight is causal or correlated insight. + Context *string `type:"string" enum:"ContextType"` + + // Description of the insight. For example: A high severity Insight found between + // 02:00 to 02:30, where there was an unusually high DB load 600x above baseline. + // Likely performance impact. + // + // Description is a sensitive parameter and its value will be + // replaced with "sensitive" in string returned by Insight's + // String and GoString methods. + Description *string `type:"string" sensitive:"true"` + + // The end time of the insight. For example, 2018-10-30T00:00:00Z. + EndTime *time.Time `type:"timestamp"` + + // List of data objects containing metrics and references from the time range + // while generating the insight. + InsightData []*Data `type:"list"` + + // The unique identifier for the insight. For example, insight-12345678901234567. + // + // InsightId is a required field + InsightId *string `type:"string" required:"true"` + + // The type of insight. For example, HighDBLoad, HighCPU, or DominatingSQLs. + InsightType *string `type:"string"` + + // List of recommendations for the insight. For example, Investigate the following + // SQLs that contributed to 100% of the total DBLoad during that time period: + // sql-id. + Recommendations []*Recommendation `type:"list"` + + // The severity of the insight. The values are: Low, Medium, or High. + Severity *string `type:"string" enum:"Severity"` + + // The start time of the insight. For example, 2018-10-30T00:00:00Z. + StartTime *time.Time `type:"timestamp"` + + // List of supporting insights that provide additional factors for the insight. + SupportingInsights []*Insight `type:"list"` +} + +// String returns the string representation. +// +// API parameter values that are decorated as "sensitive" in the API will not +// be included in the string output. The member name will be present, but the +// value will be replaced with "sensitive". +func (s Insight) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation. +// +// API parameter values that are decorated as "sensitive" in the API will not +// be included in the string output. The member name will be present, but the +// value will be replaced with "sensitive". +func (s Insight) GoString() string { + return s.String() +} + +// SetBaselineData sets the BaselineData field's value. +func (s *Insight) SetBaselineData(v []*Data) *Insight { + s.BaselineData = v + return s +} + +// SetContext sets the Context field's value. +func (s *Insight) SetContext(v string) *Insight { + s.Context = &v + return s +} + +// SetDescription sets the Description field's value. +func (s *Insight) SetDescription(v string) *Insight { + s.Description = &v + return s +} + +// SetEndTime sets the EndTime field's value. +func (s *Insight) SetEndTime(v time.Time) *Insight { + s.EndTime = &v + return s +} + +// SetInsightData sets the InsightData field's value. +func (s *Insight) SetInsightData(v []*Data) *Insight { + s.InsightData = v + return s +} + +// SetInsightId sets the InsightId field's value. +func (s *Insight) SetInsightId(v string) *Insight { + s.InsightId = &v + return s +} + +// SetInsightType sets the InsightType field's value. +func (s *Insight) SetInsightType(v string) *Insight { + s.InsightType = &v + return s +} + +// SetRecommendations sets the Recommendations field's value. +func (s *Insight) SetRecommendations(v []*Recommendation) *Insight { + s.Recommendations = v + return s +} + +// SetSeverity sets the Severity field's value. +func (s *Insight) SetSeverity(v string) *Insight { + s.Severity = &v + return s +} + +// SetStartTime sets the StartTime field's value. +func (s *Insight) SetStartTime(v time.Time) *Insight { + s.StartTime = &v + return s +} + +// SetSupportingInsights sets the SupportingInsights field's value. +func (s *Insight) SetSupportingInsights(v []*Insight) *Insight { + s.SupportingInsights = v return s } @@ -2558,6 +3952,248 @@ func (s *ListAvailableResourceMetricsOutput) SetNextToken(v string) *ListAvailab return s } +type ListPerformanceAnalysisReportsInput struct { + _ struct{} `type:"structure"` + + // An immutable identifier for a data source that is unique for an Amazon Web + // Services Region. Performance Insights gathers metrics from this data source. + // In the console, the identifier is shown as ResourceID. When you call DescribeDBInstances, + // the identifier is returned as DbiResourceId. + // + // To use a DB instance as a data source, specify its DbiResourceId value. For + // example, specify db-ABCDEFGHIJKLMNOPQRSTU1VW2X. + // + // Identifier is a required field + Identifier *string `type:"string" required:"true"` + + // Specifies whether or not to include the list of tags in the response. + ListTags *bool `type:"boolean"` + + // The maximum number of items to return in the response. If more items exist + // than the specified MaxResults value, a pagination token is included in the + // response so that the remaining results can be retrieved. + MaxResults *int64 `type:"integer"` + + // An optional pagination token provided by a previous request. If this parameter + // is specified, the response includes only records beyond the token, up to + // the value specified by MaxResults. + NextToken *string `min:"1" type:"string"` + + // The Amazon Web Services service for which Performance Insights returns metrics. + // Valid value is RDS. + // + // ServiceType is a required field + ServiceType *string `type:"string" required:"true" enum:"ServiceType"` +} + +// String returns the string representation. +// +// API parameter values that are decorated as "sensitive" in the API will not +// be included in the string output. The member name will be present, but the +// value will be replaced with "sensitive". +func (s ListPerformanceAnalysisReportsInput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation. +// +// API parameter values that are decorated as "sensitive" in the API will not +// be included in the string output. The member name will be present, but the +// value will be replaced with "sensitive". +func (s ListPerformanceAnalysisReportsInput) GoString() string { + return s.String() +} + +// Validate inspects the fields of the type to determine if they are valid. +func (s *ListPerformanceAnalysisReportsInput) Validate() error { + invalidParams := request.ErrInvalidParams{Context: "ListPerformanceAnalysisReportsInput"} + if s.Identifier == nil { + invalidParams.Add(request.NewErrParamRequired("Identifier")) + } + if s.NextToken != nil && len(*s.NextToken) < 1 { + invalidParams.Add(request.NewErrParamMinLen("NextToken", 1)) + } + if s.ServiceType == nil { + invalidParams.Add(request.NewErrParamRequired("ServiceType")) + } + + if invalidParams.Len() > 0 { + return invalidParams + } + return nil +} + +// SetIdentifier sets the Identifier field's value. +func (s *ListPerformanceAnalysisReportsInput) SetIdentifier(v string) *ListPerformanceAnalysisReportsInput { + s.Identifier = &v + return s +} + +// SetListTags sets the ListTags field's value. +func (s *ListPerformanceAnalysisReportsInput) SetListTags(v bool) *ListPerformanceAnalysisReportsInput { + s.ListTags = &v + return s +} + +// SetMaxResults sets the MaxResults field's value. +func (s *ListPerformanceAnalysisReportsInput) SetMaxResults(v int64) *ListPerformanceAnalysisReportsInput { + s.MaxResults = &v + return s +} + +// SetNextToken sets the NextToken field's value. +func (s *ListPerformanceAnalysisReportsInput) SetNextToken(v string) *ListPerformanceAnalysisReportsInput { + s.NextToken = &v + return s +} + +// SetServiceType sets the ServiceType field's value. +func (s *ListPerformanceAnalysisReportsInput) SetServiceType(v string) *ListPerformanceAnalysisReportsInput { + s.ServiceType = &v + return s +} + +type ListPerformanceAnalysisReportsOutput struct { + _ struct{} `type:"structure"` + + // List of reports including the report identifier, start and end time, creation + // time, and status. + AnalysisReports []*AnalysisReportSummary `type:"list"` + + // An optional pagination token provided by a previous request. If this parameter + // is specified, the response includes only records beyond the token, up to + // the value specified by MaxResults. + NextToken *string `min:"1" type:"string"` +} + +// String returns the string representation. +// +// API parameter values that are decorated as "sensitive" in the API will not +// be included in the string output. The member name will be present, but the +// value will be replaced with "sensitive". +func (s ListPerformanceAnalysisReportsOutput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation. +// +// API parameter values that are decorated as "sensitive" in the API will not +// be included in the string output. The member name will be present, but the +// value will be replaced with "sensitive". +func (s ListPerformanceAnalysisReportsOutput) GoString() string { + return s.String() +} + +// SetAnalysisReports sets the AnalysisReports field's value. +func (s *ListPerformanceAnalysisReportsOutput) SetAnalysisReports(v []*AnalysisReportSummary) *ListPerformanceAnalysisReportsOutput { + s.AnalysisReports = v + return s +} + +// SetNextToken sets the NextToken field's value. +func (s *ListPerformanceAnalysisReportsOutput) SetNextToken(v string) *ListPerformanceAnalysisReportsOutput { + s.NextToken = &v + return s +} + +type ListTagsForResourceInput struct { + _ struct{} `type:"structure"` + + // Lists all the tags for the Amazon RDS Performance Insights resource. This + // value is an Amazon Resource Name (ARN). For information about creating an + // ARN, see Constructing an RDS Amazon Resource Name (ARN) (https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_Tagging.ARN.html#USER_Tagging.ARN.Constructing). + // + // ResourceARN is a required field + ResourceARN *string `min:"1" type:"string" required:"true"` + + // List the tags for the Amazon Web Services service for which Performance Insights + // returns metrics. Valid value is RDS. + // + // ServiceType is a required field + ServiceType *string `type:"string" required:"true" enum:"ServiceType"` +} + +// String returns the string representation. +// +// API parameter values that are decorated as "sensitive" in the API will not +// be included in the string output. The member name will be present, but the +// value will be replaced with "sensitive". +func (s ListTagsForResourceInput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation. +// +// API parameter values that are decorated as "sensitive" in the API will not +// be included in the string output. The member name will be present, but the +// value will be replaced with "sensitive". +func (s ListTagsForResourceInput) GoString() string { + return s.String() +} + +// Validate inspects the fields of the type to determine if they are valid. +func (s *ListTagsForResourceInput) Validate() error { + invalidParams := request.ErrInvalidParams{Context: "ListTagsForResourceInput"} + if s.ResourceARN == nil { + invalidParams.Add(request.NewErrParamRequired("ResourceARN")) + } + if s.ResourceARN != nil && len(*s.ResourceARN) < 1 { + invalidParams.Add(request.NewErrParamMinLen("ResourceARN", 1)) + } + if s.ServiceType == nil { + invalidParams.Add(request.NewErrParamRequired("ServiceType")) + } + + if invalidParams.Len() > 0 { + return invalidParams + } + return nil +} + +// SetResourceARN sets the ResourceARN field's value. +func (s *ListTagsForResourceInput) SetResourceARN(v string) *ListTagsForResourceInput { + s.ResourceARN = &v + return s +} + +// SetServiceType sets the ServiceType field's value. +func (s *ListTagsForResourceInput) SetServiceType(v string) *ListTagsForResourceInput { + s.ServiceType = &v + return s +} + +type ListTagsForResourceOutput struct { + _ struct{} `type:"structure"` + + // The metadata assigned to an Amazon RDS resource consisting of a key-value + // pair. + Tags []*Tag `type:"list"` +} + +// String returns the string representation. +// +// API parameter values that are decorated as "sensitive" in the API will not +// be included in the string output. The member name will be present, but the +// value will be replaced with "sensitive". +func (s ListTagsForResourceOutput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation. +// +// API parameter values that are decorated as "sensitive" in the API will not +// be included in the string output. The member name will be present, but the +// value will be replaced with "sensitive". +func (s ListTagsForResourceOutput) GoString() string { + return s.String() +} + +// SetTags sets the Tags field's value. +func (s *ListTagsForResourceOutput) SetTags(v []*Tag) *ListTagsForResourceOutput { + s.Tags = v + return s +} + // The available dimension information for a metric type. type MetricDimensionGroups struct { _ struct{} `type:"structure"` @@ -2794,18 +4430,125 @@ func (s *NotAuthorizedException) OrigErr() error { return nil } -func (s *NotAuthorizedException) Error() string { - return fmt.Sprintf("%s: %s", s.Code(), s.Message()) +func (s *NotAuthorizedException) Error() string { + return fmt.Sprintf("%s: %s", s.Code(), s.Message()) +} + +// Status code returns the HTTP status code for the request's response error. +func (s *NotAuthorizedException) StatusCode() int { + return s.RespMetadata.StatusCode +} + +// RequestID returns the service's response RequestID for request. +func (s *NotAuthorizedException) RequestID() string { + return s.RespMetadata.RequestID +} + +// This data type helps to determine Performance Insights metric to render for +// the insight. +type PerformanceInsightsMetric struct { + _ struct{} `type:"structure"` + + // A dimension map that contains the dimensions for this partition. + Dimensions map[string]*string `type:"map"` + + // The Performance Insights metric name. + DisplayName *string `min:"1" type:"string"` + + // The Performance Insights metric. + Metric *string `min:"1" type:"string"` + + // The value of the metric. For example, 9 for db.load.avg. + Value *float64 `type:"double"` +} + +// String returns the string representation. +// +// API parameter values that are decorated as "sensitive" in the API will not +// be included in the string output. The member name will be present, but the +// value will be replaced with "sensitive". +func (s PerformanceInsightsMetric) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation. +// +// API parameter values that are decorated as "sensitive" in the API will not +// be included in the string output. The member name will be present, but the +// value will be replaced with "sensitive". +func (s PerformanceInsightsMetric) GoString() string { + return s.String() +} + +// SetDimensions sets the Dimensions field's value. +func (s *PerformanceInsightsMetric) SetDimensions(v map[string]*string) *PerformanceInsightsMetric { + s.Dimensions = v + return s +} + +// SetDisplayName sets the DisplayName field's value. +func (s *PerformanceInsightsMetric) SetDisplayName(v string) *PerformanceInsightsMetric { + s.DisplayName = &v + return s +} + +// SetMetric sets the Metric field's value. +func (s *PerformanceInsightsMetric) SetMetric(v string) *PerformanceInsightsMetric { + s.Metric = &v + return s +} + +// SetValue sets the Value field's value. +func (s *PerformanceInsightsMetric) SetValue(v float64) *PerformanceInsightsMetric { + s.Value = &v + return s +} + +// The list of recommendations for the insight. +type Recommendation struct { + _ struct{} `type:"structure"` + + // The recommendation details to help resolve the performance issue. For example, + // Investigate the following SQLs that contributed to 100% of the total DBLoad + // during that time period: sql-id + // + // RecommendationDescription is a sensitive parameter and its value will be + // replaced with "sensitive" in string returned by Recommendation's + // String and GoString methods. + RecommendationDescription *string `type:"string" sensitive:"true"` + + // The unique identifier for the recommendation. + RecommendationId *string `type:"string"` +} + +// String returns the string representation. +// +// API parameter values that are decorated as "sensitive" in the API will not +// be included in the string output. The member name will be present, but the +// value will be replaced with "sensitive". +func (s Recommendation) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation. +// +// API parameter values that are decorated as "sensitive" in the API will not +// be included in the string output. The member name will be present, but the +// value will be replaced with "sensitive". +func (s Recommendation) GoString() string { + return s.String() } -// Status code returns the HTTP status code for the request's response error. -func (s *NotAuthorizedException) StatusCode() int { - return s.RespMetadata.StatusCode +// SetRecommendationDescription sets the RecommendationDescription field's value. +func (s *Recommendation) SetRecommendationDescription(v string) *Recommendation { + s.RecommendationDescription = &v + return s } -// RequestID returns the service's response RequestID for request. -func (s *NotAuthorizedException) RequestID() string { - return s.RespMetadata.RequestID +// SetRecommendationId sets the RecommendationId field's value. +func (s *Recommendation) SetRecommendationId(v string) *Recommendation { + s.RecommendationId = &v + return s } // If PartitionBy was specified in a DescribeDimensionKeys request, the dimensions @@ -2956,6 +4699,340 @@ func (s *ResponseResourceMetricKey) SetMetric(v string) *ResponseResourceMetricK return s } +// Metadata assigned to an Amazon RDS resource consisting of a key-value pair. +type Tag struct { + _ struct{} `type:"structure"` + + // A key is the required name of the tag. The string value can be from 1 to + // 128 Unicode characters in length and can't be prefixed with aws: or rds:. + // The string can only contain only the set of Unicode letters, digits, white-space, + // '_', '.', ':', '/', '=', '+', '-', '@' (Java regex: "^([\\p{L}\\p{Z}\\p{N}_.:/=+\\-@]*)$"). + // + // Key is a required field + Key *string `min:"1" type:"string" required:"true"` + + // A value is the optional value of the tag. The string value can be from 1 + // to 256 Unicode characters in length and can't be prefixed with aws: or rds:. + // The string can only contain only the set of Unicode letters, digits, white-space, + // '_', '.', ':', '/', '=', '+', '-', '@' (Java regex: "^([\\p{L}\\p{Z}\\p{N}_.:/=+\\-@]*)$"). + // + // Value is a required field + Value *string `type:"string" required:"true"` +} + +// String returns the string representation. +// +// API parameter values that are decorated as "sensitive" in the API will not +// be included in the string output. The member name will be present, but the +// value will be replaced with "sensitive". +func (s Tag) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation. +// +// API parameter values that are decorated as "sensitive" in the API will not +// be included in the string output. The member name will be present, but the +// value will be replaced with "sensitive". +func (s Tag) GoString() string { + return s.String() +} + +// Validate inspects the fields of the type to determine if they are valid. +func (s *Tag) Validate() error { + invalidParams := request.ErrInvalidParams{Context: "Tag"} + if s.Key == nil { + invalidParams.Add(request.NewErrParamRequired("Key")) + } + if s.Key != nil && len(*s.Key) < 1 { + invalidParams.Add(request.NewErrParamMinLen("Key", 1)) + } + if s.Value == nil { + invalidParams.Add(request.NewErrParamRequired("Value")) + } + + if invalidParams.Len() > 0 { + return invalidParams + } + return nil +} + +// SetKey sets the Key field's value. +func (s *Tag) SetKey(v string) *Tag { + s.Key = &v + return s +} + +// SetValue sets the Value field's value. +func (s *Tag) SetValue(v string) *Tag { + s.Value = &v + return s +} + +type TagResourceInput struct { + _ struct{} `type:"structure"` + + // The Amazon RDS Performance Insights resource that the tags are added to. + // This value is an Amazon Resource Name (ARN). For information about creating + // an ARN, see Constructing an RDS Amazon Resource Name (ARN) (https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_Tagging.ARN.html#USER_Tagging.ARN.Constructing). + // + // ResourceARN is a required field + ResourceARN *string `min:"1" type:"string" required:"true"` + + // The Amazon Web Services service for which Performance Insights returns metrics. + // Valid value is RDS. + // + // ServiceType is a required field + ServiceType *string `type:"string" required:"true" enum:"ServiceType"` + + // The metadata assigned to an Amazon RDS resource consisting of a key-value + // pair. + // + // Tags is a required field + Tags []*Tag `type:"list" required:"true"` +} + +// String returns the string representation. +// +// API parameter values that are decorated as "sensitive" in the API will not +// be included in the string output. The member name will be present, but the +// value will be replaced with "sensitive". +func (s TagResourceInput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation. +// +// API parameter values that are decorated as "sensitive" in the API will not +// be included in the string output. The member name will be present, but the +// value will be replaced with "sensitive". +func (s TagResourceInput) GoString() string { + return s.String() +} + +// Validate inspects the fields of the type to determine if they are valid. +func (s *TagResourceInput) Validate() error { + invalidParams := request.ErrInvalidParams{Context: "TagResourceInput"} + if s.ResourceARN == nil { + invalidParams.Add(request.NewErrParamRequired("ResourceARN")) + } + if s.ResourceARN != nil && len(*s.ResourceARN) < 1 { + invalidParams.Add(request.NewErrParamMinLen("ResourceARN", 1)) + } + if s.ServiceType == nil { + invalidParams.Add(request.NewErrParamRequired("ServiceType")) + } + if s.Tags == nil { + invalidParams.Add(request.NewErrParamRequired("Tags")) + } + if s.Tags != nil { + for i, v := range s.Tags { + if v == nil { + continue + } + if err := v.Validate(); err != nil { + invalidParams.AddNested(fmt.Sprintf("%s[%v]", "Tags", i), err.(request.ErrInvalidParams)) + } + } + } + + if invalidParams.Len() > 0 { + return invalidParams + } + return nil +} + +// SetResourceARN sets the ResourceARN field's value. +func (s *TagResourceInput) SetResourceARN(v string) *TagResourceInput { + s.ResourceARN = &v + return s +} + +// SetServiceType sets the ServiceType field's value. +func (s *TagResourceInput) SetServiceType(v string) *TagResourceInput { + s.ServiceType = &v + return s +} + +// SetTags sets the Tags field's value. +func (s *TagResourceInput) SetTags(v []*Tag) *TagResourceInput { + s.Tags = v + return s +} + +type TagResourceOutput struct { + _ struct{} `type:"structure"` +} + +// String returns the string representation. +// +// API parameter values that are decorated as "sensitive" in the API will not +// be included in the string output. The member name will be present, but the +// value will be replaced with "sensitive". +func (s TagResourceOutput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation. +// +// API parameter values that are decorated as "sensitive" in the API will not +// be included in the string output. The member name will be present, but the +// value will be replaced with "sensitive". +func (s TagResourceOutput) GoString() string { + return s.String() +} + +type UntagResourceInput struct { + _ struct{} `type:"structure"` + + // The Amazon RDS Performance Insights resource that the tags are added to. + // This value is an Amazon Resource Name (ARN). For information about creating + // an ARN, see Constructing an RDS Amazon Resource Name (ARN) (https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_Tagging.ARN.html#USER_Tagging.ARN.Constructing). + // + // ResourceARN is a required field + ResourceARN *string `min:"1" type:"string" required:"true"` + + // List the tags for the Amazon Web Services service for which Performance Insights + // returns metrics. Valid value is RDS. + // + // ServiceType is a required field + ServiceType *string `type:"string" required:"true" enum:"ServiceType"` + + // The metadata assigned to an Amazon RDS Performance Insights resource consisting + // of a key-value pair. + // + // TagKeys is a required field + TagKeys []*string `type:"list" required:"true"` +} + +// String returns the string representation. +// +// API parameter values that are decorated as "sensitive" in the API will not +// be included in the string output. The member name will be present, but the +// value will be replaced with "sensitive". +func (s UntagResourceInput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation. +// +// API parameter values that are decorated as "sensitive" in the API will not +// be included in the string output. The member name will be present, but the +// value will be replaced with "sensitive". +func (s UntagResourceInput) GoString() string { + return s.String() +} + +// Validate inspects the fields of the type to determine if they are valid. +func (s *UntagResourceInput) Validate() error { + invalidParams := request.ErrInvalidParams{Context: "UntagResourceInput"} + if s.ResourceARN == nil { + invalidParams.Add(request.NewErrParamRequired("ResourceARN")) + } + if s.ResourceARN != nil && len(*s.ResourceARN) < 1 { + invalidParams.Add(request.NewErrParamMinLen("ResourceARN", 1)) + } + if s.ServiceType == nil { + invalidParams.Add(request.NewErrParamRequired("ServiceType")) + } + if s.TagKeys == nil { + invalidParams.Add(request.NewErrParamRequired("TagKeys")) + } + + if invalidParams.Len() > 0 { + return invalidParams + } + return nil +} + +// SetResourceARN sets the ResourceARN field's value. +func (s *UntagResourceInput) SetResourceARN(v string) *UntagResourceInput { + s.ResourceARN = &v + return s +} + +// SetServiceType sets the ServiceType field's value. +func (s *UntagResourceInput) SetServiceType(v string) *UntagResourceInput { + s.ServiceType = &v + return s +} + +// SetTagKeys sets the TagKeys field's value. +func (s *UntagResourceInput) SetTagKeys(v []*string) *UntagResourceInput { + s.TagKeys = v + return s +} + +type UntagResourceOutput struct { + _ struct{} `type:"structure"` +} + +// String returns the string representation. +// +// API parameter values that are decorated as "sensitive" in the API will not +// be included in the string output. The member name will be present, but the +// value will be replaced with "sensitive". +func (s UntagResourceOutput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation. +// +// API parameter values that are decorated as "sensitive" in the API will not +// be included in the string output. The member name will be present, but the +// value will be replaced with "sensitive". +func (s UntagResourceOutput) GoString() string { + return s.String() +} + +const ( + // AcceptLanguageEnUs is a AcceptLanguage enum value + AcceptLanguageEnUs = "EN_US" +) + +// AcceptLanguage_Values returns all elements of the AcceptLanguage enum +func AcceptLanguage_Values() []string { + return []string{ + AcceptLanguageEnUs, + } +} + +const ( + // AnalysisStatusRunning is a AnalysisStatus enum value + AnalysisStatusRunning = "RUNNING" + + // AnalysisStatusSucceeded is a AnalysisStatus enum value + AnalysisStatusSucceeded = "SUCCEEDED" + + // AnalysisStatusFailed is a AnalysisStatus enum value + AnalysisStatusFailed = "FAILED" +) + +// AnalysisStatus_Values returns all elements of the AnalysisStatus enum +func AnalysisStatus_Values() []string { + return []string{ + AnalysisStatusRunning, + AnalysisStatusSucceeded, + AnalysisStatusFailed, + } +} + +const ( + // ContextTypeCausal is a ContextType enum value + ContextTypeCausal = "CAUSAL" + + // ContextTypeContextual is a ContextType enum value + ContextTypeContextual = "CONTEXTUAL" +) + +// ContextType_Values returns all elements of the ContextType enum +func ContextType_Values() []string { + return []string{ + ContextTypeCausal, + ContextTypeContextual, + } +} + const ( // DetailStatusAvailable is a DetailStatus enum value DetailStatusAvailable = "AVAILABLE" @@ -3039,3 +5116,39 @@ func ServiceType_Values() []string { ServiceTypeDocdb, } } + +const ( + // SeverityLow is a Severity enum value + SeverityLow = "LOW" + + // SeverityMedium is a Severity enum value + SeverityMedium = "MEDIUM" + + // SeverityHigh is a Severity enum value + SeverityHigh = "HIGH" +) + +// Severity_Values returns all elements of the Severity enum +func Severity_Values() []string { + return []string{ + SeverityLow, + SeverityMedium, + SeverityHigh, + } +} + +const ( + // TextFormatPlainText is a TextFormat enum value + TextFormatPlainText = "PLAIN_TEXT" + + // TextFormatMarkdown is a TextFormat enum value + TextFormatMarkdown = "MARKDOWN" +) + +// TextFormat_Values returns all elements of the TextFormat enum +func TextFormat_Values() []string { + return []string{ + TextFormatPlainText, + TextFormatMarkdown, + } +} diff --git a/service/pi/piiface/interface.go b/service/pi/piiface/interface.go index c02ad978617..c422ae5ecbc 100644 --- a/service/pi/piiface/interface.go +++ b/service/pi/piiface/interface.go @@ -26,7 +26,7 @@ import ( // // myFunc uses an SDK service client to make a request to // // AWS Performance Insights. // func myFunc(svc piiface.PIAPI) bool { -// // Make svc.DescribeDimensionKeys request +// // Make svc.CreatePerformanceAnalysisReport request // } // // func main() { @@ -42,7 +42,7 @@ import ( // type mockPIClient struct { // piiface.PIAPI // } -// func (m *mockPIClient) DescribeDimensionKeys(input *pi.DescribeDimensionKeysInput) (*pi.DescribeDimensionKeysOutput, error) { +// func (m *mockPIClient) CreatePerformanceAnalysisReport(input *pi.CreatePerformanceAnalysisReportInput) (*pi.CreatePerformanceAnalysisReportOutput, error) { // // mock response/functionality // } // @@ -60,6 +60,14 @@ import ( // and waiters. Its suggested to use the pattern above for testing, or using // tooling to generate mocks to satisfy the interfaces. type PIAPI interface { + CreatePerformanceAnalysisReport(*pi.CreatePerformanceAnalysisReportInput) (*pi.CreatePerformanceAnalysisReportOutput, error) + CreatePerformanceAnalysisReportWithContext(aws.Context, *pi.CreatePerformanceAnalysisReportInput, ...request.Option) (*pi.CreatePerformanceAnalysisReportOutput, error) + CreatePerformanceAnalysisReportRequest(*pi.CreatePerformanceAnalysisReportInput) (*request.Request, *pi.CreatePerformanceAnalysisReportOutput) + + DeletePerformanceAnalysisReport(*pi.DeletePerformanceAnalysisReportInput) (*pi.DeletePerformanceAnalysisReportOutput, error) + DeletePerformanceAnalysisReportWithContext(aws.Context, *pi.DeletePerformanceAnalysisReportInput, ...request.Option) (*pi.DeletePerformanceAnalysisReportOutput, error) + DeletePerformanceAnalysisReportRequest(*pi.DeletePerformanceAnalysisReportInput) (*request.Request, *pi.DeletePerformanceAnalysisReportOutput) + DescribeDimensionKeys(*pi.DescribeDimensionKeysInput) (*pi.DescribeDimensionKeysOutput, error) DescribeDimensionKeysWithContext(aws.Context, *pi.DescribeDimensionKeysInput, ...request.Option) (*pi.DescribeDimensionKeysOutput, error) DescribeDimensionKeysRequest(*pi.DescribeDimensionKeysInput) (*request.Request, *pi.DescribeDimensionKeysOutput) @@ -71,6 +79,10 @@ type PIAPI interface { GetDimensionKeyDetailsWithContext(aws.Context, *pi.GetDimensionKeyDetailsInput, ...request.Option) (*pi.GetDimensionKeyDetailsOutput, error) GetDimensionKeyDetailsRequest(*pi.GetDimensionKeyDetailsInput) (*request.Request, *pi.GetDimensionKeyDetailsOutput) + GetPerformanceAnalysisReport(*pi.GetPerformanceAnalysisReportInput) (*pi.GetPerformanceAnalysisReportOutput, error) + GetPerformanceAnalysisReportWithContext(aws.Context, *pi.GetPerformanceAnalysisReportInput, ...request.Option) (*pi.GetPerformanceAnalysisReportOutput, error) + GetPerformanceAnalysisReportRequest(*pi.GetPerformanceAnalysisReportInput) (*request.Request, *pi.GetPerformanceAnalysisReportOutput) + GetResourceMetadata(*pi.GetResourceMetadataInput) (*pi.GetResourceMetadataOutput, error) GetResourceMetadataWithContext(aws.Context, *pi.GetResourceMetadataInput, ...request.Option) (*pi.GetResourceMetadataOutput, error) GetResourceMetadataRequest(*pi.GetResourceMetadataInput) (*request.Request, *pi.GetResourceMetadataOutput) @@ -95,6 +107,25 @@ type PIAPI interface { ListAvailableResourceMetricsPages(*pi.ListAvailableResourceMetricsInput, func(*pi.ListAvailableResourceMetricsOutput, bool) bool) error ListAvailableResourceMetricsPagesWithContext(aws.Context, *pi.ListAvailableResourceMetricsInput, func(*pi.ListAvailableResourceMetricsOutput, bool) bool, ...request.Option) error + + ListPerformanceAnalysisReports(*pi.ListPerformanceAnalysisReportsInput) (*pi.ListPerformanceAnalysisReportsOutput, error) + ListPerformanceAnalysisReportsWithContext(aws.Context, *pi.ListPerformanceAnalysisReportsInput, ...request.Option) (*pi.ListPerformanceAnalysisReportsOutput, error) + ListPerformanceAnalysisReportsRequest(*pi.ListPerformanceAnalysisReportsInput) (*request.Request, *pi.ListPerformanceAnalysisReportsOutput) + + ListPerformanceAnalysisReportsPages(*pi.ListPerformanceAnalysisReportsInput, func(*pi.ListPerformanceAnalysisReportsOutput, bool) bool) error + ListPerformanceAnalysisReportsPagesWithContext(aws.Context, *pi.ListPerformanceAnalysisReportsInput, func(*pi.ListPerformanceAnalysisReportsOutput, bool) bool, ...request.Option) error + + ListTagsForResource(*pi.ListTagsForResourceInput) (*pi.ListTagsForResourceOutput, error) + ListTagsForResourceWithContext(aws.Context, *pi.ListTagsForResourceInput, ...request.Option) (*pi.ListTagsForResourceOutput, error) + ListTagsForResourceRequest(*pi.ListTagsForResourceInput) (*request.Request, *pi.ListTagsForResourceOutput) + + TagResource(*pi.TagResourceInput) (*pi.TagResourceOutput, error) + TagResourceWithContext(aws.Context, *pi.TagResourceInput, ...request.Option) (*pi.TagResourceOutput, error) + TagResourceRequest(*pi.TagResourceInput) (*request.Request, *pi.TagResourceOutput) + + UntagResource(*pi.UntagResourceInput) (*pi.UntagResourceOutput, error) + UntagResourceWithContext(aws.Context, *pi.UntagResourceInput, ...request.Option) (*pi.UntagResourceOutput, error) + UntagResourceRequest(*pi.UntagResourceInput) (*request.Request, *pi.UntagResourceOutput) } var _ PIAPI = (*pi.PI)(nil) diff --git a/service/route53domains/api.go b/service/route53domains/api.go index c47959bce08..d9a6af573d2 100644 --- a/service/route53domains/api.go +++ b/service/route53domains/api.go @@ -3543,8 +3543,12 @@ type AcceptDomainTransferFromAnotherAwsAccountInput struct { // The password that was returned by the TransferDomainToAnotherAwsAccount (https://docs.aws.amazon.com/Route53/latest/APIReference/API_domains_TransferDomainToAnotherAwsAccount.html) // request. // + // Password is a sensitive parameter and its value will be + // replaced with "sensitive" in string returned by AcceptDomainTransferFromAnotherAwsAccountInput's + // String and GoString methods. + // // Password is a required field - Password *string `type:"string" required:"true"` + Password *string `type:"string" required:"true" sensitive:"true"` } // String returns the string representation. @@ -4113,6 +4117,9 @@ func (s *CheckDomainTransferabilityInput) SetDomainName(v string) *CheckDomainTr type CheckDomainTransferabilityOutput struct { _ struct{} `type:"structure"` + // Provides an explanation for when a domain can't be transferred. + Message *string `type:"string"` + // A complex type that contains information about whether the specified domain // can be transferred to Route 53. Transferability *DomainTransferability `type:"structure"` @@ -4136,6 +4143,12 @@ func (s CheckDomainTransferabilityOutput) GoString() string { return s.String() } +// SetMessage sets the Message field's value. +func (s *CheckDomainTransferabilityOutput) SetMessage(v string) *CheckDomainTransferabilityOutput { + s.Message = &v + return s +} + // SetTransferability sets the Transferability field's value. func (s *CheckDomainTransferabilityOutput) SetTransferability(v *DomainTransferability) *CheckDomainTransferabilityOutput { s.Transferability = v @@ -4211,13 +4224,25 @@ type ContactDetail struct { _ struct{} `type:"structure" sensitive:"true"` // First line of the contact's address. - AddressLine1 *string `type:"string"` + // + // AddressLine1 is a sensitive parameter and its value will be + // replaced with "sensitive" in string returned by ContactDetail's + // String and GoString methods. + AddressLine1 *string `type:"string" sensitive:"true"` // Second line of contact's address, if any. - AddressLine2 *string `type:"string"` + // + // AddressLine2 is a sensitive parameter and its value will be + // replaced with "sensitive" in string returned by ContactDetail's + // String and GoString methods. + AddressLine2 *string `type:"string" sensitive:"true"` // The city of the contact's address. - City *string `type:"string"` + // + // City is a sensitive parameter and its value will be + // replaced with "sensitive" in string returned by ContactDetail's + // String and GoString methods. + City *string `type:"string" sensitive:"true"` // Indicates whether the contact is a person, company, association, or public // organization. Note the following: @@ -4235,10 +4260,18 @@ type ContactDetail struct { ContactType *string `type:"string" enum:"ContactType"` // Code for the country of the contact's address. - CountryCode *string `type:"string" enum:"CountryCode"` + // + // CountryCode is a sensitive parameter and its value will be + // replaced with "sensitive" in string returned by ContactDetail's + // String and GoString methods. + CountryCode *string `type:"string" enum:"CountryCode" sensitive:"true"` // Email address of the contact. - Email *string `type:"string"` + // + // Email is a sensitive parameter and its value will be + // replaced with "sensitive" in string returned by ContactDetail's + // String and GoString methods. + Email *string `type:"string" sensitive:"true"` // A list of name-value pairs for parameters required by certain top-level domains. ExtraParams []*ExtraParam `type:"list"` @@ -4248,29 +4281,57 @@ type ContactDetail struct { // Constraints: Phone number must be specified in the format "+[country dialing // code].[number including any area code]". For example, a US phone number might // appear as "+1.1234567890". - Fax *string `type:"string"` + // + // Fax is a sensitive parameter and its value will be + // replaced with "sensitive" in string returned by ContactDetail's + // String and GoString methods. + Fax *string `type:"string" sensitive:"true"` // First name of contact. - FirstName *string `type:"string"` + // + // FirstName is a sensitive parameter and its value will be + // replaced with "sensitive" in string returned by ContactDetail's + // String and GoString methods. + FirstName *string `type:"string" sensitive:"true"` // Last name of contact. - LastName *string `type:"string"` + // + // LastName is a sensitive parameter and its value will be + // replaced with "sensitive" in string returned by ContactDetail's + // String and GoString methods. + LastName *string `type:"string" sensitive:"true"` // Name of the organization for contact types other than PERSON. - OrganizationName *string `type:"string"` + // + // OrganizationName is a sensitive parameter and its value will be + // replaced with "sensitive" in string returned by ContactDetail's + // String and GoString methods. + OrganizationName *string `type:"string" sensitive:"true"` // The phone number of the contact. // // Constraints: Phone number must be specified in the format "+[country dialing // code].[number including any area code>]". For example, a US phone number // might appear as "+1.1234567890". - PhoneNumber *string `type:"string"` + // + // PhoneNumber is a sensitive parameter and its value will be + // replaced with "sensitive" in string returned by ContactDetail's + // String and GoString methods. + PhoneNumber *string `type:"string" sensitive:"true"` // The state or province of the contact's city. - State *string `type:"string"` + // + // State is a sensitive parameter and its value will be + // replaced with "sensitive" in string returned by ContactDetail's + // String and GoString methods. + State *string `type:"string" sensitive:"true"` // The zip or postal code of the contact's address. - ZipCode *string `type:"string"` + // + // ZipCode is a sensitive parameter and its value will be + // replaced with "sensitive" in string returned by ContactDetail's + // String and GoString methods. + ZipCode *string `type:"string" sensitive:"true"` } // String returns the string representation. @@ -5350,7 +5411,7 @@ type DomainTransferability struct { // // DOMAIN_IN_ANOTHER_ACCOUNT // - // the domain exists in another Amazon Web Services account. + // The domain exists in another Amazon Web Services account. // // PREMIUM_DOMAIN // @@ -5389,6 +5450,9 @@ type DuplicateRequest struct { // The request is already in progress for the domain. Message_ *string `locationName:"message" type:"string"` + + // ID of the request operation. + RequestId *string `locationName:"requestId" type:"string"` } // String returns the string representation. @@ -5434,7 +5498,7 @@ func (s *DuplicateRequest) OrigErr() error { } func (s *DuplicateRequest) Error() string { - return fmt.Sprintf("%s: %s", s.Code(), s.Message()) + return fmt.Sprintf("%s: %s\n%s", s.Code(), s.Message(), s.String()) } // Status code returns the HTTP status code for the request's response error. @@ -6013,10 +6077,18 @@ type GetDomainDetailOutput struct { // Email address to contact to report incorrect contact information for a domain, // to report that the domain is being used to send spam, to report that someone // is cybersquatting on a domain name, or report some other type of abuse. - AbuseContactEmail *string `type:"string"` + // + // AbuseContactEmail is a sensitive parameter and its value will be + // replaced with "sensitive" in string returned by GetDomainDetailOutput's + // String and GoString methods. + AbuseContactEmail *string `type:"string" sensitive:"true"` // Phone number for reporting abuse. - AbuseContactPhone *string `type:"string"` + // + // AbuseContactPhone is a sensitive parameter and its value will be + // replaced with "sensitive" in string returned by GetDomainDetailOutput's + // String and GoString methods. + AbuseContactPhone *string `type:"string" sensitive:"true"` // Provides details about the domain administrative contact. // @@ -7992,7 +8064,11 @@ type ResendContactReachabilityEmailOutput struct { // The email address for the registrant contact at the time that we sent the // verification email. - EmailAddress *string `locationName:"emailAddress" type:"string"` + // + // EmailAddress is a sensitive parameter and its value will be + // replaced with "sensitive" in string returned by ResendContactReachabilityEmailOutput's + // String and GoString methods. + EmailAddress *string `locationName:"emailAddress" type:"string" sensitive:"true"` // True if the email address for the registrant contact has already been verified, // and false otherwise. If the email address has already been verified, we don't @@ -8753,7 +8829,11 @@ type TransferDomainToAnotherAwsAccountOutput struct { // (https://docs.aws.amazon.com/Route53/latest/APIReference/API_domains_AcceptDomainTransferFromAnotherAwsAccount.html) // request. The request must include the value of the Password element that // was returned in the TransferDomainToAnotherAwsAccount response. - Password *string `type:"string"` + // + // Password is a sensitive parameter and its value will be + // replaced with "sensitive" in string returned by TransferDomainToAnotherAwsAccountOutput's + // String and GoString methods. + Password *string `type:"string" sensitive:"true"` } // String returns the string representation. @@ -10916,7 +10996,7 @@ func StatusFlag_Values() []string { // // DOMAIN_IN_ANOTHER_ACCOUNT // -// the domain exists in another Amazon Web Services account. +// The domain exists in another Amazon Web Services account. // // PREMIUM_DOMAIN // diff --git a/service/sagemaker/api.go b/service/sagemaker/api.go index 5974a1a0d3b..053227b988c 100644 --- a/service/sagemaker/api.go +++ b/service/sagemaker/api.go @@ -1821,9 +1821,6 @@ func (c *SageMaker) CreateEndpointRequest(input *CreateEndpointInput) (req *requ // // Use this API to deploy models using SageMaker hosting services. // -// For an example that calls this method when deploying a model to SageMaker -// hosting services, see the Create Endpoint example notebook. (https://github.com/aws/amazon-sagemaker-examples/blob/master/sagemaker-fundamentals/create-endpoint/create_endpoint.ipynb) -// // You must not delete an EndpointConfig that is in use by an endpoint that // is live or while the UpdateEndpoint or CreateEndpoint operations are being // performed on the endpoint. To update an endpoint, you must create a new EndpointConfig. @@ -43609,6 +43606,10 @@ type CreateModelPackageInput struct { // A list of key value pairs associated with the model. For more information, // see Tagging Amazon Web Services resources (https://docs.aws.amazon.com/general/latest/gr/aws_tagging.html) // in the Amazon Web Services General Reference Guide. + // + // If you supply ModelPackageGroupName, your model package belongs to the model + // group you specify and uses the tags associated with the model group. In this + // case, you cannot supply a tag argument. Tags []*Tag `type:"list"` // The machine learning task your model package accomplishes. Common machine @@ -100966,6 +100967,9 @@ type RecommendationJobContainerConfig struct { // A list of the instance types that are used to generate inferences in real-time. SupportedInstanceTypes []*string `type:"list"` + // The supported MIME types for the output data. + SupportedResponseMIMETypes []*string `type:"list"` + // The machine learning task that the model accomplishes. // // Valid Values: IMAGE_CLASSIFICATION | OBJECT_DETECTION | TEXT_GENERATION | @@ -101052,6 +101056,12 @@ func (s *RecommendationJobContainerConfig) SetSupportedInstanceTypes(v []*string return s } +// SetSupportedResponseMIMETypes sets the SupportedResponseMIMETypes field's value. +func (s *RecommendationJobContainerConfig) SetSupportedResponseMIMETypes(v []*string) *RecommendationJobContainerConfig { + s.SupportedResponseMIMETypes = v + return s +} + // SetTask sets the Task field's value. func (s *RecommendationJobContainerConfig) SetTask(v string) *RecommendationJobContainerConfig { s.Task = &v