diff --git a/CHANGELOG.md b/CHANGELOG.md index b6ecbadd6a1..3221fa2bd30 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,3 +1,16 @@ +Release v1.40.11 (2021-07-29) +=== + +### Service Client Updates +* `service/chime`: Updates service API and documentation + * Adds support for live transcription of meetings with Amazon Transcribe and Amazon Transcribe Medical. The new APIs, StartMeetingTranscription and StopMeetingTranscription, control the generation of user-attributed transcriptions sent to meeting clients via Amazon Chime SDK data messages. +* `service/ec2`: Updates service API and documentation + * This release adds support for G4ad xlarge and 2xlarge instances powered by AMD Radeon Pro V520 GPUs and AMD 2nd Generation EPYC processors +* `service/iot`: Updates service API and documentation + * Increase maximum credential duration of role alias to 12 hours. +* `service/iotsitewise`: Updates service API and documentation +* `service/savingsplans`: Updates service API + Release v1.40.10 (2021-07-28) === diff --git a/aws/endpoints/defaults.go b/aws/endpoints/defaults.go index d189be5f7fc..3d0cd4d40ae 100644 --- a/aws/endpoints/defaults.go +++ b/aws/endpoints/defaults.go @@ -365,6 +365,30 @@ var awsPartition = partition{ "us-west-2": endpoint{}, }, }, + "amplify": service{ + + Endpoints: endpoints{ + "ap-east-1": endpoint{}, + "ap-northeast-1": endpoint{}, + "ap-northeast-2": endpoint{}, + "ap-south-1": endpoint{}, + "ap-southeast-1": endpoint{}, + "ap-southeast-2": endpoint{}, + "ca-central-1": endpoint{}, + "eu-central-1": endpoint{}, + "eu-north-1": endpoint{}, + "eu-south-1": endpoint{}, + "eu-west-1": endpoint{}, + "eu-west-2": endpoint{}, + "eu-west-3": endpoint{}, + "me-south-1": endpoint{}, + "sa-east-1": endpoint{}, + "us-east-1": endpoint{}, + "us-east-2": endpoint{}, + "us-west-1": endpoint{}, + "us-west-2": endpoint{}, + }, + }, "amplifybackend": service{ Endpoints: endpoints{ @@ -1909,6 +1933,7 @@ var awsPartition = partition{ "ap-east-1": endpoint{}, "ap-northeast-1": endpoint{}, "ap-northeast-2": endpoint{}, + "ap-northeast-3": endpoint{}, "ap-south-1": endpoint{}, "ap-southeast-1": endpoint{}, "ap-southeast-2": endpoint{}, @@ -7825,6 +7850,7 @@ var awscnPartition = partition{ "dax": service{ Endpoints: endpoints{ + "cn-north-1": endpoint{}, "cn-northwest-1": endpoint{}, }, }, @@ -10712,6 +10738,12 @@ var awsisoPartition = partition{ "us-iso-east-1": endpoint{}, }, }, + "license-manager": service{ + + Endpoints: endpoints{ + "us-iso-east-1": endpoint{}, + }, + }, "logs": service{ Endpoints: endpoints{ diff --git a/aws/version.go b/aws/version.go index e5b999a5d5d..e25da67c66b 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.40.10" +const SDKVersion = "1.40.11" diff --git a/models/apis/chime/2018-05-01/api-2.json b/models/apis/chime/2018-05-01/api-2.json index fb28e38a1d5..0871200ec8a 100644 --- a/models/apis/chime/2018-05-01/api-2.json +++ b/models/apis/chime/2018-05-01/api-2.json @@ -3068,6 +3068,47 @@ ], "endpoint":{"hostPrefix":"messaging-"} }, + "StartMeetingTranscription":{ + "name":"StartMeetingTranscription", + "http":{ + "method":"POST", + "requestUri":"/meetings/{meetingId}/transcription?operation=start", + "responseCode":200 + }, + "input":{"shape":"StartMeetingTranscriptionRequest"}, + "output":{"shape":"StartMeetingTranscriptionResponse"}, + "errors":[ + {"shape":"NotFoundException"}, + {"shape":"ForbiddenException"}, + {"shape":"BadRequestException"}, + {"shape":"ResourceLimitExceededException"}, + {"shape":"ThrottledClientException"}, + {"shape":"UnauthorizedClientException"}, + {"shape":"UnprocessableEntityException"}, + {"shape":"ServiceUnavailableException"}, + {"shape":"ServiceFailureException"} + ] + }, + "StopMeetingTranscription":{ + "name":"StopMeetingTranscription", + "http":{ + "method":"POST", + "requestUri":"/meetings/{meetingId}/transcription?operation=stop", + "responseCode":200 + }, + "input":{"shape":"StopMeetingTranscriptionRequest"}, + "output":{"shape":"StopMeetingTranscriptionResponse"}, + "errors":[ + {"shape":"ForbiddenException"}, + {"shape":"NotFoundException"}, + {"shape":"BadRequestException"}, + {"shape":"ThrottledClientException"}, + {"shape":"UnauthorizedClientException"}, + {"shape":"UnprocessableEntityException"}, + {"shape":"ServiceUnavailableException"}, + {"shape":"ServiceFailureException"} + ] + }, "TagAttendee":{ "name":"TagAttendee", "http":{ @@ -5754,6 +5795,32 @@ "DNIS":{"shape":"DNISEmergencyCallingConfigurationList"} } }, + "EngineTranscribeMedicalSettings":{ + "type":"structure", + "required":[ + "LanguageCode", + "Specialty", + "Type" + ], + "members":{ + "LanguageCode":{"shape":"TranscribeMedicalLanguageCode"}, + "Specialty":{"shape":"TranscribeMedicalSpecialty"}, + "Type":{"shape":"TranscribeMedicalType"}, + "VocabularyName":{"shape":"String"}, + "Region":{"shape":"TranscribeMedicalRegion"} + } + }, + "EngineTranscribeSettings":{ + "type":"structure", + "required":["LanguageCode"], + "members":{ + "LanguageCode":{"shape":"TranscribeLanguageCode"}, + "VocabularyFilterMethod":{"shape":"TranscribeVocabularyFilterMethod"}, + "VocabularyFilterName":{"shape":"String"}, + "VocabularyName":{"shape":"String"}, + "Region":{"shape":"TranscribeRegion"} + } + }, "ErrorCode":{ "type":"string", "enum":[ @@ -8602,6 +8669,42 @@ "DESCENDING" ] }, + "StartMeetingTranscriptionRequest":{ + "type":"structure", + "required":[ + "MeetingId", + "TranscriptionConfiguration" + ], + "members":{ + "MeetingId":{ + "shape":"GuidString", + "location":"uri", + "locationName":"meetingId" + }, + "TranscriptionConfiguration":{"shape":"TranscriptionConfiguration"} + } + }, + "StartMeetingTranscriptionResponse":{ + "type":"structure", + "members":{ + } + }, + "StopMeetingTranscriptionRequest":{ + "type":"structure", + "required":["MeetingId"], + "members":{ + "MeetingId":{ + "shape":"GuidString", + "location":"uri", + "locationName":"meetingId" + } + } + }, + "StopMeetingTranscriptionResponse":{ + "type":"structure", + "members":{ + } + }, "StreamingConfiguration":{ "type":"structure", "required":["DataRetentionInHours"], @@ -8761,6 +8864,87 @@ "min":3, "pattern":"^8(00|33|44|55|66|77|88)$" }, + "TranscribeLanguageCode":{ + "type":"string", + "enum":[ + "en-US", + "en-GB", + "es-US", + "fr-CA", + "fr-FR", + "en-AU", + "it-IT", + "de-DE", + "pt-BR", + "ja-JP", + "ko-KR", + "zh-CN" + ] + }, + "TranscribeMedicalLanguageCode":{ + "type":"string", + "enum":["en-US"] + }, + "TranscribeMedicalRegion":{ + "type":"string", + "enum":[ + "us-east-1", + "us-east-2", + "us-west-2", + "ap-southeast-2", + "ca-central-1", + "eu-west-1" + ] + }, + "TranscribeMedicalSpecialty":{ + "type":"string", + "enum":[ + "PRIMARYCARE", + "CARDIOLOGY", + "NEUROLOGY", + "ONCOLOGY", + "RADIOLOGY", + "UROLOGY" + ] + }, + "TranscribeMedicalType":{ + "type":"string", + "enum":[ + "CONVERSATION", + "DICTATION" + ] + }, + "TranscribeRegion":{ + "type":"string", + "enum":[ + "us-east-2", + "us-east-1", + "us-west-2", + "ap-northeast-2", + "ap-southeast-2", + "ap-northeast-1", + "ca-central-1", + "eu-central-1", + "eu-west-1", + "eu-west-2", + "sa-east-1" + ] + }, + "TranscribeVocabularyFilterMethod":{ + "type":"string", + "enum":[ + "remove", + "mask", + "tag" + ] + }, + "TranscriptionConfiguration":{ + "type":"structure", + "members":{ + "EngineTranscribeSettings":{"shape":"EngineTranscribeSettings"}, + "EngineTranscribeMedicalSettings":{"shape":"EngineTranscribeMedicalSettings"} + } + }, "UnauthorizedClientException":{ "type":"structure", "members":{ diff --git a/models/apis/chime/2018-05-01/docs-2.json b/models/apis/chime/2018-05-01/docs-2.json index 0576a12ad1a..f34e1a2a23f 100644 --- a/models/apis/chime/2018-05-01/docs-2.json +++ b/models/apis/chime/2018-05-01/docs-2.json @@ -163,6 +163,8 @@ "RestorePhoneNumber": "
Moves a phone number from the Deletion queue back into the phone number Inventory.
", "SearchAvailablePhoneNumbers": "Searches for phone numbers that can be ordered. For US numbers, provide at least one of the following search filters: AreaCode
, City
, State
, or TollFreePrefix
. If you provide City
, you must also provide State
. Numbers outside the US only support the PhoneNumberType
filter, which you must use.
Sends a message to a particular channel that the member is a part of.
The x-amz-chime-bearer
request header is mandatory. Use the AppInstanceUserArn
of the user that makes the API call as the value in the header.
Also, STANDARD
messages can contain 4KB of data and the 1KB of metadata. CONTROL
messages can contain 30 bytes of data and no metadata.
Start transcription for the specified meetingId
.
Stops transcription for the specified meetingId
.
Applies the specified tags to the specified Amazon Chime SDK attendee.
", "TagMeeting": "Applies the specified tags to the specified Amazon Chime SDK meeting.
", "TagResource": "Applies the specified tags to the specified Amazon Chime SDK meeting resource.
", @@ -230,7 +232,7 @@ "AccountStatus": { "base": null, "refs": { - "Account$AccountStatus": "The status of the account, Suspended
or Active
.
The status of the account.
" } }, "AccountType": { @@ -1613,6 +1615,18 @@ "PutVoiceConnectorEmergencyCallingConfigurationResponse$EmergencyCallingConfiguration": "The emergency calling configuration details.
" } }, + "EngineTranscribeMedicalSettings": { + "base": "Settings specific to the Amazon Transcribe Medical engine.
", + "refs": { + "TranscriptionConfiguration$EngineTranscribeMedicalSettings": "The transcription configuration settings passed to Amazon Transcribe.
" + } + }, + "EngineTranscribeSettings": { + "base": "Settings specific to the Amazon Transcribe engine.
", + "refs": { + "TranscriptionConfiguration$EngineTranscribeSettings": "The transcription configuration settings passed to Amazon Transcribe.
" + } + }, "ErrorCode": { "base": null, "refs": { @@ -2019,6 +2033,8 @@ "Meeting$MeetingId": "The Amazon Chime SDK meeting ID.
", "PhoneNumberOrder$PhoneNumberOrderId": "The phone number order ID.
", "SipMediaApplicationCall$TransactionId": "The transaction ID of a call.
", + "StartMeetingTranscriptionRequest$MeetingId": "The unique ID of the meeting being transcribed.
", + "StopMeetingTranscriptionRequest$MeetingId": "The unique ID of the meeting for which you stop transcription.
", "TagAttendeeRequest$MeetingId": "The Amazon Chime SDK meeting ID.
", "TagAttendeeRequest$AttendeeId": "The Amazon Chime SDK attendee ID.
", "TagMeetingRequest$MeetingId": "The Amazon Chime SDK meeting ID.
", @@ -2516,7 +2532,7 @@ } }, "MediaPlacement": { - "base": "A set of endpoints used by clients to connect to the media service group for a Amazon Chime SDK meeting.
", + "base": "A set of endpoints used by clients to connect to the media service group for an Amazon Chime SDK meeting.
", "refs": { "Meeting$MediaPlacement": "The media placement for the meeting.
" } @@ -3620,6 +3636,26 @@ "ListChannelMessagesRequest$SortOrder": "The order in which you want messages sorted. Default is Descending, based on time created.
" } }, + "StartMeetingTranscriptionRequest": { + "base": null, + "refs": { + } + }, + "StartMeetingTranscriptionResponse": { + "base": null, + "refs": { + } + }, + "StopMeetingTranscriptionRequest": { + "base": null, + "refs": { + } + }, + "StopMeetingTranscriptionResponse": { + "base": null, + "refs": { + } + }, "StreamingConfiguration": { "base": "The streaming configuration associated with an Amazon Chime Voice Connector. Specifies whether media streaming is enabled for sending to Amazon Kinesis, and shows the retention period for the Amazon Kinesis data, in hours.
", "refs": { @@ -3664,6 +3700,9 @@ "DeletePhoneNumberRequest$PhoneNumberId": "The phone number ID.
", "DisassociatePhoneNumberFromUserRequest$AccountId": "The Amazon Chime account ID.
", "DisassociatePhoneNumberFromUserRequest$UserId": "The user ID.
", + "EngineTranscribeMedicalSettings$VocabularyName": "The name of the vocabulary passed to Amazon Transcribe Medical.
", + "EngineTranscribeSettings$VocabularyFilterName": "The name of the vocabulary filter passed to Amazon Transcribe.
", + "EngineTranscribeSettings$VocabularyName": "The name of the vocabulary passed to Amazon Transcribe.
", "EventsConfiguration$BotId": "The bot ID.
", "ForbiddenException$Message": null, "GetPhoneNumberRequest$PhoneNumberId": "The phone number ID.
", @@ -3859,6 +3898,54 @@ "SearchAvailablePhoneNumbersRequest$TollFreePrefix": "The toll-free prefix that you use to filter results. Only applies to the US.
" } }, + "TranscribeLanguageCode": { + "base": null, + "refs": { + "EngineTranscribeSettings$LanguageCode": "The language code specified for the Amazon Transcribe engine.
" + } + }, + "TranscribeMedicalLanguageCode": { + "base": null, + "refs": { + "EngineTranscribeMedicalSettings$LanguageCode": "The language code specified for the Amazon Transcribe Medical engine.
" + } + }, + "TranscribeMedicalRegion": { + "base": null, + "refs": { + "EngineTranscribeMedicalSettings$Region": "The AWS Region passed to Amazon Transcribe Medical. If you don't specify a Region, Amazon Chime uses the Region closest to the meeting's Region.
" + } + }, + "TranscribeMedicalSpecialty": { + "base": null, + "refs": { + "EngineTranscribeMedicalSettings$Specialty": "The specialty specified for the Amazon Transcribe Medical engine.
" + } + }, + "TranscribeMedicalType": { + "base": null, + "refs": { + "EngineTranscribeMedicalSettings$Type": "The type of transcription.
" + } + }, + "TranscribeRegion": { + "base": null, + "refs": { + "EngineTranscribeSettings$Region": "The AWS Region passed to Amazon Transcribe. If you don't specify a Region, Amazon Chime uses the Region closest to the meeting's Region.
" + } + }, + "TranscribeVocabularyFilterMethod": { + "base": null, + "refs": { + "EngineTranscribeSettings$VocabularyFilterMethod": "The filtering method passed to Amazon Transcribe.
" + } + }, + "TranscriptionConfiguration": { + "base": "The configuration for the current transcription operation. Must contain EngineTranscribeSettings
or EngineTranscribeMedicalSettings
.
The configuration for the current transcription operation. Must contain EngineTranscribeSettings
or EngineTranscribeMedicalSettings
.
The client is not currently authorized to make the request.
", "refs": { @@ -4113,7 +4200,7 @@ "MediaPlacement$ScreenViewingUrl": "The screen viewing URL.
", "MediaPlacement$SignalingUrl": "The signaling URL.
", "MediaPlacement$TurnControlUrl": "The turn control URL.
", - "MediaPlacement$EventIngestionUrl": "The event ingestion URL.
" + "MediaPlacement$EventIngestionUrl": "The URL of the S3 bucket used to store the captured media.
" } }, "UrlType": { diff --git a/models/apis/ec2/2016-11-15/api-2.json b/models/apis/ec2/2016-11-15/api-2.json index dd85f199fb4..1ea66f79b84 100755 --- a/models/apis/ec2/2016-11-15/api-2.json +++ b/models/apis/ec2/2016-11-15/api-2.json @@ -21219,6 +21219,8 @@ "g3.8xlarge", "g3.16xlarge", "g3s.xlarge", + "g4ad.xlarge", + "g4ad.2xlarge", "g4ad.4xlarge", "g4ad.8xlarge", "g4ad.16xlarge", diff --git a/models/apis/ec2/2016-11-15/docs-2.json b/models/apis/ec2/2016-11-15/docs-2.json index 7207ff20535..979a1408d0e 100755 --- a/models/apis/ec2/2016-11-15/docs-2.json +++ b/models/apis/ec2/2016-11-15/docs-2.json @@ -9,7 +9,7 @@ "AcceptVpcEndpointConnections": "Accepts one or more interface VPC endpoint connection requests to your VPC endpoint service.
", "AcceptVpcPeeringConnection": "Accept a VPC peering connection request. To accept a request, the VPC peering connection must be in the pending-acceptance
state, and you must be the owner of the peer VPC. Use DescribeVpcPeeringConnections to view your outstanding VPC peering connection requests.
For an inter-Region VPC peering connection request, you must accept the VPC peering connection in the Region of the accepter VPC.
", "AdvertiseByoipCidr": "Advertises an IPv4 or IPv6 address range that is provisioned for use with your Amazon Web Services resources through bring your own IP addresses (BYOIP).
You can perform this operation at most once every 10 seconds, even if you specify different address ranges each time.
We recommend that you stop advertising the BYOIP CIDR from other locations when you advertise it from Amazon Web Services. To minimize down time, you can configure your Amazon Web Services resources to use an address from a BYOIP CIDR before it is advertised, and then simultaneously stop advertising it from the current location and start advertising it through Amazon Web Services.
It can take a few minutes before traffic to the specified addresses starts routing to Amazon Web Services because of BGP propagation delays.
To stop advertising the BYOIP CIDR, use WithdrawByoipCidr.
", - "AllocateAddress": "Allocates an Elastic IP address to your account. After you allocate the Elastic IP address you can associate it with an instance or network interface. After you release an Elastic IP address, it is released to the IP address pool and can be allocated to a different account.
You can allocate an Elastic IP address from an address pool owned by Amazon Web Services or from an address pool created from a public IPv4 address range that you have brought to Amazon Web Services for use with your Amazon Web Services resources using bring your own IP addresses (BYOIP). For more information, see Bring Your Own IP Addresses (BYOIP) in the Amazon Elastic Compute Cloud User Guide.
[EC2-VPC] If you release an Elastic IP address, you might be able to recover it. You cannot recover an Elastic IP address that you released after it is allocated to another account. You cannot recover an Elastic IP address for EC2-Classic. To attempt to recover an Elastic IP address that you released, specify it in this operation.
An Elastic IP address is for use either in the EC2-Classic platform or in a VPC. By default, you can allocate 5 Elastic IP addresses for EC2-Classic per Region and 5 Elastic IP addresses for EC2-VPC per Region.
For more information, see Elastic IP Addresses in the Amazon Elastic Compute Cloud User Guide.
You can allocate a carrier IP address which is a public IP address from a telecommunication carrier, to a network interface which resides in a subnet in a Wavelength Zone (for example an EC2 instance).
", + "AllocateAddress": "Allocates an Elastic IP address to your Amazon Web Services account. After you allocate the Elastic IP address you can associate it with an instance or network interface. After you release an Elastic IP address, it is released to the IP address pool and can be allocated to a different Amazon Web Services account.
You can allocate an Elastic IP address from an address pool owned by Amazon Web Services or from an address pool created from a public IPv4 address range that you have brought to Amazon Web Services for use with your Amazon Web Services resources using bring your own IP addresses (BYOIP). For more information, see Bring Your Own IP Addresses (BYOIP) in the Amazon Elastic Compute Cloud User Guide.
[EC2-VPC] If you release an Elastic IP address, you might be able to recover it. You cannot recover an Elastic IP address that you released after it is allocated to another Amazon Web Services account. You cannot recover an Elastic IP address for EC2-Classic. To attempt to recover an Elastic IP address that you released, specify it in this operation.
An Elastic IP address is for use either in the EC2-Classic platform or in a VPC. By default, you can allocate 5 Elastic IP addresses for EC2-Classic per Region and 5 Elastic IP addresses for EC2-VPC per Region.
For more information, see Elastic IP Addresses in the Amazon Elastic Compute Cloud User Guide.
You can allocate a carrier IP address which is a public IP address from a telecommunication carrier, to a network interface which resides in a subnet in a Wavelength Zone (for example an EC2 instance).
", "AllocateHosts": "Allocates a Dedicated Host to your account. At a minimum, specify the supported instance type or instance family, the Availability Zone in which to allocate the host, and the number of hosts to allocate.
", "ApplySecurityGroupsToClientVpnTargetNetwork": "Applies a security group to the association between the target network and the Client VPN endpoint. This action replaces the existing security groups with the specified security groups.
", "AssignIpv6Addresses": "Assigns one or more IPv6 addresses to the specified network interface. You can specify one or more specific IPv6 addresses, or you can specify the number of IPv6 addresses to be automatically assigned from within the subnet's IPv6 CIDR block range. You can assign as many IPv6 addresses to a network interface as you can assign private IPv4 addresses, and the limit varies per instance type. For information, see IP Addresses Per Network Interface Per Instance Type in the Amazon Elastic Compute Cloud User Guide.
You must specify either the IPv6 addresses or the IPv6 address count in the request.
You can optionally use Prefix Delegation on the network interface. You must specify either the IPV6 Prefix Delegation prefixes, or the IPv6 Prefix Delegation count. For information, see Prefix Delegation in the Amazon Elastic Compute Cloud User Guide.
", @@ -29,7 +29,7 @@ "AttachClassicLinkVpc": "Links an EC2-Classic instance to a ClassicLink-enabled VPC through one or more of the VPC's security groups. You cannot link an EC2-Classic instance to more than one VPC at a time. You can only link an instance that's in the running
state. An instance is automatically unlinked from a VPC when it's stopped - you can link it to the VPC again when you restart it.
After you've linked an instance, you cannot change the VPC security groups that are associated with it. To change the security groups, you must first unlink the instance, and then link it again.
Linking your instance to a VPC is sometimes referred to as attaching your instance.
", "AttachInternetGateway": "Attaches an internet gateway or a virtual private gateway to a VPC, enabling connectivity between the internet and the VPC. For more information about your VPC and internet gateway, see the Amazon Virtual Private Cloud User Guide.
", "AttachNetworkInterface": "Attaches a network interface to an instance.
", - "AttachVolume": "Attaches an EBS volume to a running or stopped instance and exposes it to the instance with the specified device name.
Encrypted EBS volumes must be attached to instances that support Amazon EBS encryption. For more information, see Amazon EBS encryption in the Amazon Elastic Compute Cloud User Guide.
After you attach an EBS volume, you must make it available. For more information, see Make an EBS volume available for use.
If a volume has an Marketplace product code:
The volume can be attached only to a stopped instance.
Marketplace product codes are copied from the volume to the instance.
You must be subscribed to the product.
The instance type and operating system of the instance must support the product. For example, you can't detach a volume from a Windows instance and attach it to a Linux instance.
For more information, see Attach an Amazon EBS volume to an instance in the Amazon Elastic Compute Cloud User Guide.
", + "AttachVolume": "Attaches an EBS volume to a running or stopped instance and exposes it to the instance with the specified device name.
Encrypted EBS volumes must be attached to instances that support Amazon EBS encryption. For more information, see Amazon EBS encryption in the Amazon Elastic Compute Cloud User Guide.
After you attach an EBS volume, you must make it available. For more information, see Make an EBS volume available for use.
If a volume has an Amazon Web Services Marketplace product code:
The volume can be attached only to a stopped instance.
Amazon Web Services Marketplace product codes are copied from the volume to the instance.
You must be subscribed to the product.
The instance type and operating system of the instance must support the product. For example, you can't detach a volume from a Windows instance and attach it to a Linux instance.
For more information, see Attach an Amazon EBS volume to an instance in the Amazon Elastic Compute Cloud User Guide.
", "AttachVpnGateway": "Attaches a virtual private gateway to a VPC. You can attach one virtual private gateway to one VPC at a time.
For more information, see AWS Site-to-Site VPN in the AWS Site-to-Site VPN User Guide.
", "AuthorizeClientVpnIngress": "Adds an ingress authorization rule to a Client VPN endpoint. Ingress authorization rules act as firewall rules that grant access to networks. You must configure ingress authorization rules to enable clients to access resources in AWS or on-premises networks.
", "AuthorizeSecurityGroupEgress": "[VPC only] Adds the specified outbound (egress) rules to a security group for use with a VPC.
An outbound rule permits instances to send traffic to the specified IPv4 or IPv6 CIDR address ranges, or to the instances that are associated with the specified destination security groups.
You specify a protocol for each rule (for example, TCP). For the TCP and UDP protocols, you must also specify the destination port or port range. For the ICMP protocol, you must also specify the ICMP type and code. You can use -1 for the type or code to mean all types or all codes.
Rule changes are propagated to affected instances as quickly as possible. However, a small delay might occur.
For information about VPC security group quotas, see Amazon VPC quotas.
", @@ -74,7 +74,7 @@ "CreateNetworkAclEntry": "Creates an entry (a rule) in a network ACL with the specified rule number. Each network ACL has a set of numbered ingress rules and a separate set of numbered egress rules. When determining whether a packet should be allowed in or out of a subnet associated with the ACL, we process the entries in the ACL according to the rule numbers, in ascending order. Each network ACL has a set of ingress rules and a separate set of egress rules.
We recommend that you leave room between the rule numbers (for example, 100, 110, 120, ...), and not number them one right after the other (for example, 101, 102, 103, ...). This makes it easier to add a rule between existing ones without having to renumber the rules.
After you add an entry, you can't modify it; you must either replace it, or create an entry and delete the old one.
For more information about network ACLs, see Network ACLs in the Amazon Virtual Private Cloud User Guide.
", "CreateNetworkInsightsPath": "Creates a path to analyze for reachability.
Reachability Analyzer enables you to analyze and debug network reachability between two resources in your virtual private cloud (VPC). For more information, see What is Reachability Analyzer.
", "CreateNetworkInterface": "Creates a network interface in the specified subnet.
For more information about network interfaces, see Elastic Network Interfaces in the Amazon Virtual Private Cloud User Guide.
", - "CreateNetworkInterfacePermission": "Grants an Amazon Web Services-authorized account permission to attach the specified network interface to an instance in their account.
You can grant permission to a single account only, and only one account at a time.
", + "CreateNetworkInterfacePermission": "Grants an Amazon Web Services-authorized account permission to attach the specified network interface to an instance in their account.
You can grant permission to a single Amazon Web Services account only, and only one account at a time.
", "CreatePlacementGroup": "Creates a placement group in which to launch instances. The strategy of the placement group determines how the instances are organized within the group.
A cluster
placement group is a logical grouping of instances within a single Availability Zone that benefit from low network latency, high network throughput. A spread
placement group places instances on distinct hardware. A partition
placement group places groups of instances in different partitions, where instances in one partition do not share the same hardware with instances in another partition.
For more information, see Placement groups in the Amazon EC2 User Guide.
", "CreateReplaceRootVolumeTask": "Creates a root volume replacement task for an Amazon EC2 instance. The root volume can either be restored to its initial launch state, or it can be restored using a specific snapshot.
For more information, see Replace a root volume in the Amazon Elastic Compute Cloud User Guide.
", "CreateReservedInstancesListing": "Creates a listing for Amazon EC2 Standard Reserved Instances to be sold in the Reserved Instance Marketplace. You can submit one Standard Reserved Instance listing at a time. To get a list of your Standard Reserved Instances, you can use the DescribeReservedInstances operation.
Only Standard Reserved Instances can be sold in the Reserved Instance Marketplace. Convertible Reserved Instances cannot be sold.
The Reserved Instance Marketplace matches sellers who want to resell Standard Reserved Instance capacity that they no longer need with buyers who want to purchase additional capacity. Reserved Instances bought and sold through the Reserved Instance Marketplace work like any other Reserved Instances.
To sell your Standard Reserved Instances, you must first register as a seller in the Reserved Instance Marketplace. After completing the registration process, you can create a Reserved Instance Marketplace listing of some or all of your Standard Reserved Instances, and specify the upfront price to receive for them. Your Standard Reserved Instance listings then become available for purchase. To view the details of your Standard Reserved Instance listing, you can use the DescribeReservedInstancesListings operation.
For more information, see Reserved Instance Marketplace in the Amazon EC2 User Guide.
", @@ -82,9 +82,9 @@ "CreateRoute": "Creates a route in a route table within a VPC.
You must specify one of the following targets: internet gateway or virtual private gateway, NAT instance, NAT gateway, VPC peering connection, network interface, egress-only internet gateway, or transit gateway.
When determining how to route traffic, we use the route with the most specific match. For example, traffic is destined for the IPv4 address 192.0.2.3
, and the route table includes the following two IPv4 routes:
192.0.2.0/24
(goes to some target A)
192.0.2.0/28
(goes to some target B)
Both routes apply to the traffic destined for 192.0.2.3
. However, the second route in the list covers a smaller number of IP addresses and is therefore more specific, so we use that route to determine where to target the traffic.
For more information about route tables, see Route tables in the Amazon Virtual Private Cloud User Guide.
", "CreateRouteTable": "Creates a route table for the specified VPC. After you create a route table, you can add routes and associate the table with a subnet.
For more information, see Route tables in the Amazon Virtual Private Cloud User Guide.
", "CreateSecurityGroup": "Creates a security group.
A security group acts as a virtual firewall for your instance to control inbound and outbound traffic. For more information, see Amazon EC2 Security Groups in the Amazon Elastic Compute Cloud User Guide and Security Groups for Your VPC in the Amazon Virtual Private Cloud User Guide.
When you create a security group, you specify a friendly name of your choice. You can have a security group for use in EC2-Classic with the same name as a security group for use in a VPC. However, you can't have two security groups for use in EC2-Classic with the same name or two security groups for use in a VPC with the same name.
You have a default security group for use in EC2-Classic and a default security group for use in your VPC. If you don't specify a security group when you launch an instance, the instance is launched into the appropriate default security group. A default security group includes a default rule that grants instances unrestricted network access to each other.
You can add or remove rules from your security groups using AuthorizeSecurityGroupIngress, AuthorizeSecurityGroupEgress, RevokeSecurityGroupIngress, and RevokeSecurityGroupEgress.
For more information about VPC security group limits, see Amazon VPC Limits.
", - "CreateSnapshot": "Creates a snapshot of an EBS volume and stores it in Amazon S3. You can use snapshots for backups, to make copies of EBS volumes, and to save data before shutting down an instance.
You can create snapshots of volumes in a Region and volumes on an Outpost. If you create a snapshot of a volume in a Region, the snapshot must be stored in the same Region as the volume. If you create a snapshot of a volume on an Outpost, the snapshot can be stored on the same Outpost as the volume, or in the Region for that Outpost.
When a snapshot is created, any Marketplace product codes that are associated with the source volume are propagated to the snapshot.
You can take a snapshot of an attached volume that is in use. However, snapshots only capture data that has been written to your Amazon EBS volume at the time the snapshot command is issued; this might exclude any data that has been cached by any applications or the operating system. If you can pause any file systems on the volume long enough to take a snapshot, your snapshot should be complete. However, if you cannot pause all file writes to the volume, you should unmount the volume from within the instance, issue the snapshot command, and then remount the volume to ensure a consistent and complete snapshot. You may remount and use your volume while the snapshot status is pending
.
To create a snapshot for Amazon EBS volumes that serve as root devices, you should stop the instance before taking the snapshot.
Snapshots that are taken from encrypted volumes are automatically encrypted. Volumes that are created from encrypted snapshots are also automatically encrypted. Your encrypted volumes and any associated snapshots always remain protected.
You can tag your snapshots during creation. For more information, see Tag your Amazon EC2 resources in the Amazon Elastic Compute Cloud User Guide.
For more information, see Amazon Elastic Block Store and Amazon EBS encryption in the Amazon Elastic Compute Cloud User Guide.
", + "CreateSnapshot": "Creates a snapshot of an EBS volume and stores it in Amazon S3. You can use snapshots for backups, to make copies of EBS volumes, and to save data before shutting down an instance.
You can create snapshots of volumes in a Region and volumes on an Outpost. If you create a snapshot of a volume in a Region, the snapshot must be stored in the same Region as the volume. If you create a snapshot of a volume on an Outpost, the snapshot can be stored on the same Outpost as the volume, or in the Region for that Outpost.
When a snapshot is created, any Amazon Web Services Marketplace product codes that are associated with the source volume are propagated to the snapshot.
You can take a snapshot of an attached volume that is in use. However, snapshots only capture data that has been written to your Amazon EBS volume at the time the snapshot command is issued; this might exclude any data that has been cached by any applications or the operating system. If you can pause any file systems on the volume long enough to take a snapshot, your snapshot should be complete. However, if you cannot pause all file writes to the volume, you should unmount the volume from within the instance, issue the snapshot command, and then remount the volume to ensure a consistent and complete snapshot. You may remount and use your volume while the snapshot status is pending
.
To create a snapshot for Amazon EBS volumes that serve as root devices, you should stop the instance before taking the snapshot.
Snapshots that are taken from encrypted volumes are automatically encrypted. Volumes that are created from encrypted snapshots are also automatically encrypted. Your encrypted volumes and any associated snapshots always remain protected.
You can tag your snapshots during creation. For more information, see Tag your Amazon EC2 resources in the Amazon Elastic Compute Cloud User Guide.
For more information, see Amazon Elastic Block Store and Amazon EBS encryption in the Amazon Elastic Compute Cloud User Guide.
", "CreateSnapshots": "Creates crash-consistent snapshots of multiple EBS volumes and stores the data in S3. Volumes are chosen by specifying an instance. Any attached volumes will produce one snapshot each that is crash-consistent across the instance. Boot volumes can be excluded by changing the parameters.
You can create multi-volume snapshots of instances in a Region and instances on an Outpost. If you create snapshots from an instance in a Region, the snapshots must be stored in the same Region as the instance. If you create snapshots from an instance on an Outpost, the snapshots can be stored on the same Outpost as the instance, or in the Region for that Outpost.
", - "CreateSpotDatafeedSubscription": "Creates a data feed for Spot Instances, enabling you to view Spot Instance usage logs. You can create one data feed per account. For more information, see Spot Instance data feed in the Amazon EC2 User Guide for Linux Instances.
", + "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 S3 bucket.
To use this API, you must have the required permissions. For more information, see Permissions for storing and restoring AMIs using S3 in the Amazon Elastic Compute Cloud User Guide.
For more information, see Store and restore an AMI using S3 in the Amazon Elastic Compute Cloud User Guide.
", "CreateSubnet": "Creates a subnet in a specified VPC.
You must specify an IPv4 CIDR block for the subnet. After you create a subnet, you can't change its CIDR block. The allowed block size is between a /16 netmask (65,536 IP addresses) and /28 netmask (16 IP addresses). The CIDR block must not overlap with the CIDR block of an existing subnet in the VPC.
If you've associated an IPv6 CIDR block with your VPC, you can create a subnet with an IPv6 CIDR block that uses a /64 prefix length.
Amazon Web Services reserves both the first four and the last IPv4 address in each subnet's CIDR block. They're not available for use.
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 about subnets, see Your VPC and subnets in the Amazon Virtual Private Cloud 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.
", @@ -102,12 +102,12 @@ "CreateTransitGatewayRoute": "Creates a static route for the specified transit gateway route table.
", "CreateTransitGatewayRouteTable": "Creates a route table for the specified transit gateway.
", "CreateTransitGatewayVpcAttachment": "Attaches the specified VPC to the specified transit gateway.
If you attach a VPC with a CIDR range that overlaps the CIDR range of a VPC that is already attached, the new VPC CIDR range is not propagated to the default propagation route table.
To send VPC traffic to an attached transit gateway, add a route to the VPC route table using CreateRoute.
", - "CreateVolume": "Creates an EBS volume that can be attached to an instance in the same Availability Zone.
You can create a new empty volume or restore a volume from an EBS snapshot. Any Marketplace product codes from the snapshot are propagated to the volume.
You can create encrypted volumes. Encrypted volumes must be attached to instances that support Amazon EBS encryption. Volumes that are created from encrypted snapshots are also automatically encrypted. For more information, see Amazon EBS encryption in the Amazon Elastic Compute Cloud User Guide.
You can tag your volumes during creation. For more information, see Tag your Amazon EC2 resources in the Amazon Elastic Compute Cloud User Guide.
For more information, see Create an Amazon EBS volume in the Amazon Elastic Compute Cloud User Guide.
", + "CreateVolume": "Creates an EBS volume that can be attached to an instance in the same Availability Zone.
You can create a new empty volume or restore a volume from an EBS snapshot. Any Amazon Web Services Marketplace product codes from the snapshot are propagated to the volume.
You can create encrypted volumes. Encrypted volumes must be attached to instances that support Amazon EBS encryption. Volumes that are created from encrypted snapshots are also automatically encrypted. For more information, see Amazon EBS encryption in the Amazon Elastic Compute Cloud User Guide.
You can tag your volumes during creation. For more information, see Tag your Amazon EC2 resources in the Amazon Elastic Compute Cloud User Guide.
For more information, see Create an Amazon EBS volume in the Amazon Elastic Compute Cloud User Guide.
", "CreateVpc": "Creates a VPC with the specified IPv4 CIDR block. The smallest VPC you can create uses a /28 netmask (16 IPv4 addresses), and the largest uses a /16 netmask (65,536 IPv4 addresses). For more information about how large to make your VPC, see Your VPC and subnets in the Amazon Virtual Private Cloud User Guide.
You can optionally request an IPv6 CIDR block for the VPC. You can request an Amazon-provided IPv6 CIDR block from Amazon's pool of IPv6 addresses, or an IPv6 CIDR block from an IPv6 address pool that you provisioned through bring your own IP addresses (BYOIP).
By default, each instance you launch in the VPC has the default DHCP options, which include only a default DNS server that we provide (AmazonProvidedDNS). For more information, see DHCP options sets in the Amazon Virtual Private Cloud User Guide.
You can specify the instance tenancy value for the VPC when you create it. You can't change this value for the VPC after you create it. For more information, see Dedicated Instances in the Amazon Elastic Compute Cloud User Guide.
", "CreateVpcEndpoint": "Creates a VPC endpoint for a specified service. An endpoint enables you to create a private connection between your VPC and the service. The service may be provided by AWS, an AWS Marketplace Partner, or another AWS account. For more information, see VPC Endpoints in the Amazon Virtual Private Cloud User Guide.
A gateway
endpoint serves as a target for a route in your route table for traffic destined for the AWS service. You can specify an endpoint policy to attach to the endpoint, which will control access to the service from your VPC. You can also specify the VPC route tables that use the endpoint.
An interface
endpoint is a network interface in your subnet that serves as an endpoint for communicating with the specified service. You can specify the subnets in which to create an endpoint, and the security groups to associate with the endpoint network interface.
A GatewayLoadBalancer
endpoint is a network interface in your subnet that serves an endpoint for communicating with a Gateway Load Balancer that you've configured as a VPC endpoint service.
Use DescribeVpcEndpointServices to get a list of supported services.
", "CreateVpcEndpointConnectionNotification": "Creates a connection notification for a specified VPC endpoint or VPC endpoint service. A connection notification notifies you of specific endpoint events. You must create an SNS topic to receive notifications. For more information, see Create a Topic in the Amazon Simple Notification Service Developer Guide.
You can create a connection notification for interface endpoints only.
", "CreateVpcEndpointServiceConfiguration": "Creates a VPC endpoint service configuration to which service consumers (AWS accounts, IAM users, and IAM roles) can connect.
To create an endpoint service configuration, you must first create one of the following for your service:
A Network Load Balancer. Service consumers connect to your service using an interface endpoint.
A Gateway Load Balancer. Service consumers connect to your service using a Gateway Load Balancer endpoint.
For more information, see VPC Endpoint Services in the Amazon Virtual Private Cloud User Guide.
If you set the private DNS name, you must prove that you own the private DNS domain name. For more information, see VPC Endpoint Service Private DNS Name Verification in the Amazon Virtual Private Cloud User Guide.
", - "CreateVpcPeeringConnection": "Requests a VPC peering connection between two VPCs: a requester VPC that you own and an accepter VPC with which to create the connection. The accepter VPC can belong to another account and can be in a different Region to the requester VPC. The requester VPC and accepter VPC cannot have overlapping CIDR blocks.
Limitations and rules apply to a VPC peering connection. For more information, see the limitations section in the VPC Peering Guide.
The owner of the accepter VPC must accept the peering request to activate the peering connection. The VPC peering connection request expires after 7 days, after which it cannot be accepted or rejected.
If you create a VPC peering connection request between VPCs with overlapping CIDR blocks, the VPC peering connection has a status of failed
.
Requests a VPC peering connection between two VPCs: a requester VPC that you own and an accepter VPC with which to create the connection. The accepter VPC can belong to another Amazon Web Services account and can be in a different Region to the requester VPC. The requester VPC and accepter VPC cannot have overlapping CIDR blocks.
Limitations and rules apply to a VPC peering connection. For more information, see the limitations section in the VPC Peering Guide.
The owner of the accepter VPC must accept the peering request to activate the peering connection. The VPC peering connection request expires after 7 days, after which it cannot be accepted or rejected.
If you create a VPC peering connection request between VPCs with overlapping CIDR blocks, the VPC peering connection has a status of failed
.
Creates a VPN connection between an existing virtual private gateway or transit gateway and a customer gateway. The supported connection type is ipsec.1
.
The response includes information that you need to give to your network administrator to configure your customer gateway.
We strongly recommend that you use HTTPS when calling this operation because the response contains sensitive cryptographic information for configuring your customer gateway device.
If you decide to shut down your VPN connection for any reason and later create a new VPN connection, you must reconfigure your customer gateway with the new information returned from this call.
This is an idempotent operation. If you perform the operation more than once, Amazon EC2 doesn't return an error.
For more information, see AWS Site-to-Site VPN in the AWS Site-to-Site VPN User Guide.
", "CreateVpnConnectionRoute": "Creates a static route associated with a VPN connection between an existing virtual private gateway and a VPN customer gateway. The static route allows traffic to be routed from the virtual private gateway to the VPN customer gateway.
For more information, see AWS Site-to-Site VPN in the AWS Site-to-Site VPN User Guide.
", "CreateVpnGateway": "Creates a virtual private gateway. A virtual private gateway is the endpoint on the VPC side of your VPN connection. You can create a virtual private gateway before creating the VPC itself.
For more information, see AWS Site-to-Site VPN in the AWS Site-to-Site VPN User Guide.
", @@ -179,7 +179,7 @@ "DescribeAvailabilityZones": "Describes the Availability Zones, Local Zones, and Wavelength Zones that are available to you. If there is an event impacting a zone, you can use this request to view the state and any provided messages for that zone.
For more information about Availability Zones, Local Zones, and Wavelength Zones, see Regions, Zones and Outposts in the Amazon Elastic Compute Cloud User Guide.
", "DescribeBundleTasks": "Describes the specified bundle tasks or all of your bundle tasks.
Completed bundle tasks are listed for only a limited time. If your bundle task is no longer in the list, you can still register an AMI from it. Just use RegisterImage
with the Amazon S3 bucket name and image manifest name you provided to the bundle task.
Describes the IP address ranges that were specified in calls to ProvisionByoipCidr.
To describe the address pools that were created when you provisioned the address ranges, use DescribePublicIpv4Pools or DescribeIpv6Pools.
", - "DescribeCapacityReservations": "Describes one or more of your Capacity Reservations. The results describe only the Capacity Reservations in the Region that you're currently using.
", + "DescribeCapacityReservations": "Describes one or more of your Capacity Reservations. The results describe only the Capacity Reservations in the Amazon Web Services Region that you're currently using.
", "DescribeCarrierGateways": "Describes one or more of your carrier gateways.
", "DescribeClassicLinkInstances": "Describes one or more of your linked EC2-Classic instances. This request only returns information about EC2-Classic instances linked to a VPC through ClassicLink. You cannot use this request to return information about other instances.
", "DescribeClientVpnAuthorizationRules": "Describes the authorization rules for a specified Client VPN endpoint.
", @@ -257,7 +257,7 @@ "DescribeSecurityGroupRules": "Describes one or more of your security group rules.
", "DescribeSecurityGroups": "Describes the specified security groups or all of your security groups.
A security group is for use with instances either in the EC2-Classic platform or in a specific VPC. For more information, see Amazon EC2 Security Groups in the Amazon Elastic Compute Cloud User Guide and Security Groups for Your VPC in the Amazon Virtual Private Cloud User Guide.
", "DescribeSnapshotAttribute": "Describes the specified attribute of the specified snapshot. You can specify only one attribute at a time.
For more information about EBS snapshots, see Amazon EBS snapshots in the Amazon Elastic Compute Cloud User Guide.
", - "DescribeSnapshots": "Describes the specified EBS snapshots available to you or all of the EBS snapshots available to you.
The snapshots available to you include public snapshots, private snapshots that you own, and private snapshots owned by other accounts for which you have explicit create volume permissions.
The create volume permissions fall into the following categories:
public: The owner of the snapshot granted create volume permissions for the snapshot to the all
group. All accounts have create volume permissions for these snapshots.
explicit: The owner of the snapshot granted create volume permissions to a specific account.
implicit: An account has implicit create volume permissions for all snapshots it owns.
The list of snapshots returned can be filtered by specifying snapshot IDs, snapshot owners, or accounts with create volume permissions. If no options are specified, Amazon EC2 returns all snapshots for which you have create volume permissions.
If you specify one or more snapshot IDs, only snapshots that have the specified IDs are returned. If you specify an invalid snapshot ID, an error is returned. If you specify a snapshot ID for which you do not have access, it is not included in the returned results.
If you specify one or more snapshot owners using the OwnerIds
option, only snapshots from the specified owners and for which you have access are returned. The results can include the account IDs of the specified owners, amazon
for snapshots owned by Amazon, or self
for snapshots that you own.
If you specify a list of restorable users, only snapshots with create snapshot permissions for those users are returned. You can specify account IDs (if you own the snapshots), self
for snapshots for which you own or have explicit permissions, or all
for public snapshots.
If you are describing a long list of snapshots, we recommend that you paginate the output to make the list more manageable. The MaxResults
parameter sets the maximum number of results returned in a single page. If the list of results exceeds your MaxResults
value, then that number of results is returned along with a NextToken
value that can be passed to a subsequent DescribeSnapshots
request to retrieve the remaining results.
To get the state of fast snapshot restores for a snapshot, use DescribeFastSnapshotRestores.
For more information about EBS snapshots, see Amazon EBS snapshots in the Amazon Elastic Compute Cloud User Guide.
", + "DescribeSnapshots": "Describes the specified EBS snapshots available to you or all of the EBS snapshots available to you.
The snapshots available to you include public snapshots, private snapshots that you own, and private snapshots owned by other Amazon Web Services accounts for which you have explicit create volume permissions.
The create volume permissions fall into the following categories:
public: The owner of the snapshot granted create volume permissions for the snapshot to the all
group. All Amazon Web Services accounts have create volume permissions for these snapshots.
explicit: The owner of the snapshot granted create volume permissions to a specific Amazon Web Services account.
implicit: An Amazon Web Services account has implicit create volume permissions for all snapshots it owns.
The list of snapshots returned can be filtered by specifying snapshot IDs, snapshot owners, or Amazon Web Services accounts with create volume permissions. If no options are specified, Amazon EC2 returns all snapshots for which you have create volume permissions.
If you specify one or more snapshot IDs, only snapshots that have the specified IDs are returned. If you specify an invalid snapshot ID, an error is returned. If you specify a snapshot ID for which you do not have access, it is not included in the returned results.
If you specify one or more snapshot owners using the OwnerIds
option, only snapshots from the specified owners and for which you have access are returned. The results can include the Amazon Web Services account IDs of the specified owners, amazon
for snapshots owned by Amazon, or self
for snapshots that you own.
If you specify a list of restorable users, only snapshots with create snapshot permissions for those users are returned. You can specify Amazon Web Services account IDs (if you own the snapshots), self
for snapshots for which you own or have explicit permissions, or all
for public snapshots.
If you are describing a long list of snapshots, we recommend that you paginate the output to make the list more manageable. The MaxResults
parameter sets the maximum number of results returned in a single page. If the list of results exceeds your MaxResults
value, then that number of results is returned along with a NextToken
value that can be passed to a subsequent DescribeSnapshots
request to retrieve the remaining results.
To get the state of fast snapshot restores for a snapshot, use DescribeFastSnapshotRestores.
For more information about EBS snapshots, see Amazon EBS snapshots in the Amazon Elastic Compute Cloud User Guide.
", "DescribeSpotDatafeedSubscription": "Describes the data feed for Spot Instances. For more information, see Spot Instance data feed in the Amazon EC2 User Guide for Linux Instances.
", "DescribeSpotFleetInstances": "Describes the running instances for the specified Spot Fleet.
", "DescribeSpotFleetRequestHistory": "Describes the events for the specified Spot Fleet request during the specified time.
Spot Fleet events are delayed by up to 30 seconds before they can be described. This ensures that you can query by the last evaluated time and not miss a recorded event. Spot Fleet events are available for 48 hours.
", @@ -300,7 +300,7 @@ "DetachClassicLinkVpc": "Unlinks (detaches) a linked EC2-Classic instance from a VPC. After the instance has been unlinked, the VPC security groups are no longer associated with it. An instance is automatically unlinked from a VPC when it's stopped.
", "DetachInternetGateway": "Detaches an internet gateway from a VPC, disabling connectivity between the internet and the VPC. The VPC must not contain any running instances with Elastic IP addresses or public IPv4 addresses.
", "DetachNetworkInterface": "Detaches a network interface from an instance.
", - "DetachVolume": "Detaches an EBS volume from an instance. Make sure to unmount any file systems on the device within your operating system before detaching the volume. Failure to do so can result in the volume becoming stuck in the busy
state while detaching. If this happens, detachment can be delayed indefinitely until you unmount the volume, force detachment, reboot the instance, or all three. If an EBS volume is the root device of an instance, it can't be detached while the instance is running. To detach the root volume, stop the instance first.
When a volume with an Marketplace product code is detached from an instance, the product code is no longer associated with the instance.
For more information, see Detach an Amazon EBS volume in the Amazon Elastic Compute Cloud User Guide.
", + "DetachVolume": "Detaches an EBS volume from an instance. Make sure to unmount any file systems on the device within your operating system before detaching the volume. Failure to do so can result in the volume becoming stuck in the busy
state while detaching. If this happens, detachment can be delayed indefinitely until you unmount the volume, force detachment, reboot the instance, or all three. If an EBS volume is the root device of an instance, it can't be detached while the instance is running. To detach the root volume, stop the instance first.
When a volume with an Amazon Web Services Marketplace product code is detached from an instance, the product code is no longer associated with the instance.
For more information, see Detach an Amazon EBS volume in the Amazon Elastic Compute Cloud User Guide.
", "DetachVpnGateway": "Detaches a virtual private gateway from a VPC. You do this if you're planning to turn off the VPC and not use it anymore. You can confirm a virtual private gateway has been completely detached from a VPC by describing the virtual private gateway (any attachments to the virtual private gateway are also described).
You must wait for the attachment's state to switch to detached
before you can delete the VPC or attach a different VPC to the virtual private gateway.
Disables EBS encryption by default for your account in the current Region.
After you disable encryption by default, you can still create encrypted volumes by enabling encryption when you create each volume.
Disabling encryption by default does not change the encryption status of your existing volumes.
For more information, see Amazon EBS encryption in the Amazon Elastic Compute Cloud User Guide.
", "DisableFastSnapshotRestores": "Disables fast snapshot restores for the specified snapshots in the specified Availability Zones.
", @@ -336,7 +336,7 @@ "ExportTransitGatewayRoutes": "Exports routes from the specified transit gateway route table to the specified S3 bucket. By default, all routes are exported. Alternatively, you can filter by CIDR range.
The routes are saved to the specified bucket in a JSON file. For more information, see Export Route Tables to Amazon S3 in Transit Gateways.
", "GetAssociatedEnclaveCertificateIamRoles": "Returns the IAM roles that are associated with the specified ACM (ACM) certificate. It also returns the name of the Amazon S3 bucket and the Amazon S3 object key where the certificate, certificate chain, and encrypted private key bundle are stored, and the ARN of the KMS key that's used to encrypt the private key.
", "GetAssociatedIpv6PoolCidrs": "Gets information about the IPv6 CIDR block associations for a specified IPv6 address pool.
", - "GetCapacityReservationUsage": "Gets usage information about a Capacity Reservation. If the Capacity Reservation is shared, it shows usage information for the Capacity Reservation owner and each account that is currently using the shared capacity. If the Capacity Reservation is not shared, it shows only the Capacity Reservation owner's usage.
", + "GetCapacityReservationUsage": "Gets usage information about a Capacity Reservation. If the Capacity Reservation is shared, it shows usage information for the Capacity Reservation owner and each Amazon Web Services account that is currently using the shared capacity. If the Capacity Reservation is not shared, it shows only the Capacity Reservation owner's usage.
", "GetCoipPoolUsage": "Describes the allocations from the specified customer-owned address pool.
", "GetConsoleOutput": "Gets the console output for the specified instance. For Linux instances, the instance console output displays the exact console output that would normally be displayed on a physical monitor attached to a computer. For Windows instances, the instance console output includes the last three system event log errors.
By default, the console output returns buffered information that was posted shortly after an instance transition state (start, stop, reboot, or terminate). This information is available for at least one hour after the most recent post. Only the most recent 64 KB of console output is available.
You can optionally retrieve the latest serial console output at any time during the instance lifecycle. This option is supported on instance types that use the Nitro hypervisor.
For more information, see Instance console output in the Amazon EC2 User Guide.
", "GetConsoleScreenshot": "Retrieve a JPG-format screenshot of a running instance to help with troubleshooting.
The returned content is Base64-encoded.
", @@ -368,7 +368,7 @@ "ModifyAvailabilityZoneGroup": "Changes the opt-in status of the Local Zone and Wavelength Zone group for your account.
Use DescribeAvailabilityZones to view the value for GroupName
.
Modifies a Capacity Reservation's capacity and the conditions under which it is to be released. You cannot change a Capacity Reservation's instance type, EBS optimization, instance store settings, platform, Availability Zone, or instance eligibility. If you need to modify any of these attributes, we recommend that you cancel the Capacity Reservation, and then create a new one with the required attributes.
", "ModifyClientVpnEndpoint": "Modifies the specified Client VPN endpoint. Modifying the DNS server resets existing client connections.
", - "ModifyDefaultCreditSpecification": "Modifies the default credit option for CPU usage of burstable performance instances. The default credit option is set at the account level per Region, and is specified per instance family. All new burstable performance instances in the account launch using the default credit option.
ModifyDefaultCreditSpecification
is an asynchronous operation, which works at an Region level and modifies the credit option for each Availability Zone. All zones in a Region are updated within five minutes. But if instances are launched during this operation, they might not get the new credit option until the zone is updated. To verify whether the update has occurred, you can call GetDefaultCreditSpecification
and check DefaultCreditSpecification
for updates.
For more information, see Burstable performance instances in the Amazon EC2 User Guide.
", + "ModifyDefaultCreditSpecification": "Modifies the default credit option for CPU usage of burstable performance instances. The default credit option is set at the account level per Amazon Web Services Region, and is specified per instance family. All new burstable performance instances in the account launch using the default credit option.
ModifyDefaultCreditSpecification
is an asynchronous operation, which works at an Amazon Web Services Region level and modifies the credit option for each Availability Zone. All zones in a Region are updated within five minutes. But if instances are launched during this operation, they might not get the new credit option until the zone is updated. To verify whether the update has occurred, you can call GetDefaultCreditSpecification
and check DefaultCreditSpecification
for updates.
For more information, see Burstable performance instances in the Amazon EC2 User Guide.
", "ModifyEbsDefaultKmsKeyId": "Changes the default KMS key for EBS encryption by default for your account in this Region.
Amazon Web Services creates a unique Amazon Web Services managed KMS key in each Region for use with encryption by default. If you change the default KMS key to a symmetric customer managed KMS key, it is used instead of the Amazon Web Services managed KMS key. To reset the default KMS key to the Amazon Web Services managed KMS key for EBS, use ResetEbsDefaultKmsKeyId. Amazon EBS does not support asymmetric KMS keys.
If you delete or disable the customer managed KMS key that you specified for use with encryption by default, your instances will fail to launch.
For more information, see Amazon EBS encryption in the Amazon Elastic Compute Cloud User Guide.
", "ModifyFleet": "Modifies the specified EC2 Fleet.
You can only modify an EC2 Fleet request of type maintain
.
While the EC2 Fleet is being modified, it is in the modifying
state.
To scale up your EC2 Fleet, increase its target capacity. The EC2 Fleet launches the additional Spot Instances according to the allocation strategy for the EC2 Fleet request. If the allocation strategy is lowest-price
, the EC2 Fleet launches instances using the Spot Instance pool with the lowest price. If the allocation strategy is diversified
, the EC2 Fleet distributes the instances across the Spot Instance pools. If the allocation strategy is capacity-optimized
, EC2 Fleet launches instances from Spot Instance pools with optimal capacity for the number of instances that are launching.
To scale down your EC2 Fleet, decrease its target capacity. First, the EC2 Fleet cancels any open requests that exceed the new target capacity. You can request that the EC2 Fleet terminate Spot Instances until the size of the fleet no longer exceeds the new target capacity. If the allocation strategy is lowest-price
, the EC2 Fleet terminates the instances with the highest price per unit. If the allocation strategy is capacity-optimized
, the EC2 Fleet terminates the instances in the Spot Instance pools that have the least available Spot Instance capacity. If the allocation strategy is diversified
, the EC2 Fleet terminates instances across the Spot Instance pools. Alternatively, you can request that the EC2 Fleet keep the fleet at its current size, but not replace any Spot Instances that are interrupted or that you terminate manually.
If you are finished with your EC2 Fleet for now, but will use it again later, you can set the target capacity to 0.
", "ModifyFpgaImageAttribute": "Modifies the specified attribute of the specified Amazon FPGA Image (AFI).
", @@ -388,7 +388,7 @@ "ModifyNetworkInterfaceAttribute": "Modifies the specified network interface attribute. You can specify only one attribute at a time. You can use this action to attach and detach security groups from an existing EC2 instance.
", "ModifyReservedInstances": "Modifies the Availability Zone, instance count, instance type, or network platform (EC2-Classic or EC2-VPC) of your Reserved Instances. The Reserved Instances to be modified must be identical, except for Availability Zone, network platform, and instance type.
For more information, see Modifying Reserved Instances in the Amazon EC2 User Guide.
", "ModifySecurityGroupRules": "Modifies the rules of a security group.
", - "ModifySnapshotAttribute": "Adds or removes permission settings for the specified snapshot. You may add or remove specified account IDs from a snapshot's list of create volume permissions, but you cannot do both in a single operation. If you need to both add and remove account IDs for a snapshot, you must use multiple operations. You can make up to 500 modifications to a snapshot in a single operation.
Encrypted snapshots and snapshots with Marketplace product codes cannot be made public. Snapshots encrypted with your default KMS key cannot be shared with other accounts.
For more information about modifying snapshot permissions, see Share a snapshot in the Amazon Elastic Compute Cloud User Guide.
", + "ModifySnapshotAttribute": "Adds or removes permission settings for the specified snapshot. You may add or remove specified Amazon Web Services account IDs from a snapshot's list of create volume permissions, but you cannot do both in a single operation. If you need to both add and remove account IDs for a snapshot, you must use multiple operations. You can make up to 500 modifications to a snapshot in a single operation.
Encrypted snapshots and snapshots with Amazon Web Services Marketplace product codes cannot be made public. Snapshots encrypted with your default KMS key cannot be shared with other accounts.
For more information about modifying snapshot permissions, see Share a snapshot in the Amazon Elastic Compute Cloud User Guide.
", "ModifySpotFleetRequest": "Modifies the specified Spot Fleet request.
You can only modify a Spot Fleet request of type maintain
.
While the Spot Fleet request is being modified, it is in the modifying
state.
To scale up your Spot Fleet, increase its target capacity. The Spot Fleet launches the additional Spot Instances according to the allocation strategy for the Spot Fleet request. If the allocation strategy is lowestPrice
, the Spot Fleet launches instances using the Spot Instance pool with the lowest price. If the allocation strategy is diversified
, the Spot Fleet distributes the instances across the Spot Instance pools. If the allocation strategy is capacityOptimized
, Spot Fleet launches instances from Spot Instance pools with optimal capacity for the number of instances that are launching.
To scale down your Spot Fleet, decrease its target capacity. First, the Spot Fleet cancels any open requests that exceed the new target capacity. You can request that the Spot Fleet terminate Spot Instances until the size of the fleet no longer exceeds the new target capacity. If the allocation strategy is lowestPrice
, the Spot Fleet terminates the instances with the highest price per unit. If the allocation strategy is capacityOptimized
, the Spot Fleet terminates the instances in the Spot Instance pools that have the least available Spot Instance capacity. If the allocation strategy is diversified
, the Spot Fleet terminates instances across the Spot Instance pools. Alternatively, you can request that the Spot Fleet keep the fleet at its current size, but not replace any Spot Instances that are interrupted or that you terminate manually.
If you are finished with your Spot Fleet for now, but will use it again later, you can set the target capacity to 0.
", "ModifySubnetAttribute": "Modifies a subnet attribute. You can only modify one attribute at a time.
", "ModifyTrafficMirrorFilterNetworkServices": "Allows or restricts mirroring network services.
By default, Amazon DNS network services are not eligible for Traffic Mirror. Use AddNetworkServices
to add network services to a Traffic Mirror filter. When a network service is added to the Traffic Mirror filter, all traffic related to that network service will be mirrored. When you no longer want to mirror network services, use RemoveNetworkServices
to remove the network services from the Traffic Mirror filter.
For information about filter rule properties, see Network Services in the Traffic Mirroring User Guide .
", @@ -404,7 +404,7 @@ "ModifyVpcEndpointConnectionNotification": "Modifies a connection notification for VPC endpoint or VPC endpoint service. You can change the SNS topic for the notification, or the events for which to be notified.
", "ModifyVpcEndpointServiceConfiguration": "Modifies the attributes of your VPC endpoint service configuration. You can change the Network Load Balancers or Gateway Load Balancers for your service, and you can specify whether acceptance is required for requests to connect to your endpoint service through an interface VPC endpoint.
If you set or modify the private DNS name, you must prove that you own the private DNS domain name. For more information, see VPC Endpoint Service Private DNS Name Verification in the Amazon Virtual Private Cloud User Guide.
", "ModifyVpcEndpointServicePermissions": "Modifies the permissions for your VPC endpoint service. You can add or remove permissions for service consumers (IAM users, IAM roles, and AWS accounts) to connect to your endpoint service.
If you grant permissions to all principals, the service is public. Any users who know the name of a public service can send a request to attach an endpoint. If the service does not require manual approval, attachments are automatically approved.
", - "ModifyVpcPeeringConnectionOptions": "Modifies the VPC peering connection options on one side of a VPC peering connection. You can do the following:
Enable/disable communication over the peering connection between an EC2-Classic instance that's linked to your VPC (using ClassicLink) and instances in the peer VPC.
Enable/disable communication over the peering connection between instances in your VPC and an EC2-Classic instance that's linked to the peer VPC.
Enable/disable the ability to resolve public DNS hostnames to private IP addresses when queried from instances in the peer VPC.
If the peered VPCs are in the same account, you can enable DNS resolution for queries from the local VPC. This ensures that queries from the local VPC resolve to private IP addresses in the peer VPC. This option is not available if the peered VPCs are in different different accounts or different Regions. For peered VPCs in different accounts, each account owner must initiate a separate request to modify the peering connection options. For inter-region peering connections, you must use the Region for the requester VPC to modify the requester VPC peering options and the Region for the accepter VPC to modify the accepter VPC peering options. To verify which VPCs are the accepter and the requester for a VPC peering connection, use the DescribeVpcPeeringConnections command.
", + "ModifyVpcPeeringConnectionOptions": "Modifies the VPC peering connection options on one side of a VPC peering connection. You can do the following:
Enable/disable communication over the peering connection between an EC2-Classic instance that's linked to your VPC (using ClassicLink) and instances in the peer VPC.
Enable/disable communication over the peering connection between instances in your VPC and an EC2-Classic instance that's linked to the peer VPC.
Enable/disable the ability to resolve public DNS hostnames to private IP addresses when queried from instances in the peer VPC.
If the peered VPCs are in the same Amazon Web Services account, you can enable DNS resolution for queries from the local VPC. This ensures that queries from the local VPC resolve to private IP addresses in the peer VPC. This option is not available if the peered VPCs are in different different Amazon Web Services accounts or different Regions. For peered VPCs in different Amazon Web Services accounts, each Amazon Web Services account owner must initiate a separate request to modify the peering connection options. For inter-region peering connections, you must use the Region for the requester VPC to modify the requester VPC peering options and the Region for the accepter VPC to modify the accepter VPC peering options. To verify which VPCs are the accepter and the requester for a VPC peering connection, use the DescribeVpcPeeringConnections command.
", "ModifyVpcTenancy": "Modifies the instance tenancy attribute of the specified VPC. You can change the instance tenancy attribute of a VPC to default
only. You cannot change the instance tenancy attribute to dedicated
.
After you modify the tenancy of the VPC, any new instances that you launch into the VPC have a tenancy of default
, unless you specify otherwise during launch. The tenancy of any existing instances in the VPC is not affected.
For more information, see Dedicated Instances in the Amazon Elastic Compute Cloud User Guide.
", "ModifyVpnConnection": "Modifies the customer gateway or the target gateway of an AWS Site-to-Site VPN connection. To modify the target gateway, the following migration options are available:
An existing virtual private gateway to a new virtual private gateway
An existing virtual private gateway to a transit gateway
An existing transit gateway to a new transit gateway
An existing transit gateway to a virtual private gateway
Before you perform the migration to the new gateway, you must configure the new gateway. Use CreateVpnGateway to create a virtual private gateway, or CreateTransitGateway to create a transit gateway.
This step is required when you migrate from a virtual private gateway with static routes to a transit gateway.
You must delete the static routes before you migrate to the new gateway.
Keep a copy of the static route before you delete it. You will need to add back these routes to the transit gateway after the VPN connection migration is complete.
After you migrate to the new gateway, you might need to modify your VPC route table. Use CreateRoute and DeleteRoute to make the changes described in VPN Gateway Target Modification Required VPC Route Table Updates in the AWS Site-to-Site VPN User Guide.
When the new gateway is a transit gateway, modify the transit gateway route table to allow traffic between the VPC and the AWS Site-to-Site VPN connection. Use CreateTransitGatewayRoute to add the routes.
If you deleted VPN static routes, you must add the static routes to the transit gateway route table.
After you perform this operation, the AWS VPN endpoint's IP addresses on the AWS side and the tunnel options remain intact. Your AWS Site-to-Site VPN connection will be temporarily unavailable for a brief period while we provision the new endpoints.
", "ModifyVpnConnectionOptions": "Modifies the connection options for your Site-to-Site VPN connection.
When you modify the VPN connection options, the VPN endpoint IP addresses on the AWS side do not change, and the tunnel options do not change. Your VPN connection will be temporarily unavailable for a brief period while the VPN connection is updated.
", @@ -426,7 +426,7 @@ "RejectTransitGatewayVpcAttachment": "Rejects a request to attach a VPC to a transit gateway.
The VPC attachment must be in the pendingAcceptance
state. Use DescribeTransitGatewayVpcAttachments to view your pending VPC attachment requests. Use AcceptTransitGatewayVpcAttachment to accept a VPC attachment request.
Rejects one or more VPC endpoint connection requests to your VPC endpoint service.
", "RejectVpcPeeringConnection": "Rejects a VPC peering connection request. The VPC peering connection must be in the pending-acceptance
state. Use the DescribeVpcPeeringConnections request to view your outstanding VPC peering connection requests. To delete an active VPC peering connection, or to delete a VPC peering connection request that you initiated, use DeleteVpcPeeringConnection.
Releases the specified Elastic IP address.
[EC2-Classic, default VPC] Releasing an Elastic IP address automatically disassociates it from any instance that it's associated with. To disassociate an Elastic IP address without releasing it, use DisassociateAddress.
[Nondefault VPC] You must use DisassociateAddress to disassociate the Elastic IP address before you can release it. Otherwise, Amazon EC2 returns an error (InvalidIPAddress.InUse
).
After releasing an Elastic IP address, it is released to the IP address pool. Be sure to update your DNS records and any servers or devices that communicate with the address. If you attempt to release an Elastic IP address that you already released, you'll get an AuthFailure
error if the address is already allocated to another account.
[EC2-VPC] After you release an Elastic IP address for use in a VPC, you might be able to recover it. For more information, see AllocateAddress.
", + "ReleaseAddress": "Releases the specified Elastic IP address.
[EC2-Classic, default VPC] Releasing an Elastic IP address automatically disassociates it from any instance that it's associated with. To disassociate an Elastic IP address without releasing it, use DisassociateAddress.
[Nondefault VPC] You must use DisassociateAddress to disassociate the Elastic IP address before you can release it. Otherwise, Amazon EC2 returns an error (InvalidIPAddress.InUse
).
After releasing an Elastic IP address, it is released to the IP address pool. Be sure to update your DNS records and any servers or devices that communicate with the address. If you attempt to release an Elastic IP address that you already released, you'll get an AuthFailure
error if the address is already allocated to another Amazon Web Services account.
[EC2-VPC] After you release an Elastic IP address for use in a VPC, you might be able to recover it. For more information, see AllocateAddress.
", "ReleaseHosts": "When you no longer want to use an On-Demand Dedicated Host it can be released. On-Demand billing is stopped and the host goes into released
state. The host ID of Dedicated Hosts that have been released can no longer be specified in another request, for example, to modify the host. You must stop or terminate all instances on a host before it can be released.
When Dedicated Hosts are released, it may take some time for them to stop counting toward your limit and you may receive capacity errors when trying to allocate new Dedicated Hosts. Wait a few minutes and then try again.
Released hosts still appear in a DescribeHosts response.
", "ReplaceIamInstanceProfileAssociation": "Replaces an IAM instance profile for the specified running instance. You can use this action to change the IAM instance profile that's associated with an instance without having to disassociate the existing IAM instance profile first.
Use DescribeIamInstanceProfileAssociations to get the association ID.
", "ReplaceNetworkAclAssociation": "Changes which network ACL a subnet is associated with. By default when you create a subnet, it's automatically associated with the default network ACL. For more information, see Network ACLs in the Amazon Virtual Private Cloud User Guide.
This is an idempotent operation.
", @@ -2394,8 +2394,8 @@ "CapacityReservationTenancy": { "base": null, "refs": { - "CapacityReservation$Tenancy": "Indicates the tenancy of the Capacity Reservation. A Capacity Reservation can have one of the following tenancy settings:
default
- The Capacity Reservation is created on hardware that is shared with other accounts.
dedicated
- The Capacity Reservation is created on single-tenant hardware that is dedicated to a single account.
Indicates the tenancy of the Capacity Reservation. A Capacity Reservation can have one of the following tenancy settings:
default
- The Capacity Reservation is created on hardware that is shared with other accounts.
dedicated
- The Capacity Reservation is created on single-tenant hardware that is dedicated to a single account.
Indicates the tenancy of the Capacity Reservation. A Capacity Reservation can have one of the following tenancy settings:
default
- The Capacity Reservation is created on hardware that is shared with other Amazon Web Services accounts.
dedicated
- The Capacity Reservation is created on single-tenant hardware that is dedicated to a single Amazon Web Services account.
Indicates the tenancy of the Capacity Reservation. A Capacity Reservation can have one of the following tenancy settings:
default
- The Capacity Reservation is created on hardware that is shared with other Amazon Web Services accounts.
dedicated
- The Capacity Reservation is created on single-tenant hardware that is dedicated to a single Amazon Web Services account.
Provides authorization for Amazon to bring a specific IP address range to a specific account using bring your own IP addresses (BYOIP). For more information, see Configuring your BYOIP address range in the Amazon Elastic Compute Cloud User Guide.
", + "base": "Provides authorization for Amazon to bring a specific IP address range to a specific Amazon Web Services account using bring your own IP addresses (BYOIP). For more information, see Configuring your BYOIP address range in the Amazon Elastic Compute Cloud User Guide.
", "refs": { "ProvisionByoipCidrRequest$CidrAuthorizationContext": "A signed document that proves that you are authorized to bring the specified IP address range to Amazon using BYOIP.
" } @@ -3511,8 +3511,8 @@ "CreateVolumePermissionList": { "base": null, "refs": { - "CreateVolumePermissionModifications$Add": "Adds the specified account ID or group to the list.
", - "CreateVolumePermissionModifications$Remove": "Removes the specified account ID or group from the list.
", + "CreateVolumePermissionModifications$Add": "Adds the specified Amazon Web Services account ID or group to the list.
", + "CreateVolumePermissionModifications$Remove": "Removes the specified Amazon Web Services account ID or group from the list.
", "DescribeSnapshotAttributeResult$CreateVolumePermissions": "The users and groups that have the permissions for creating volumes from the snapshot.
" } }, @@ -7012,11 +7012,11 @@ "FilterList": { "base": null, "refs": { - "DescribeAddressesRequest$Filters": "One or more filters. Filter names and values are case-sensitive.
allocation-id
- [EC2-VPC] The allocation ID for the address.
association-id
- [EC2-VPC] The association ID for the address.
domain
- Indicates whether the address is for use in EC2-Classic (standard
) or in a VPC (vpc
).
instance-id
- The ID of the instance the address is associated with, if any.
network-border-group
- A unique set of Availability Zones, Local Zones, or Wavelength Zones from where Amazon Web Services advertises IP addresses.
network-interface-id
- [EC2-VPC] The ID of the network interface that the address is associated with, if any.
network-interface-owner-id
- The account ID of the owner.
private-ip-address
- [EC2-VPC] The private IP address associated with the Elastic IP address.
public-ip
- The Elastic IP address, or the carrier IP address.
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. Filter names and values are case-sensitive.
allocation-id
- [EC2-VPC] The allocation ID for the address.
association-id
- [EC2-VPC] The association ID for the address.
domain
- Indicates whether the address is for use in EC2-Classic (standard
) or in a VPC (vpc
).
instance-id
- The ID of the instance the address is associated with, if any.
network-border-group
- A unique set of Availability Zones, Local Zones, or Wavelength Zones from where Amazon Web Services advertises IP addresses.
network-interface-id
- [EC2-VPC] The ID of the network interface that the address is associated with, if any.
network-interface-owner-id
- The Amazon Web Services account ID of the owner.
private-ip-address
- [EC2-VPC] The private IP address associated with the Elastic IP address.
public-ip
- The Elastic IP address, or the carrier IP address.
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.
The filters.
group-name
- For Availability Zones, use the Region name. For Local Zones, use the name of the group associated with the Local Zone (for example, us-west-2-lax-1
) For Wavelength Zones, use the name of the group associated with the Wavelength Zone (for example, us-east-1-wl1-bos-wlz-1
).
message
- The Zone message.
opt-in-status
- The opt-in status (opted-in
, and not-opted-in
| opt-in-not-required
).
parent-zoneID
- The ID of the zone that handles some of the Local Zone and Wavelength Zone control plane operations, such as API calls.
parent-zoneName
- The ID of the zone that handles some of the Local Zone and Wavelength Zone control plane operations, such as API calls.
region-name
- The name of the Region for the Zone (for example, us-east-1
).
state
- The state of the Availability Zone, the Local Zone, or the Wavelength Zone (available
| information
| impaired
| unavailable
).
zone-id
- The ID of the Availability Zone (for example, use1-az1
), the Local Zone (for example, usw2-lax1-az1
), or the Wavelength Zone (for example, us-east-1-wl1-bos-wlz-1
).
zone-type
- The type of zone, for example, local-zone
.
zone-name
- The name of the Availability Zone (for example, us-east-1a
), the Local Zone (for example, us-west-2-lax-1a
), or the Wavelength Zone (for example, us-east-1-wl1-bos-wlz-1
).
zone-type
- The type of zone, for example, local-zone
.
The filters.
bundle-id
- The ID of the bundle task.
error-code
- If the task failed, the error code returned.
error-message
- If the task failed, the error message returned.
instance-id
- The ID of the instance.
progress
- The level of task completion, as a percentage (for example, 20%).
s3-bucket
- The Amazon S3 bucket to store the AMI.
s3-prefix
- The beginning of the AMI name.
start-time
- The time the task started (for example, 2013-09-15T17:15:20.000Z).
state
- The state of the task (pending
| waiting-for-shutdown
| bundling
| storing
| cancelling
| complete
| failed
).
update-time
- The time of the most recent update for the task.
One or more filters.
instance-type
- The type of instance for which the Capacity Reservation reserves capacity.
owner-id
- The ID of the account that owns the Capacity Reservation.
availability-zone-id
- The Availability Zone ID of the Capacity Reservation.
instance-platform
- The type of operating system for which the Capacity Reservation reserves capacity.
availability-zone
- The Availability Zone ID of the Capacity Reservation.
tenancy
- Indicates the tenancy of the Capacity Reservation. A Capacity Reservation can have one of the following tenancy settings:
default
- The Capacity Reservation is created on hardware that is shared with other accounts.
dedicated
- The Capacity Reservation is created on single-tenant hardware that is dedicated to a single account.
outpost-arn
- The Amazon Resource Name (ARN) of the Outpost on which the Capacity Reservation was created.
state
- The current state of the Capacity Reservation. A Capacity Reservation can be in one of the following states:
active
- The Capacity Reservation is active and the capacity is available for your use.
expired
- The Capacity Reservation expired automatically at the date and time specified in your request. The reserved capacity is no longer available for your use.
cancelled
- The Capacity Reservation was cancelled. The reserved capacity is no longer available for your use.
pending
- The Capacity Reservation request was successful but the capacity provisioning is still pending.
failed
- The Capacity Reservation request has failed. A request might fail due to invalid request parameters, capacity constraints, or instance limit constraints. Failed requests are retained for 60 minutes.
start-date
- The date and time at which the Capacity Reservation was started.
end-date
- The date and time at which the Capacity Reservation expires. When a Capacity Reservation expires, the reserved capacity is released and you can no longer launch instances into it. The Capacity Reservation's state changes to expired when it reaches its end date and time.
end-date-type
- Indicates the way in which the Capacity Reservation ends. A Capacity Reservation can have one of the following end types:
unlimited
- The Capacity Reservation remains active until you explicitly cancel it.
limited
- The Capacity Reservation expires automatically at a specified date and time.
instance-match-criteria
- Indicates the type of instance launches that the Capacity Reservation accepts. The options include:
open
- The Capacity Reservation accepts all instances that have matching attributes (instance type, platform, and Availability Zone). Instances that have matching attributes launch into the Capacity Reservation automatically without specifying any additional parameters.
targeted
- The Capacity Reservation only accepts instances that have matching attributes (instance type, platform, and Availability Zone), and explicitly target the Capacity Reservation. This ensures that only permitted instances can use the reserved capacity.
One or more filters.
carrier-gateway-id
- The ID of the carrier gateway.
state
- The state of the carrier gateway (pending
| failed
| available
| deleting
| deleted
).
owner-id
- The account ID of the owner of the carrier 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.
vpc-id
- The ID of the VPC associated with the carrier gateway.
One or more filters.
instance-type
- The type of instance for which the Capacity Reservation reserves capacity.
owner-id
- The ID of the Amazon Web Services account that owns the Capacity Reservation.
availability-zone-id
- The Availability Zone ID of the Capacity Reservation.
instance-platform
- The type of operating system for which the Capacity Reservation reserves capacity.
availability-zone
- The Availability Zone ID of the Capacity Reservation.
tenancy
- Indicates the tenancy of the Capacity Reservation. A Capacity Reservation can have one of the following tenancy settings:
default
- The Capacity Reservation is created on hardware that is shared with other Amazon Web Services accounts.
dedicated
- The Capacity Reservation is created on single-tenant hardware that is dedicated to a single Amazon Web Services account.
outpost-arn
- The Amazon Resource Name (ARN) of the Outpost on which the Capacity Reservation was created.
state
- The current state of the Capacity Reservation. A Capacity Reservation can be in one of the following states:
active
- The Capacity Reservation is active and the capacity is available for your use.
expired
- The Capacity Reservation expired automatically at the date and time specified in your request. The reserved capacity is no longer available for your use.
cancelled
- The Capacity Reservation was cancelled. The reserved capacity is no longer available for your use.
pending
- The Capacity Reservation request was successful but the capacity provisioning is still pending.
failed
- The Capacity Reservation request has failed. A request might fail due to invalid request parameters, capacity constraints, or instance limit constraints. Failed requests are retained for 60 minutes.
start-date
- The date and time at which the Capacity Reservation was started.
end-date
- The date and time at which the Capacity Reservation expires. When a Capacity Reservation expires, the reserved capacity is released and you can no longer launch instances into it. The Capacity Reservation's state changes to expired when it reaches its end date and time.
end-date-type
- Indicates the way in which the Capacity Reservation ends. A Capacity Reservation can have one of the following end types:
unlimited
- The Capacity Reservation remains active until you explicitly cancel it.
limited
- The Capacity Reservation expires automatically at a specified date and time.
instance-match-criteria
- Indicates the type of instance launches that the Capacity Reservation accepts. The options include:
open
- The Capacity Reservation accepts all instances that have matching attributes (instance type, platform, and Availability Zone). Instances that have matching attributes launch into the Capacity Reservation automatically without specifying any additional parameters.
targeted
- The Capacity Reservation only accepts instances that have matching attributes (instance type, platform, and Availability Zone), and explicitly target the Capacity Reservation. This ensures that only permitted instances can use the reserved capacity.
One or more filters.
carrier-gateway-id
- The ID of the carrier gateway.
state
- The state of the carrier gateway (pending
| failed
| available
| deleting
| deleted
).
owner-id
- The Amazon Web Services account ID of the owner of the carrier 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.
vpc-id
- The ID of the VPC associated with the carrier gateway.
One or more filters.
group-id
- The ID of a VPC security group that's associated with the instance.
instance-id
- The ID of 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 assigned a tag with a specific key, regardless of the tag value.
vpc-id
- The ID of the VPC to which the instance is linked.
vpc-id
- The ID of the VPC that the instance is linked to.
One or more filters. Filter names and values are case-sensitive.
description
- The description of the authorization rule.
destination-cidr
- The CIDR of the network to which the authorization rule applies.
group-id
- The ID of the Active Directory group to which the authorization rule grants access.
One or more filters. Filter names and values are case-sensitive.
connection-id
- The ID of the connection.
username
- For Active Directory client authentication, the user name of the client who established the client connection.
One or more filters. Filter names and values are case-sensitive.
association-id
- The ID of the association.
target-network-id
- The ID of the subnet specified as the target network.
vpc-id
- The ID of the VPC in which the target network is located.
The filters. The following are the possible values:
coip-pool.pool-id
coip-pool.local-gateway-route-table-id
One or more filters.
bgp-asn
- The customer gateway's Border Gateway Protocol (BGP) Autonomous System Number (ASN).
customer-gateway-id
- The ID of the customer gateway.
ip-address
- The IP address of the customer gateway's Internet-routable external interface.
state
- The state of the customer gateway (pending
| available
| deleting
| deleted
).
type
- The type of customer gateway. Currently, the only supported type is ipsec.1
.
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.
dhcp-options-id
- The ID of a DHCP options set.
key
- The key for one of the options (for example, domain-name
).
value
- The value for one of the options.
owner-id
- The ID of the account that owns the DHCP options set.
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.
dhcp-options-id
- The ID of a DHCP options set.
key
- The key for one of the options (for example, domain-name
).
value
- The value for one of the options.
owner-id
- The ID of the Amazon Web Services account that owns the DHCP options set.
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.
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.
The filters.
availability-zone
- The Availability Zone in which the Elastic Graphics accelerator resides.
elastic-gpu-health
- The status of the Elastic Graphics accelerator (OK
| IMPAIRED
).
elastic-gpu-state
- The state of the Elastic Graphics accelerator (ATTACHED
).
elastic-gpu-type
- The type of Elastic Graphics accelerator; for example, eg1.medium
.
instance-id
- The ID of the instance to which the Elastic Graphics accelerator is associated.
Filter tasks using the task-state
filter and one of the following values: active
, completed
, deleting
, or deleted
.
the filters for the export tasks.
", - "DescribeFastSnapshotRestoresRequest$Filters": "The filters. The possible values are:
availability-zone
: The Availability Zone of the snapshot.
owner-id
: The ID of the account that enabled fast snapshot restore on the snapshot.
snapshot-id
: The ID of the snapshot.
state
: The state of fast snapshot restores for the snapshot (enabling
| optimizing
| enabled
| disabling
| disabled
).
The filters. The possible values are:
availability-zone
: The Availability Zone of the snapshot.
owner-id
: The ID of the Amazon Web Services account that enabled fast snapshot restore on the snapshot.
snapshot-id
: The ID of the snapshot.
state
: The state of fast snapshot restores for the snapshot (enabling
| optimizing
| enabled
| disabling
| disabled
).
The filters.
instance-type
- The instance type.
The filters.
activity-status
- The progress of the EC2 Fleet ( error
| pending-fulfillment
| pending-termination
| fulfilled
).
excess-capacity-termination-policy
- Indicates whether to terminate running instances if the target capacity is decreased below the current EC2 Fleet size (true
| false
).
fleet-state
- The state of the EC2 Fleet (submitted
| active
| deleted
| failed
| deleted-running
| deleted-terminating
| modifying
).
replace-unhealthy-instances
- Indicates whether EC2 Fleet should replace unhealthy instances (true
| false
).
type
- The type of request (instant
| request
| maintain
).
One or more filters.
deliver-log-status
- The status of the logs delivery (SUCCESS
| FAILED
).
log-destination-type
- The type of destination to which the flow log publishes data. Possible destination types include cloud-watch-logs
and s3
.
flow-log-id
- The ID of the flow log.
log-group-name
- The name of the log group.
resource-id
- The ID of the VPC, subnet, or network interface.
traffic-type
- The type of traffic (ACCEPT
| REJECT
| ALL
).
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.
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 auto recovery is supported (true
| false
).
bare-metal
- Indicates whether it is a bare metal instance type (true
| false
).
burstable-performance-supported
- Indicates whether it is a burstable performance 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.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.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-interfaces
- The maximum number of network interfaces per instance.
network-info.network-performance
- The network performance (for example, \"25 Gigabit\").
processor-info.supported-architecture
- The CPU architecture (arm64
| i386
| x86_64
).
processor-info.sustained-clock-speed-in-ghz
- The CPU clock speed, in GHz.
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.
client-token
- The idempotency token you provided when you launched the instance.
dns-name
- The public DNS name of the instance.
group-id
- The ID of the security group for the instance. EC2-Classic only.
group-name
- The name of the security group for the instance. EC2-Classic only.
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.
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
- Enable or disable metadata access on http endpoint (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 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, 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.
One or more 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 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.
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.
client-token
- The idempotency token you provided when you launched the instance.
dns-name
- The public DNS name of the instance.
group-id
- The ID of the security group for the instance. EC2-Classic only.
group-name
- The name of the security group for the instance. EC2-Classic only.
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.
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
- Enable or disable metadata access on http endpoint (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.
One or more 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.
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.
The filters.
key-pair-id
- The ID of the key pair.
fingerprint
- The fingerprint of the key pair.
key-name
- The name of the key pair.
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.
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.
One or more filters.
create-time
- The time the launch template version was created.
ebs-optimized
- A boolean that indicates whether the instance is optimized for Amazon EBS I/O.
iam-instance-profile
- The ARN of the IAM instance profile.
image-id
- The ID of the AMI.
instance-type
- The instance type.
is-default-version
- A boolean that indicates whether the launch template version is the default version.
kernel-id
- The kernel ID.
ram-disk-id
- The RAM disk ID.
One or more filters.
owner-id
- The ID of the prefix list owner.
prefix-list-id
- The ID of the prefix list.
prefix-list-name
- The name of the prefix list.
One or more filters.
moving-status
- The status of the Elastic IP address (MovingToVpc
| RestoringToClassic
).
One or more filters.
nat-gateway-id
- The ID of the NAT gateway.
state
- The state of the NAT gateway (pending
| failed
| available
| deleting
| deleted
).
subnet-id
- The ID of the subnet in which the NAT gateway resides.
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.
vpc-id
- The ID of the VPC in which the NAT gateway resides.
One or more filters.
association.association-id
- The ID of an association ID for the ACL.
association.network-acl-id
- The ID of the network ACL involved in the association.
association.subnet-id
- The ID of the subnet involved in the association.
default
- Indicates whether the ACL is the default network ACL for the VPC.
entry.cidr
- The IPv4 CIDR range specified in the entry.
entry.icmp.code
- The ICMP code specified in the entry, if any.
entry.icmp.type
- The ICMP type specified in the entry, if any.
entry.ipv6-cidr
- The IPv6 CIDR range specified in the entry.
entry.port-range.from
- The start of the port range specified in the entry.
entry.port-range.to
- The end of the port range specified in the entry.
entry.protocol
- The protocol specified in the entry (tcp
| udp
| icmp
or a protocol number).
entry.rule-action
- Allows or denies the matching traffic (allow
| deny
).
entry.rule-number
- The number of an entry (in other words, rule) in the set of ACL entries.
network-acl-id
- The ID of the network ACL.
owner-id
- The ID of the account that owns the network ACL.
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.
vpc-id
- The ID of the VPC for the network ACL.
One or more filters.
association.association-id
- The ID of an association ID for the ACL.
association.network-acl-id
- The ID of the network ACL involved in the association.
association.subnet-id
- The ID of the subnet involved in the association.
default
- Indicates whether the ACL is the default network ACL for the VPC.
entry.cidr
- The IPv4 CIDR range specified in the entry.
entry.icmp.code
- The ICMP code specified in the entry, if any.
entry.icmp.type
- The ICMP type specified in the entry, if any.
entry.ipv6-cidr
- The IPv6 CIDR range specified in the entry.
entry.port-range.from
- The start of the port range specified in the entry.
entry.port-range.to
- The end of the port range specified in the entry.
entry.protocol
- The protocol specified in the entry (tcp
| udp
| icmp
or a protocol number).
entry.rule-action
- Allows or denies the matching traffic (allow
| deny
).
entry.rule-number
- The number of an entry (in other words, rule) in the set of ACL entries.
network-acl-id
- The ID of the network ACL.
owner-id
- The ID of the Amazon Web Services account that owns the network ACL.
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.
vpc-id
- The ID of the VPC for the network ACL.
The filters. The following are possible values:
PathFound - A Boolean value that indicates whether a feasible path is found.
Status - The status of the analysis (running | succeeded | failed).
The filters. The following are possible values:
Destination - The ID of the resource.
DestinationPort - The destination port.
Name - The path name.
Protocol - The protocol.
Source - The ID of the resource.
One or more filters.
network-interface-permission.network-interface-permission-id
- The ID of the permission.
network-interface-permission.network-interface-id
- The ID of the network interface.
network-interface-permission.aws-account-id
- The account ID.
network-interface-permission.aws-service
- The Amazon Web Service.
network-interface-permission.permission
- The type of permission (INSTANCE-ATTACH
| EIP-ASSOCIATE
).
One or more filters.
addresses.private-ip-address
- The private IPv4 addresses associated with the network interface.
addresses.primary
- Whether the private IPv4 address is the primary IP address associated with the network interface.
addresses.association.public-ip
- The association ID returned when the network interface was associated with the Elastic IP address (IPv4).
addresses.association.owner-id
- The owner ID of the addresses associated with the network interface.
association.association-id
- The association ID returned when the network interface was associated with an IPv4 address.
association.allocation-id
- The allocation ID returned when you allocated the Elastic IP address (IPv4) for your network interface.
association.ip-owner-id
- The owner of the Elastic IP address (IPv4) associated with the network interface.
association.public-ip
- The address of the Elastic IP address (IPv4) bound to the network interface.
association.public-dns-name
- The public DNS name for the network interface (IPv4).
attachment.attachment-id
- The ID of the interface attachment.
attachment.attach-time
- The time that the network interface was attached to an instance.
attachment.delete-on-termination
- Indicates whether the attachment is deleted when an instance is terminated.
attachment.device-index
- The device index to which the network interface is attached.
attachment.instance-id
- The ID of the instance to which the network interface is attached.
attachment.instance-owner-id
- The owner ID of the instance to which the network interface is attached.
attachment.status
- The status of the attachment (attaching
| attached
| detaching
| detached
).
availability-zone
- The Availability Zone of the network interface.
description
- The description of the network interface.
group-id
- The ID of a security group associated with the network interface.
group-name
- The name of a security group associated with the network interface.
ipv6-addresses.ipv6-address
- An IPv6 address associated with the network interface.
mac-address
- The MAC address of the network interface.
network-interface-id
- The ID of the network interface.
owner-id
- The account ID of the network interface owner.
private-ip-address
- The private IPv4 address or addresses of the network interface.
private-dns-name
- The private DNS name of the network interface (IPv4).
requester-id
- The alias or account ID of the principal or service that created the network interface.
requester-managed
- Indicates whether the network interface is being managed by an Amazon Web Service (for example, Management Console, Auto Scaling, and so on).
source-dest-check
- Indicates whether the network interface performs source/destination checking. A value of true
means checking is enabled, and false
means checking is disabled. The value must be false
for the network interface to perform network address translation (NAT) in your VPC.
status
- The status of the network interface. If the network interface is not attached to an instance, the status is available
; if a network interface is attached to an instance the status is in-use
.
subnet-id
- The ID of the subnet for the network interface.
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.
vpc-id
- The ID of the VPC for the network interface.
One or more filters.
network-interface-permission.network-interface-permission-id
- The ID of the permission.
network-interface-permission.network-interface-id
- The ID of the network interface.
network-interface-permission.aws-account-id
- The Amazon Web Services account ID.
network-interface-permission.aws-service
- The Amazon Web Service.
network-interface-permission.permission
- The type of permission (INSTANCE-ATTACH
| EIP-ASSOCIATE
).
One or more filters.
addresses.private-ip-address
- The private IPv4 addresses associated with the network interface.
addresses.primary
- Whether the private IPv4 address is the primary IP address associated with the network interface.
addresses.association.public-ip
- The association ID returned when the network interface was associated with the Elastic IP address (IPv4).
addresses.association.owner-id
- The owner ID of the addresses associated with the network interface.
association.association-id
- The association ID returned when the network interface was associated with an IPv4 address.
association.allocation-id
- The allocation ID returned when you allocated the Elastic IP address (IPv4) for your network interface.
association.ip-owner-id
- The owner of the Elastic IP address (IPv4) associated with the network interface.
association.public-ip
- The address of the Elastic IP address (IPv4) bound to the network interface.
association.public-dns-name
- The public DNS name for the network interface (IPv4).
attachment.attachment-id
- The ID of the interface attachment.
attachment.attach-time
- The time that the network interface was attached to an instance.
attachment.delete-on-termination
- Indicates whether the attachment is deleted when an instance is terminated.
attachment.device-index
- The device index to which the network interface is attached.
attachment.instance-id
- The ID of the instance to which the network interface is attached.
attachment.instance-owner-id
- The owner ID of the instance to which the network interface is attached.
attachment.status
- The status of the attachment (attaching
| attached
| detaching
| detached
).
availability-zone
- The Availability Zone of the network interface.
description
- The description of the network interface.
group-id
- The ID of a security group associated with the network interface.
group-name
- The name of a security group associated with the network interface.
ipv6-addresses.ipv6-address
- An IPv6 address associated with the network interface.
mac-address
- The MAC address of the network interface.
network-interface-id
- The ID of the network interface.
owner-id
- The Amazon Web Services account ID of the network interface owner.
private-ip-address
- The private IPv4 address or addresses of the network interface.
private-dns-name
- The private DNS name of the network interface (IPv4).
requester-id
- The alias or Amazon Web Services account ID of the principal or service that created the network interface.
requester-managed
- Indicates whether the network interface is being managed by an Amazon Web Service (for example, Amazon Web Services Management Console, Auto Scaling, and so on).
source-dest-check
- Indicates whether the network interface performs source/destination checking. A value of true
means checking is enabled, and false
means checking is disabled. The value must be false
for the network interface to perform network address translation (NAT) in your VPC.
status
- The status of the network interface. If the network interface is not attached to an instance, the status is available
; if a network interface is attached to an instance the status is in-use
.
subnet-id
- The ID of the subnet for the network interface.
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.
vpc-id
- The ID of the VPC for the network interface.
The filters.
group-name
- The name of the placement group.
state
- The state of the placement group (pending
| available
| deleting
| deleted
).
strategy
- The strategy of the placement group (cluster
| spread
| partition
).
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.
One or more filters.
prefix-list-id
: The ID of a prefix list.
prefix-list-name
: The name of a prefix list.
One or more filters.
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.
client-token
- The idempotency token for the modification request.
create-date
- The time when the modification request was created.
effective-date
- The time when the modification becomes effective.
modification-result.reserved-instances-id
- The ID for the Reserved Instances created as part of the modification request. This ID is only available when the status of the modification is fulfilled
.
modification-result.target-configuration.availability-zone
- The Availability Zone for the new Reserved Instances.
modification-result.target-configuration.instance-count
- The number of new Reserved Instances.
modification-result.target-configuration.instance-type
- The instance type of the new Reserved Instances.
modification-result.target-configuration.platform
- The network platform of the new Reserved Instances (EC2-Classic
| EC2-VPC
).
reserved-instances-id
- The ID of the Reserved Instances modified.
reserved-instances-modification-id
- The ID of the modification request.
status
- The status of the Reserved Instances modification request (processing
| fulfilled
| failed
).
status-message
- The reason for the status.
update-date
- The time when the modification request was last updated.
One or more filters.
availability-zone
- The Availability Zone where the Reserved Instance can be used.
duration
- The duration of the Reserved Instance (for example, one year or three years), in seconds (31536000
| 94608000
).
fixed-price
- The purchase price of the Reserved Instance (for example, 9800.0).
instance-type
- The instance type that is covered by the reservation.
marketplace
- Set to true
to show only Reserved Instance Marketplace offerings. When this filter is not used, which is the default behavior, all offerings from both Amazon Web Services and the Reserved Instance Marketplace are listed.
product-description
- The Reserved Instance product platform description. Instances that include (Amazon VPC)
in the product platform description will only be displayed to EC2-Classic account holders and are for use with Amazon VPC. (Linux/UNIX
| Linux/UNIX (Amazon VPC)
| SUSE Linux
| SUSE Linux (Amazon VPC)
| Red Hat Enterprise Linux
| Red Hat Enterprise Linux (Amazon VPC)
| Red Hat Enterprise Linux with HA (Amazon VPC)
| Windows
| Windows (Amazon VPC)
| Windows with SQL Server Standard
| Windows with SQL Server Standard (Amazon VPC)
| Windows with SQL Server Web
| Windows with SQL Server Web (Amazon VPC)
| Windows with SQL Server Enterprise
| Windows with SQL Server Enterprise (Amazon VPC)
)
reserved-instances-offering-id
- The Reserved Instances offering ID.
scope
- The scope of the Reserved Instance (Availability Zone
or Region
).
usage-price
- The usage price of the Reserved Instance, per hour (for example, 0.84).
One or more filters.
availability-zone
- The Availability Zone where the Reserved Instance can be used.
duration
- The duration of the Reserved Instance (one year or three years), in seconds (31536000
| 94608000
).
end
- The time when the Reserved Instance expires (for example, 2015-08-07T11:54:42.000Z).
fixed-price
- The purchase price of the Reserved Instance (for example, 9800.0).
instance-type
- The instance type that is covered by the reservation.
scope
- The scope of the Reserved Instance (Region
or Availability Zone
).
product-description
- The Reserved Instance product platform description. Instances that include (Amazon VPC)
in the product platform description will only be displayed to EC2-Classic account holders and are for use with Amazon VPC (Linux/UNIX
| Linux/UNIX (Amazon VPC)
| SUSE Linux
| SUSE Linux (Amazon VPC)
| Red Hat Enterprise Linux
| Red Hat Enterprise Linux (Amazon VPC)
| Red Hat Enterprise Linux with HA (Amazon VPC)
| Windows
| Windows (Amazon VPC)
| Windows with SQL Server Standard
| Windows with SQL Server Standard (Amazon VPC)
| Windows with SQL Server Web
| Windows with SQL Server Web (Amazon VPC)
| Windows with SQL Server Enterprise
| Windows with SQL Server Enterprise (Amazon VPC)
).
reserved-instances-id
- The ID of the Reserved Instance.
start
- The time at which the Reserved Instance purchase request was placed (for example, 2014-08-07T11:54:42.000Z).
state
- The state of the Reserved Instance (payment-pending
| active
| payment-failed
| retired
).
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.
usage-price
- The usage price of the Reserved Instance, per hour (for example, 0.84).
One or more filters.
association.route-table-association-id
- The ID of an association ID for the route table.
association.route-table-id
- The ID of the route table involved in the association.
association.subnet-id
- The ID of the subnet involved in the association.
association.main
- Indicates whether the route table is the main route table for the VPC (true
| false
). Route tables that do not have an association ID are not returned in the response.
owner-id
- The ID of the account that owns the route table.
route-table-id
- The ID of the route table.
route.destination-cidr-block
- The IPv4 CIDR range specified in a route in the table.
route.destination-ipv6-cidr-block
- The IPv6 CIDR range specified in a route in the route table.
route.destination-prefix-list-id
- The ID (prefix) of the Amazon Web Service specified in a route in the table.
route.egress-only-internet-gateway-id
- The ID of an egress-only Internet gateway specified in a route in the route table.
route.gateway-id
- The ID of a gateway specified in a route in the table.
route.instance-id
- The ID of an instance specified in a route in the table.
route.nat-gateway-id
- The ID of a NAT gateway.
route.transit-gateway-id
- The ID of a transit gateway.
route.origin
- Describes how the route was created. CreateRouteTable
indicates that the route was automatically created when the route table was created; CreateRoute
indicates that the route was manually added to the route table; EnableVgwRoutePropagation
indicates that the route was propagated by route propagation.
route.state
- The state of a route in the route table (active
| blackhole
). The blackhole state indicates that the route's target isn't available (for example, the specified gateway isn't attached to the VPC, the specified NAT instance has been terminated, and so on).
route.vpc-peering-connection-id
- The ID of a VPC peering connection specified in a route in the table.
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.
vpc-id
- The ID of the VPC for the route table.
One or more filters.
association.route-table-association-id
- The ID of an association ID for the route table.
association.route-table-id
- The ID of the route table involved in the association.
association.subnet-id
- The ID of the subnet involved in the association.
association.main
- Indicates whether the route table is the main route table for the VPC (true
| false
). Route tables that do not have an association ID are not returned in the response.
owner-id
- The ID of the Amazon Web Services account that owns the route table.
route-table-id
- The ID of the route table.
route.destination-cidr-block
- The IPv4 CIDR range specified in a route in the table.
route.destination-ipv6-cidr-block
- The IPv6 CIDR range specified in a route in the route table.
route.destination-prefix-list-id
- The ID (prefix) of the Amazon Web Service specified in a route in the table.
route.egress-only-internet-gateway-id
- The ID of an egress-only Internet gateway specified in a route in the route table.
route.gateway-id
- The ID of a gateway specified in a route in the table.
route.instance-id
- The ID of an instance specified in a route in the table.
route.nat-gateway-id
- The ID of a NAT gateway.
route.transit-gateway-id
- The ID of a transit gateway.
route.origin
- Describes how the route was created. CreateRouteTable
indicates that the route was automatically created when the route table was created; CreateRoute
indicates that the route was manually added to the route table; EnableVgwRoutePropagation
indicates that the route was propagated by route propagation.
route.state
- The state of a route in the route table (active
| blackhole
). The blackhole state indicates that the route's target isn't available (for example, the specified gateway isn't attached to the VPC, the specified NAT instance has been terminated, and so on).
route.vpc-peering-connection-id
- The ID of a VPC peering connection specified in a route in the table.
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.
vpc-id
- The ID of the VPC for the route table.
The filters.
availability-zone
- The Availability Zone (for example, us-west-2a
).
instance-type
- The instance type (for example, c4.large
).
network-platform
- The network platform (EC2-Classic
or EC2-VPC
).
platform
- The platform (Linux/UNIX
or Windows
).
The filters.
availability-zone
- The Availability Zone (for example, us-west-2a
).
instance-type
- The instance type (for example, c4.large
).
network-platform
- The network platform (EC2-Classic
or EC2-VPC
).
platform
- The platform (Linux/UNIX
or Windows
).
One or more filters.
group-id
- The ID of the security group.
security-group-rule-id
- The ID of the security group rule.
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.
The filters. If using multiple filters for rules, the results include security groups for which any combination of rules - not necessarily a single rule - match all filters.
description
- The description of the security group.
egress.ip-permission.cidr
- An IPv4 CIDR block for an outbound security group rule.
egress.ip-permission.from-port
- For an outbound rule, the start of port range for the TCP and UDP protocols, or an ICMP type number.
egress.ip-permission.group-id
- The ID of a security group that has been referenced in an outbound security group rule.
egress.ip-permission.group-name
- The name of a security group that is referenced in an outbound security group rule.
egress.ip-permission.ipv6-cidr
- An IPv6 CIDR block for an outbound security group rule.
egress.ip-permission.prefix-list-id
- The ID of a prefix list to which a security group rule allows outbound access.
egress.ip-permission.protocol
- The IP protocol for an outbound security group rule (tcp
| udp
| icmp
, a protocol number, or -1 for all protocols).
egress.ip-permission.to-port
- For an outbound rule, the end of port range for the TCP and UDP protocols, or an ICMP code.
egress.ip-permission.user-id
- The ID of an Amazon Web Services account that has been referenced in an outbound security group rule.
group-id
- The ID of the security group.
group-name
- The name of the security group.
ip-permission.cidr
- An IPv4 CIDR block for an inbound security group rule.
ip-permission.from-port
- For an inbound rule, the start of port range for the TCP and UDP protocols, or an ICMP type number.
ip-permission.group-id
- The ID of a security group that has been referenced in an inbound security group rule.
ip-permission.group-name
- The name of a security group that is referenced in an inbound security group rule.
ip-permission.ipv6-cidr
- An IPv6 CIDR block for an inbound security group rule.
ip-permission.prefix-list-id
- The ID of a prefix list from which a security group rule allows inbound access.
ip-permission.protocol
- The IP protocol for an inbound security group rule (tcp
| udp
| icmp
, a protocol number, or -1 for all protocols).
ip-permission.to-port
- For an inbound rule, the end of port range for the TCP and UDP protocols, or an ICMP code.
ip-permission.user-id
- The ID of an Amazon Web Services account that has been referenced in an inbound security group rule.
owner-id
- The Amazon Web Services account ID of the owner of the security group.
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.
vpc-id
- The ID of the VPC specified when the security group was created.
The filters.
description
- A description of the snapshot.
encrypted
- Indicates whether the snapshot is encrypted (true
| false
)
owner-alias
- The owner alias, from an Amazon-maintained list (amazon
). This is not the user-configured account alias set using the IAM console. We recommend that you use the related parameter instead of this filter.
owner-id
- The account ID of the owner. We recommend that you use the related parameter instead of this filter.
progress
- The progress of the snapshot, as a percentage (for example, 80%).
snapshot-id
- The snapshot ID.
start-time
- The time stamp when the snapshot was initiated.
status
- The status of the snapshot (pending
| completed
| error
).
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.
volume-id
- The ID of the volume the snapshot is for.
volume-size
- The size of the volume, in GiB.
The filters.
description
- A description of the snapshot.
encrypted
- Indicates whether the snapshot is encrypted (true
| false
)
owner-alias
- The owner alias, from an Amazon-maintained list (amazon
). This is not the user-configured Amazon Web Services account alias set using the IAM console. We recommend that you use the related parameter instead of this filter.
owner-id
- The Amazon Web Services account ID of the owner. We recommend that you use the related parameter instead of this filter.
progress
- The progress of the snapshot, as a percentage (for example, 80%).
snapshot-id
- The snapshot ID.
start-time
- The time stamp when the snapshot was initiated.
status
- The status of the snapshot (pending
| completed
| error
).
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.
volume-id
- The ID of the volume the snapshot is for.
volume-size
- The size of the volume, in GiB.
One or more filters.
availability-zone-group
- The Availability Zone group.
create-time
- The time stamp when the Spot Instance request was created.
fault-code
- The fault code related to the request.
fault-message
- The fault message related to the request.
instance-id
- The ID of the instance that fulfilled the request.
launch-group
- The Spot Instance launch group.
launch.block-device-mapping.delete-on-termination
- Indicates whether the EBS volume is deleted on instance termination.
launch.block-device-mapping.device-name
- The device name for the volume in the block device mapping (for example, /dev/sdh
or xvdh
).
launch.block-device-mapping.snapshot-id
- The ID of the snapshot for the EBS volume.
launch.block-device-mapping.volume-size
- The size of the EBS volume, in GiB.
launch.block-device-mapping.volume-type
- The type of EBS volume: gp2
for General Purpose SSD, io1
or io2
for Provisioned IOPS SSD, st1
for Throughput Optimized HDD, sc1
for Cold HDD, or standard
for Magnetic.
launch.group-id
- The ID of the security group for the instance.
launch.group-name
- The name of the security group for the instance.
launch.image-id
- The ID of the AMI.
launch.instance-type
- The type of instance (for example, m3.medium
).
launch.kernel-id
- The kernel ID.
launch.key-name
- The name of the key pair the instance launched with.
launch.monitoring-enabled
- Whether detailed monitoring is enabled for the Spot Instance.
launch.ramdisk-id
- The RAM disk ID.
launched-availability-zone
- The Availability Zone in which the request is launched.
network-interface.addresses.primary
- Indicates whether the IP address is the primary private IP address.
network-interface.delete-on-termination
- Indicates whether the network interface is deleted when the instance is terminated.
network-interface.description
- A description of the network interface.
network-interface.device-index
- The index of the device for the network interface attachment on the instance.
network-interface.group-id
- The ID of the security group associated with the network interface.
network-interface.network-interface-id
- The ID of the network interface.
network-interface.private-ip-address
- The primary private IP address of the network interface.
network-interface.subnet-id
- The ID of the subnet for the instance.
product-description
- The product description associated with the instance (Linux/UNIX
| Windows
).
spot-instance-request-id
- The Spot Instance request ID.
spot-price
- The maximum hourly price for any Spot Instance launched to fulfill the request.
state
- The state of the Spot Instance request (open
| active
| closed
| cancelled
| failed
). Spot request status information can help you track your Amazon EC2 Spot Instance requests. For more information, see Spot request status in the Amazon EC2 User Guide for Linux Instances.
status-code
- The short code describing the most recent evaluation of your Spot Instance request.
status-message
- The message explaining the status of the Spot Instance request.
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.
type
- The type of Spot Instance request (one-time
| persistent
).
valid-from
- The start date of the request.
valid-until
- The end date of the request.
One or more filters.
availability-zone
- The Availability Zone for which prices should be returned.
instance-type
- The type of instance (for example, m3.medium
).
product-description
- The product description for the Spot price (Linux/UNIX
| Red Hat Enterprise Linux
| SUSE Linux
| Windows
| Linux/UNIX (Amazon VPC)
| Red Hat Enterprise Linux (Amazon VPC)
| SUSE Linux (Amazon VPC)
| Windows (Amazon VPC)
).
spot-price
- The Spot price. The value must match exactly (or use wildcards; greater than or less than comparison is not supported).
timestamp
- The time stamp of the Spot price history, in UTC format (for example, YYYY-MM-DDTHH:MM:SSZ). You can use wildcards (* and ?). Greater than or less than comparison is not supported.
The filters.
task-state
- Returns tasks in a certain state (InProgress
| Completed
| Failed
)
bucket
- Returns task information for tasks that targeted a specific bucket. For the filter value, specify the bucket name.
One or more filters.
availability-zone
- The Availability Zone for the subnet. You can also use availabilityZone
as the filter name.
availability-zone-id
- The ID of the Availability Zone for the subnet. You can also use availabilityZoneId
as the filter name.
available-ip-address-count
- The number of IPv4 addresses in the subnet that are available.
cidr-block
- The IPv4 CIDR block of the subnet. The CIDR block you specify must exactly match the subnet's CIDR block for information to be returned for the subnet. You can also use cidr
or cidrBlock
as the filter names.
default-for-az
- Indicates whether this is the default subnet for the Availability Zone. You can also use defaultForAz
as the filter name.
ipv6-cidr-block-association.ipv6-cidr-block
- An IPv6 CIDR block associated with the subnet.
ipv6-cidr-block-association.association-id
- An association ID for an IPv6 CIDR block associated with the subnet.
ipv6-cidr-block-association.state
- The state of an IPv6 CIDR block associated with the subnet.
outpost-arn
- The Amazon Resource Name (ARN) of the Outpost.
owner-id
- The ID of the account that owns the subnet.
state
- The state of the subnet (pending
| available
).
subnet-arn
- The Amazon Resource Name (ARN) of the subnet.
subnet-id
- The ID of the subnet.
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.
vpc-id
- The ID of the VPC for the subnet.
One or more filters.
availability-zone
- The Availability Zone for the subnet. You can also use availabilityZone
as the filter name.
availability-zone-id
- The ID of the Availability Zone for the subnet. You can also use availabilityZoneId
as the filter name.
available-ip-address-count
- The number of IPv4 addresses in the subnet that are available.
cidr-block
- The IPv4 CIDR block of the subnet. The CIDR block you specify must exactly match the subnet's CIDR block for information to be returned for the subnet. You can also use cidr
or cidrBlock
as the filter names.
default-for-az
- Indicates whether this is the default subnet for the Availability Zone. You can also use defaultForAz
as the filter name.
ipv6-cidr-block-association.ipv6-cidr-block
- An IPv6 CIDR block associated with the subnet.
ipv6-cidr-block-association.association-id
- An association ID for an IPv6 CIDR block associated with the subnet.
ipv6-cidr-block-association.state
- The state of an IPv6 CIDR block associated with the subnet.
outpost-arn
- The Amazon Resource Name (ARN) of the Outpost.
owner-id
- The ID of the Amazon Web Services account that owns the subnet.
state
- The state of the subnet (pending
| available
).
subnet-arn
- The Amazon Resource Name (ARN) of the subnet.
subnet-id
- The ID of the subnet.
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.
vpc-id
- The ID of the VPC for the subnet.
The filters.
key
- The tag key.
resource-id
- The ID of the resource.
resource-type
- The resource type (customer-gateway
| dedicated-host
| dhcp-options
| elastic-ip
| fleet
| fpga-image
| host-reservation
| image
| instance
| internet-gateway
| key-pair
| launch-template
| natgateway
| network-acl
| network-interface
| placement-group
| reserved-instances
| route-table
| security-group
| snapshot
| spot-instances-request
| subnet
| volume
| vpc
| vpc-endpoint
| vpc-endpoint-service
| vpc-peering-connection
| vpn-connection
| vpn-gateway
).
tag
:<key> - The key/value combination of the tag. For example, specify \"tag:Owner\" for the filter name and \"TeamA\" for the filter value to find resources with the tag \"Owner=TeamA\".
value
- The tag value.
One or more filters. The possible values are:
description
: The Traffic Mirror filter description.
traffic-mirror-filter-id
: The ID of the Traffic Mirror filter.
One or more filters. The possible values are:
description
: The Traffic Mirror session description.
network-interface-id
: The ID of the Traffic Mirror session network interface.
owner-id
: The ID of the account that owns the Traffic Mirror session.
packet-length
: The assigned number of packets to mirror.
session-number
: The assigned session number.
traffic-mirror-filter-id
: The ID of the Traffic Mirror filter.
traffic-mirror-session-id
: The ID of the Traffic Mirror session.
traffic-mirror-target-id
: The ID of the Traffic Mirror target.
virtual-network-id
: The virtual network ID of the Traffic Mirror session.
One or more filters.
principal
- The ARN of the principal.
principal-type
- The principal type (All
| Service
| OrganizationUnit
| Account
| User
| Role
).
One or more filters.
service-name
- The name of the service.
service-type
- The type of service (Interface
| 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.
service-name
- The name of the service.
vpc-id
- The ID of the VPC in which the endpoint resides.
vpc-endpoint-id
- The ID of the endpoint.
vpc-endpoint-state
- The state of the endpoint (pendingAcceptance
| pending
| available
| deleting
| deleted
| rejected
| failed
).
vpc-endpoint-type
- The type of VPC endpoint (Interface
| Gateway
| GatewayLoadBalancer
).
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.
accepter-vpc-info.cidr-block
- The IPv4 CIDR block of the accepter VPC.
accepter-vpc-info.owner-id
- The ID of the account that owns the accepter VPC.
accepter-vpc-info.vpc-id
- The ID of the accepter VPC.
expiration-time
- The expiration date and time for the VPC peering connection.
requester-vpc-info.cidr-block
- The IPv4 CIDR block of the requester's VPC.
requester-vpc-info.owner-id
- The ID of the account that owns the requester VPC.
requester-vpc-info.vpc-id
- The ID of the requester VPC.
status-code
- The status of the VPC peering connection (pending-acceptance
| failed
| expired
| provisioning
| active
| deleting
| deleted
| rejected
).
status-message
- A message that provides more information about the status of the VPC peering connection, if applicable.
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.
vpc-peering-connection-id
- The ID of the VPC peering connection.
One or more filters.
cidr
- The primary IPv4 CIDR block of the VPC. The CIDR block you specify must exactly match the VPC's CIDR block for information to be returned for the VPC. Must contain the slash followed by one or two digits (for example, /28
).
cidr-block-association.cidr-block
- An IPv4 CIDR block associated with the VPC.
cidr-block-association.association-id
- The association ID for an IPv4 CIDR block associated with the VPC.
cidr-block-association.state
- The state of an IPv4 CIDR block associated with the VPC.
dhcp-options-id
- The ID of a set of DHCP options.
ipv6-cidr-block-association.ipv6-cidr-block
- An IPv6 CIDR block associated with the VPC.
ipv6-cidr-block-association.ipv6-pool
- The ID of the IPv6 address pool from which the IPv6 CIDR block is allocated.
ipv6-cidr-block-association.association-id
- The association ID for an IPv6 CIDR block associated with the VPC.
ipv6-cidr-block-association.state
- The state of an IPv6 CIDR block associated with the VPC.
is-default
- Indicates whether the VPC is the default VPC.
owner-id
- The ID of the account that owns the VPC.
state
- The state of the VPC (pending
| available
).
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.
vpc-id
- The ID of the VPC.
One or more filters.
accepter-vpc-info.cidr-block
- The IPv4 CIDR block of the accepter VPC.
accepter-vpc-info.owner-id
- The ID of the Amazon Web Services account that owns the accepter VPC.
accepter-vpc-info.vpc-id
- The ID of the accepter VPC.
expiration-time
- The expiration date and time for the VPC peering connection.
requester-vpc-info.cidr-block
- The IPv4 CIDR block of the requester's VPC.
requester-vpc-info.owner-id
- The ID of the Amazon Web Services account that owns the requester VPC.
requester-vpc-info.vpc-id
- The ID of the requester VPC.
status-code
- The status of the VPC peering connection (pending-acceptance
| failed
| expired
| provisioning
| active
| deleting
| deleted
| rejected
).
status-message
- A message that provides more information about the status of the VPC peering connection, if applicable.
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.
vpc-peering-connection-id
- The ID of the VPC peering connection.
One or more filters.
cidr
- The primary IPv4 CIDR block of the VPC. The CIDR block you specify must exactly match the VPC's CIDR block for information to be returned for the VPC. Must contain the slash followed by one or two digits (for example, /28
).
cidr-block-association.cidr-block
- An IPv4 CIDR block associated with the VPC.
cidr-block-association.association-id
- The association ID for an IPv4 CIDR block associated with the VPC.
cidr-block-association.state
- The state of an IPv4 CIDR block associated with the VPC.
dhcp-options-id
- The ID of a set of DHCP options.
ipv6-cidr-block-association.ipv6-cidr-block
- An IPv6 CIDR block associated with the VPC.
ipv6-cidr-block-association.ipv6-pool
- The ID of the IPv6 address pool from which the IPv6 CIDR block is allocated.
ipv6-cidr-block-association.association-id
- The association ID for an IPv6 CIDR block associated with the VPC.
ipv6-cidr-block-association.state
- The state of an IPv6 CIDR block associated with the VPC.
is-default
- Indicates whether the VPC is the default VPC.
owner-id
- The ID of the Amazon Web Services account that owns the VPC.
state
- The state of the VPC (pending
| available
).
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.
vpc-id
- The ID of the VPC.
One or more filters.
customer-gateway-configuration
- The configuration information for the customer gateway.
customer-gateway-id
- The ID of a customer gateway associated with the VPN connection.
state
- The state of the VPN connection (pending
| available
| deleting
| deleted
).
option.static-routes-only
- Indicates whether the connection has static routes only. Used for devices that do not support Border Gateway Protocol (BGP).
route.destination-cidr-block
- The destination CIDR block. This corresponds to the subnet used in a customer data center.
bgp-asn
- The BGP Autonomous System Number (ASN) associated with a BGP device.
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.
type
- The type of VPN connection. Currently the only supported type is ipsec.1
.
vpn-connection-id
- The ID of the VPN connection.
vpn-gateway-id
- The ID of a virtual private gateway associated with the VPN connection.
transit-gateway-id
- The ID of a transit gateway associated with the VPN connection.
One or more filters.
amazon-side-asn
- The Autonomous System Number (ASN) for the Amazon side of the gateway.
attachment.state
- The current state of the attachment between the gateway and the VPC (attaching
| attached
| detaching
| detached
).
attachment.vpc-id
- The ID of an attached VPC.
availability-zone
- The Availability Zone for the virtual private gateway (if applicable).
state
- The state of the virtual private gateway (pending
| available
| deleting
| deleted
).
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.
type
- The type of virtual private gateway. Currently the only supported type is ipsec.1
.
vpn-gateway-id
- The ID of the virtual private gateway.
One or more filters. The possible values are:
attachment.transit-gateway-attachment-id
- The id of the transit gateway attachment.
attachment.resource-id
- The resource id of the transit gateway attachment.
route-search.exact-match
- The exact match of the specified filter.
route-search.longest-prefix-match
- The longest prefix that matches the route.
route-search.subnet-of-match
- The routes with a subnet that match the specified CIDR filter.
route-search.supernet-of-match
- The routes with a CIDR that encompass the CIDR filter. For example, if you have 10.0.1.0/29 and 10.0.1.0/31 routes in your route table and you specify supernet-of-match as 10.0.1.0/30, then the result returns 10.0.1.0/29.
state
- The state of the route (active
| blackhole
).
transit-gateway-route-destination-cidr-block
- The CIDR range.
type
- The type of route (propagated
| static
).
The number of IPv4 delegated prefixes to be automatically assigned to the network interface. You cannot use this option if you use the Ipv4Prefix
option.
The number of IPv6 delegated prefixes to be automatically assigned to the network interface. You cannot use this option if you use the Ipv6Prefix
option.
The state of the instance as a 16-bit unsigned integer.
The high byte is all of the bits between 2^8 and (2^16)-1, which equals decimal values between 256 and 65,535. These numerical values are used for internal purposes and should be ignored.
The low byte is all of the bits between 2^0 and (2^8)-1, which equals decimal values between 0 and 255.
The valid values for instance-state-code will all be in the range of the low byte and they are:
0
: pending
16
: running
32
: shutting-down
48
: terminated
64
: stopping
80
: stopped
You can ignore the high byte value by zeroing out all of the bits above 2^8 or 256 in decimal.
", - "InstanceUsage$UsedInstanceCount": "The number of instances the account currently has in the Capacity Reservation.
", + "InstanceUsage$UsedInstanceCount": "The number of instances the Amazon Web Services account currently has in the Capacity Reservation.
", "IpPermission$FromPort": "The start of port range for the TCP and UDP protocols, or an ICMP/ICMPv6 type number. A value of -1
indicates all ICMP/ICMPv6 types. If you specify all ICMP/ICMPv6 types, you must specify all codes.
The end of port range for the TCP and UDP protocols, or an ICMP/ICMPv6 code. A value of -1
indicates all ICMP/ICMPv6 codes. If you specify all ICMP/ICMPv6 types, you must specify all codes.
The number of CPU cores for the instance.
", @@ -11577,7 +11577,7 @@ "refs": { "DescribeFpgaImagesRequest$Owners": "Filters the AFI by owner. Specify an AWS account ID, self
(owner is the sender of the request), or an AWS owner alias (valid values are amazon
| aws-marketplace
).
Scopes the results to images with the specified owners. You can specify a combination of AWS account IDs, self
, amazon
, and aws-marketplace
. If you omit this parameter, the results include all images for which you have launch permissions, regardless of ownership.
Scopes the results to snapshots with the specified owners. You can specify a combination of account IDs, self
, and amazon
.
Scopes the results to snapshots with the specified owners. You can specify a combination of Amazon Web Services account IDs, self
, and amazon
.
The type of resource to tag. Currently, the resource types that support tagging on creation are instance
and volume
. To tag a resource after it has been created, see CreateTags.
The type of resource. Currently, the only resource type that is supported is instance
. To tag the Spot Fleet request on creation, use the TagSpecifications
parameter in SpotFleetRequestConfigData
.
The resource type.
", - "TagSpecification$ResourceType": "The type of resource to tag. Currently, the resource types that support tagging on creation are: capacity-reservation
| carrier-gateway
| client-vpn-endpoint
| customer-gateway
| dedicated-host
| dhcp-options
| egress-only-internet-gateway
| elastic-ip
| elastic-gpu
| export-image-task
| export-instance-task
| fleet
| fpga-image
| host-reservation
| image
| import-image-task
| import-snapshot-task
| instance
| instance-event-window
| internet-gateway
| ipv4pool-ec2
| ipv6pool-ec2
| key-pair
| launch-template
| local-gateway-route-table-vpc-association
| placement-group
| prefix-list
| natgateway
| network-acl
| network-interface
| reserved-instances
|route-table
| security-group
| snapshot
| spot-fleet-request
| spot-instances-request
| snapshot
| subnet
| traffic-mirror-filter
| traffic-mirror-session
| traffic-mirror-target
| transit-gateway
| transit-gateway-attachment
| transit-gateway-multicast-domain
| transit-gateway-route-table
| volume
|vpc
| vpc-peering-connection
| vpc-endpoint
(for interface and gateway endpoints) | vpc-endpoint-service
(for PrivateLink) | vpc-flow-log
| vpn-connection
| vpn-gateway
.
To tag a resource after it has been created, see CreateTags.
" + "TagSpecification$ResourceType": "The type of resource to tag. Currently, the resource types that support tagging on creation are: capacity-reservation
| carrier-gateway
| client-vpn-endpoint
| customer-gateway
| dedicated-host
| dhcp-options
| egress-only-internet-gateway
| elastic-ip
| elastic-gpu
| export-image-task
| export-instance-task
| fleet
| fpga-image
| host-reservation
| image
| import-image-task
| import-snapshot-task
| instance
| instance-event-window
| internet-gateway
| ipv4pool-ec2
| ipv6pool-ec2
| key-pair
| launch-template
| local-gateway-route-table-vpc-association
| placement-group
| prefix-list
| natgateway
| network-acl
| network-interface
| reserved-instances
|route-table
| security-group
| snapshot
| spot-fleet-request
| spot-instances-request
| snapshot
| subnet
| traffic-mirror-filter
| traffic-mirror-session
| traffic-mirror-target
| transit-gateway
| transit-gateway-attachment
| transit-gateway-multicast-domain
| transit-gateway-route-table
| volume
|vpc
| vpc-peering-connection
| vpc-endpoint
(for interface and gateway endpoints) | vpc-endpoint-service
(for Amazon Web Services PrivateLink) | vpc-flow-log
| vpn-connection
| vpn-gateway
.
To tag a resource after it has been created, see CreateTags.
" } }, "ResponseError": { @@ -13044,7 +13044,7 @@ "RestorableByStringList": { "base": null, "refs": { - "DescribeSnapshotsRequest$RestorableByUserIds": "The IDs of the accounts that can create volumes from the snapshot.
" + "DescribeSnapshotsRequest$RestorableByUserIds": "The IDs of the Amazon Web Services accounts that can create volumes from the snapshot.
" } }, "RestoreAddressToClassicRequest": { @@ -13709,7 +13709,7 @@ "refs": { "DescribeSnapshotsRequest$SnapshotIds": "The snapshot IDs.
Default: Describes the snapshots for which you have create volume permissions.
", "DisableFastSnapshotRestoresRequest$SourceSnapshotIds": "The IDs of one or more snapshots. For example, snap-1234567890abcdef0
.
The IDs of one or more snapshots. For example, snap-1234567890abcdef0
. You can specify a snapshot that was shared with you from another account.
The IDs of one or more snapshots. For example, snap-1234567890abcdef0
. You can specify a snapshot that was shared with you from another Amazon Web Services account.
The ID representing the allocation of the address for use with EC2-VPC.
", "Address$AssociationId": "The ID representing the association of the address with an instance in a VPC.
", "Address$NetworkInterfaceId": "The ID of the network interface.
", - "Address$NetworkInterfaceOwnerId": "The ID of the account that owns the network interface.
", + "Address$NetworkInterfaceOwnerId": "The ID of the Amazon Web Services account that owns the network interface.
", "Address$PrivateIpAddress": "The private IP address associated with the Elastic IP address.
", "Address$PublicIpv4Pool": "The ID of an address pool.
", "Address$NetworkBorderGroup": "The name of the unique set of Availability Zones, Local Zones, or Wavelength Zones from which AWS advertises IP addresses.
", @@ -14200,17 +14200,17 @@ "CancelSpotFleetRequestsSuccessItem$SpotFleetRequestId": "The ID of the Spot Fleet request.
", "CancelledSpotInstanceRequest$SpotInstanceRequestId": "The ID of the Spot Instance request.
", "CapacityReservation$CapacityReservationId": "The ID of the Capacity Reservation.
", - "CapacityReservation$OwnerId": "The ID of the account that owns the Capacity Reservation.
", + "CapacityReservation$OwnerId": "The ID of the Amazon Web Services account that owns the Capacity Reservation.
", "CapacityReservation$CapacityReservationArn": "The Amazon Resource Name (ARN) of the Capacity Reservation.
", "CapacityReservation$AvailabilityZoneId": "The Availability Zone ID of the Capacity Reservation.
", "CapacityReservation$InstanceType": "The type of instance for which the Capacity Reservation reserves capacity.
", "CapacityReservation$AvailabilityZone": "The Availability Zone in which the capacity is reserved.
", "CapacityReservationGroup$GroupArn": "The ARN of the resource group.
", - "CapacityReservationGroup$OwnerId": "The ID of the account that owns the resource group.
", + "CapacityReservationGroup$OwnerId": "The ID of the Amazon Web Services account that owns the resource group.
", "CapacityReservationTarget$CapacityReservationResourceGroupArn": "The ARN of the Capacity Reservation resource group in which to run the instance.
", "CapacityReservationTargetResponse$CapacityReservationId": "The ID of the targeted Capacity Reservation.
", "CapacityReservationTargetResponse$CapacityReservationResourceGroupArn": "The ARN of the targeted Capacity Reservation group.
", - "CarrierGateway$OwnerId": "The account ID of the owner of the carrier gateway.
", + "CarrierGateway$OwnerId": "The Amazon Web Services account ID of the owner of the carrier gateway.
", "CertificateAuthentication$ClientRootCertificateChain": "The ARN of the client certificate.
", "CertificateAuthenticationRequest$ClientRootCertificateChainArn": "The ARN of the client certificate. The certificate must be signed by a certificate authority (CA) and it must be provisioned in AWS Certificate Manager (ACM).
", "CidrAuthorizationContext$Message": "The plain-text authorization message for the prefix and account.
", @@ -14260,7 +14260,7 @@ "CoipAddressUsage$AwsService": "The AWS service.
", "CoipAddressUsage$CoIp": "The customer-owned IP address.
", "ConfirmProductInstanceRequest$ProductCode": "The product code. This must be a product code that you own.
", - "ConfirmProductInstanceResult$OwnerId": "The account ID of the instance owner. This is only present if the product code is attached to the instance.
", + "ConfirmProductInstanceResult$OwnerId": "The Amazon Web Services account ID of the instance owner. This is only present if the product code is attached to the instance.
", "ConnectionLogOptions$CloudwatchLogGroup": "The name of the CloudWatch Logs log group. Required if connection logging is enabled.
", "ConnectionLogOptions$CloudwatchLogStream": "The name of the CloudWatch Logs log stream to which the connection data is published.
", "ConnectionLogResponseOptions$CloudwatchLogGroup": "The name of the Amazon CloudWatch Logs log group to which connection logging data is published.
", @@ -14348,7 +14348,7 @@ "CreateNetworkInsightsPathRequest$Source": "The Amazon Web Services resource that is the source of the path.
", "CreateNetworkInsightsPathRequest$Destination": "The Amazon Web Services resource that is the destination of the path.
", "CreateNetworkInsightsPathRequest$ClientToken": "Unique, case-sensitive identifier that you provide to ensure the idempotency of the request. For more information, see How to ensure idempotency.
", - "CreateNetworkInterfacePermissionRequest$AwsAccountId": "The account ID.
", + "CreateNetworkInterfacePermissionRequest$AwsAccountId": "The Amazon Web Services account ID.
", "CreateNetworkInterfacePermissionRequest$AwsService": "The Amazon Web Service. Currently not supported.
", "CreateNetworkInterfaceRequest$Description": "A description for the network interface.
", "CreateNetworkInterfaceRequest$PrivateIpAddress": "The primary private IPv4 address of the network interface. If you don't specify an IPv4 address, Amazon EC2 selects one for you from the subnet's IPv4 CIDR range. If you specify an IP address, you cannot indicate any IP addresses specified in privateIpAddresses
as primary (only one IP address can be designated as primary).
The Region where the peer transit gateway is located.
", "CreateTransitGatewayRequest$Description": "A description of the transit gateway.
", "CreateTransitGatewayRouteRequest$DestinationCidrBlock": "The CIDR range used for destination matches. Routing decisions are based on the most specific match.
", - "CreateVolumePermission$UserId": "The ID of the account to be added or removed.
", + "CreateVolumePermission$UserId": "The ID of the Amazon Web Services account to be added or removed.
", "CreateVolumeRequest$AvailabilityZone": "The Availability Zone in which to create the volume.
", "CreateVolumeRequest$OutpostArn": "The Amazon Resource Name (ARN) of the Outpost.
", "CreateVolumeRequest$ClientToken": "Unique, case-sensitive identifier that you provide to ensure the idempotency of the request. For more information, see Ensure Idempotency.
", @@ -14416,7 +14416,7 @@ "CreateVpcEndpointServiceConfigurationRequest$PrivateDnsName": "(Interface endpoint configuration) The private DNS name to assign to the VPC endpoint service.
", "CreateVpcEndpointServiceConfigurationRequest$ClientToken": "Unique, case-sensitive identifier that you provide to ensure the idempotency of the request. For more information, see How to Ensure Idempotency.
", "CreateVpcEndpointServiceConfigurationResult$ClientToken": "Unique, case-sensitive identifier that you provide to ensure the idempotency of the request.
", - "CreateVpcPeeringConnectionRequest$PeerOwnerId": "The account ID of the owner of the accepter VPC.
Default: Your account ID
", + "CreateVpcPeeringConnectionRequest$PeerOwnerId": "The Amazon Web Services account ID of the owner of the accepter VPC.
Default: Your Amazon Web Services account ID
", "CreateVpcPeeringConnectionRequest$PeerVpcId": "The ID of the VPC with which you are creating the VPC peering connection. You must specify this parameter in the request.
", "CreateVpcPeeringConnectionRequest$PeerRegion": "The Region code for the accepter VPC, if the accepter VPC is located in a Region other than the Region in which you make the request.
Default: The Region in which you make the request.
", "CreateVpcRequest$CidrBlock": "The IPv4 network range for the VPC, in CIDR notation. For example, 10.0.0.0/16
. We modify the specified CIDR block to its canonical form; for example, if you specify 100.68.0.18/18
, we modify it to 100.68.0.0/18
.
The ID of the snapshot.
", "DescribeFastSnapshotRestoreSuccessItem$AvailabilityZone": "The Availability Zone.
", "DescribeFastSnapshotRestoreSuccessItem$StateTransitionReason": "The reason for the state transition. The possible values are as follows:
Client.UserInitiated
- The state successfully transitioned to enabling
or disabling
.
Client.UserInitiated - Lifecycle state transition
- The state successfully transitioned to optimizing
, enabled
, or disabled
.
The ID of the account that enabled fast snapshot restores on the snapshot.
", + "DescribeFastSnapshotRestoreSuccessItem$OwnerId": "The ID of the Amazon Web Services account that enabled fast snapshot restores on the snapshot.
", "DescribeFastSnapshotRestoreSuccessItem$OwnerAlias": "The Amazon Web Services owner alias that enabled fast snapshot restores on the snapshot. This is intended for future use.
", "DescribeFleetError$ErrorCode": "The error code that indicates why the instance could not be launched. For more information about error codes, see Error Codes.
", "DescribeFleetError$ErrorMessage": "The error message that describes why the instance could not be launched. For more information about error messages, see Error Codes.
", @@ -14630,7 +14630,7 @@ "DetachVolumeRequest$Device": "The device name.
", "DhcpConfiguration$Key": "The name of a DHCP option.
", "DhcpOptions$DhcpOptionsId": "The ID of the set of DHCP options.
", - "DhcpOptions$OwnerId": "The ID of the account that owns the DHCP options set.
", + "DhcpOptions$OwnerId": "The ID of the Amazon Web Services account that owns the DHCP options set.
", "DirectoryServiceAuthentication$DirectoryId": "The ID of the Active Directory used for authentication.
", "DirectoryServiceAuthenticationRequest$DirectoryId": "The ID of the Active Directory to be used for authentication.
", "DisableFastSnapshotRestoreErrorItem$SnapshotId": "The ID of the snapshot.
", @@ -14640,7 +14640,7 @@ "DisableFastSnapshotRestoreSuccessItem$SnapshotId": "The ID of the snapshot.
", "DisableFastSnapshotRestoreSuccessItem$AvailabilityZone": "The Availability Zone.
", "DisableFastSnapshotRestoreSuccessItem$StateTransitionReason": "The reason for the state transition. The possible values are as follows:
Client.UserInitiated
- The state successfully transitioned to enabling
or disabling
.
Client.UserInitiated - Lifecycle state transition
- The state successfully transitioned to optimizing
, enabled
, or disabled
.
The ID of the account that enabled fast snapshot restores on the snapshot.
", + "DisableFastSnapshotRestoreSuccessItem$OwnerId": "The ID of the Amazon Web Services account that enabled fast snapshot restores on the snapshot.
", "DisableFastSnapshotRestoreSuccessItem$OwnerAlias": "The Amazon Web Services owner alias that enabled fast snapshot restores on the snapshot. This is intended for future use.
", "DisassociateAddressRequest$PublicIp": "[EC2-Classic] The Elastic IP address. Required for EC2-Classic.
", "DisassociateClientVpnTargetNetworkResult$AssociationId": "The ID of the target network association.
", @@ -14680,7 +14680,7 @@ "EnableFastSnapshotRestoreSuccessItem$SnapshotId": "The ID of the snapshot.
", "EnableFastSnapshotRestoreSuccessItem$AvailabilityZone": "The Availability Zone.
", "EnableFastSnapshotRestoreSuccessItem$StateTransitionReason": "The reason for the state transition. The possible values are as follows:
Client.UserInitiated
- The state successfully transitioned to enabling
or disabling
.
Client.UserInitiated - Lifecycle state transition
- The state successfully transitioned to optimizing
, enabled
, or disabled
.
The ID of the account that enabled fast snapshot restores on the snapshot.
", + "EnableFastSnapshotRestoreSuccessItem$OwnerId": "The ID of the Amazon Web Services account that enabled fast snapshot restores on the snapshot.
", "EnableFastSnapshotRestoreSuccessItem$OwnerAlias": "The Amazon Web Services owner alias that enabled fast snapshot restores on the snapshot. This is intended for future use.
", "EventInformation$EventDescription": "The description of the event.
", "EventInformation$EventSubType": "The event.
The following are the error
events:
iamFleetRoleInvalid
- The EC2 Fleet or Spot Fleet did not have the required permissions either to launch or terminate an instance.
spotFleetRequestConfigurationInvalid
- The configuration is not valid. For more information, see the description of the event.
spotInstanceCountLimitExceeded
- You've reached the limit on the number of Spot Instances that you can launch.
The following are the fleetRequestChange
events:
active
- The EC2 Fleet or Spot Fleet request has been validated and Amazon EC2 is attempting to maintain the target number of running Spot Instances.
cancelled
- The EC2 Fleet or Spot Fleet request is canceled and has no running Spot Instances. The EC2 Fleet or Spot Fleet will be deleted two days after its instances were terminated.
cancelled_running
- The EC2 Fleet or Spot Fleet request is canceled and does not launch additional Spot Instances. Existing Spot Instances continue to run until they are interrupted or terminated.
cancelled_terminating
- The EC2 Fleet or Spot Fleet request is canceled and its Spot Instances are terminating.
expired
- The EC2 Fleet or Spot Fleet request has expired. A subsequent event indicates that the instances were terminated, if the request was created with TerminateInstancesWithExpiration
set.
modify_in_progress
- A request to modify the EC2 Fleet or Spot Fleet request was accepted and is in progress.
modify_successful
- The EC2 Fleet or Spot Fleet request was modified.
price_update
- The price for a launch configuration was adjusted because it was too high. This change is permanent.
submitted
- The EC2 Fleet or Spot Fleet request is being evaluated and Amazon EC2 is preparing to launch the target number of Spot Instances.
The following are the instanceChange
events:
launched
- A request was fulfilled and a new instance was launched.
terminated
- An instance was terminated by the user.
The following are the Information
events:
launchSpecTemporarilyBlacklisted
- The configuration is not valid and several attempts to launch instances have failed. For more information, see the description of the event.
launchSpecUnusable
- The price in a launch specification is not valid because it is below the Spot price or the Spot price is above the On-Demand price.
fleetProgressHalted
- The price in every launch specification is not valid. A launch specification might become valid if the Spot price changes.
Unique, case-sensitive identifier that you provide to ensure the idempotency of the request. For more information, see Ensuring Idempotency.
", "Host$HostId": "The ID of the Dedicated Host.
", "Host$HostReservationId": "The reservation ID of the Dedicated Host. This returns a null
response if the Dedicated Host doesn't have an associated reservation.
The ID of the account that owns the Dedicated Host.
", + "Host$OwnerId": "The ID of the Amazon Web Services account that owns the Dedicated Host.
", "Host$AvailabilityZoneId": "The ID of the Availability Zone in which the Dedicated Host is allocated.
", "HostInstance$InstanceId": "The ID of instance that is running on the Dedicated Host.
", "HostInstance$InstanceType": "The instance type (for example, m3.medium
) of the running instance.
The ID of the account that owns the instance.
", + "HostInstance$OwnerId": "The ID of the Amazon Web Services account that owns the instance.
", "HostOffering$HourlyPrice": "The hourly price of the offering.
", "HostOffering$InstanceFamily": "The instance family of the offering.
", "HostOffering$OfferingId": "The ID of the offering.
", @@ -14939,7 +14939,7 @@ "InstanceNetworkInterface$Description": "The description.
", "InstanceNetworkInterface$MacAddress": "The MAC address.
", "InstanceNetworkInterface$NetworkInterfaceId": "The ID of the network interface.
", - "InstanceNetworkInterface$OwnerId": "The ID of the account that created the network interface.
", + "InstanceNetworkInterface$OwnerId": "The ID of the Amazon Web Services account that created the network interface.
", "InstanceNetworkInterface$PrivateDnsName": "The private DNS name.
", "InstanceNetworkInterface$PrivateIpAddress": "The IPv4 address of the network interface within the subnet.
", "InstanceNetworkInterface$SubnetId": "The ID of the subnet.
", @@ -14963,9 +14963,9 @@ "InstanceStatus$InstanceId": "The ID of the instance.
", "InstanceStatusEvent$Description": "A description of the event.
After a scheduled event is completed, it can still be described for up to a week. If the event has been completed, this description starts with the following text: [Completed].
", "InstanceTagKeySet$member": null, - "InstanceUsage$AccountId": "The ID of the account that is making use of the Capacity Reservation.
", + "InstanceUsage$AccountId": "The ID of the Amazon Web Services account that is making use of the Capacity Reservation.
", "InternetGateway$InternetGatewayId": "The ID of the internet gateway.
", - "InternetGateway$OwnerId": "The ID of the account that owns the internet gateway.
", + "InternetGateway$OwnerId": "The ID of the Amazon Web Services account that owns the internet gateway.
", "InternetGatewayAttachment$VpcId": "The ID of the VPC.
", "IpPermission$IpProtocol": "The IP protocol name (tcp
, udp
, icmp
, icmpv6
) or number (see Protocol Numbers).
[VPC only] Use -1
to specify all protocols. When authorizing security group rules, specifying -1
or a protocol number other than tcp
, udp
, icmp
, or icmpv6
allows traffic on all ports, regardless of any port range you specify. For tcp
, udp
, and icmp
, you must specify a port range. For icmpv6
, the port range is optional; if you omit the port range, traffic for all types and codes is allowed.
[Public NAT gateway only] The Elastic IP address associated with the NAT gateway.
", "NetworkAcl$NetworkAclId": "The ID of the network ACL.
", "NetworkAcl$VpcId": "The ID of the VPC for the network ACL.
", - "NetworkAcl$OwnerId": "The ID of the account that owns the network ACL.
", + "NetworkAcl$OwnerId": "The ID of the Amazon Web Services account that owns the network ACL.
", "NetworkAclAssociation$NetworkAclAssociationId": "The ID of the association between a network ACL and a subnet.
", "NetworkAclAssociation$NetworkAclId": "The ID of the network ACL.
", "NetworkAclAssociation$SubnetId": "The ID of the subnet.
", @@ -15150,10 +15150,10 @@ "NetworkInterface$MacAddress": "The MAC address.
", "NetworkInterface$NetworkInterfaceId": "The ID of the network interface.
", "NetworkInterface$OutpostArn": "The Amazon Resource Name (ARN) of the Outpost.
", - "NetworkInterface$OwnerId": "The account ID of the owner of the network interface.
", + "NetworkInterface$OwnerId": "The Amazon Web Services account ID of the owner of the network interface.
", "NetworkInterface$PrivateDnsName": "The private DNS name.
", "NetworkInterface$PrivateIpAddress": "The IPv4 address of the network interface within the subnet.
", - "NetworkInterface$RequesterId": "The alias or account ID of the principal or service that created the network interface.
", + "NetworkInterface$RequesterId": "The alias or Amazon Web Services account ID of the principal or service that created the network interface.
", "NetworkInterface$SubnetId": "The ID of the subnet.
", "NetworkInterface$VpcId": "The ID of the VPC.
", "NetworkInterfaceAssociation$AllocationId": "The allocation ID.
", @@ -15165,11 +15165,11 @@ "NetworkInterfaceAssociation$CarrierIp": "The carrier IP address associated with the network interface.
This option is only available when the network interface is in a subnet which is associated with a Wavelength Zone.
", "NetworkInterfaceAttachment$AttachmentId": "The ID of the network interface attachment.
", "NetworkInterfaceAttachment$InstanceId": "The ID of the instance.
", - "NetworkInterfaceAttachment$InstanceOwnerId": "The account ID of the owner of the instance.
", + "NetworkInterfaceAttachment$InstanceOwnerId": "The Amazon Web Services account ID of the owner of the instance.
", "NetworkInterfaceIpv6Address$Ipv6Address": "The IPv6 address.
", "NetworkInterfacePermission$NetworkInterfacePermissionId": "The ID of the network interface permission.
", "NetworkInterfacePermission$NetworkInterfaceId": "The ID of the network interface.
", - "NetworkInterfacePermission$AwsAccountId": "The account ID.
", + "NetworkInterfacePermission$AwsAccountId": "The Amazon Web Services account ID.
", "NetworkInterfacePermission$AwsService": "The Amazon Web Service.
", "NetworkInterfacePermissionState$StatusMessage": "A status message, if applicable.
", "NetworkInterfacePrivateIpAddress$PrivateDnsName": "The private DNS name.
", @@ -15253,7 +15253,7 @@ "PurchaseScheduledInstancesRequest$ClientToken": "Unique, case-sensitive identifier that ensures the idempotency of the request. For more information, see Ensuring Idempotency.
", "ReferencedSecurityGroup$GroupId": "The ID of the security group.
", "ReferencedSecurityGroup$PeeringStatus": "The status of a VPC peering connection, if applicable.
", - "ReferencedSecurityGroup$UserId": "The account ID.
", + "ReferencedSecurityGroup$UserId": "The Amazon Web Services account ID.
", "ReferencedSecurityGroup$VpcId": "The ID of the VPC.
", "ReferencedSecurityGroup$VpcPeeringConnectionId": "The ID of the VPC peering connection.
", "Region$Endpoint": "The Region service endpoint.
", @@ -15293,8 +15293,8 @@ "RequestSpotLaunchSpecification$AddressingType": "Deprecated.
", "RequestSpotLaunchSpecification$UserData": "The Base64-encoded user data for the instance. User data is limited to 16 KB.
", "RequestSpotLaunchSpecificationSecurityGroupList$member": null, - "Reservation$OwnerId": "The ID of the account that owns the reservation.
", - "Reservation$RequesterId": "The ID of the requester that launched the instances on your behalf (for example, Management Console or Auto Scaling).
", + "Reservation$OwnerId": "The ID of the Amazon Web Services account that owns the reservation.
", + "Reservation$RequesterId": "The ID of the requester that launched the instances on your behalf (for example, Amazon Web Services Management Console or Auto Scaling).
", "Reservation$ReservationId": "The ID of the reservation.
", "ReservationValue$HourlyPrice": "The hourly rate of the reservation.
", "ReservationValue$RemainingTotalValue": "The balance of the total value (the sum of remainingUpfrontValue + hourlyPrice * number of hours remaining).
", @@ -15346,7 +15346,7 @@ "Route$EgressOnlyInternetGatewayId": "The ID of the egress-only internet gateway.
", "Route$GatewayId": "The ID of a gateway attached to your VPC.
", "Route$InstanceId": "The ID of a NAT instance in your VPC.
", - "Route$InstanceOwnerId": "The ID of account that owns the instance.
", + "Route$InstanceOwnerId": "The ID of Amazon Web Services account that owns the instance.
", "Route$NatGatewayId": "The ID of a NAT gateway.
", "Route$TransitGatewayId": "The ID of a transit gateway.
", "Route$LocalGatewayId": "The ID of the local gateway.
", @@ -15354,7 +15354,7 @@ "Route$VpcPeeringConnectionId": "The ID of a VPC peering connection.
", "RouteTable$RouteTableId": "The ID of the route table.
", "RouteTable$VpcId": "The ID of the VPC.
", - "RouteTable$OwnerId": "The ID of the account that owns the route table.
", + "RouteTable$OwnerId": "The ID of the Amazon Web Services account that owns the route table.
", "RouteTableAssociation$RouteTableAssociationId": "The ID of the association.
", "RouteTableAssociation$RouteTableId": "The ID of the route table.
", "RouteTableAssociation$SubnetId": "The ID of the subnet. A subnet ID is not returned for an implicit association.
", @@ -15413,7 +15413,7 @@ "SecurityGroupReference$GroupId": "The ID of your security group.
", "SecurityGroupReference$ReferencingVpcId": "The ID of the VPC with the referencing security group.
", "SecurityGroupReference$VpcPeeringConnectionId": "The ID of the VPC peering connection.
", - "SecurityGroupRule$GroupOwnerId": "The ID of the account that owns the security group.
", + "SecurityGroupRule$GroupOwnerId": "The ID of the Amazon Web Services account that owns the security group.
", "SecurityGroupRule$IpProtocol": "The IP protocol name (tcp
, udp
, icmp
, icmpv6
) or number (see Protocol Numbers).
Use -1
to specify all protocols.
The IPv4 CIDR range.
", "SecurityGroupRule$CidrIpv6": "The IPv6 CIDR range.
", @@ -15435,12 +15435,12 @@ "Snapshot$DataEncryptionKeyId": "The data encryption key identifier for the snapshot. This value is a unique identifier that corresponds to the data encryption key that was used to encrypt the original volume or snapshot copy. Because data encryption keys are inherited by volumes created from snapshots, and vice versa, if snapshots share the same data encryption key identifier, then they belong to the same volume/snapshot lineage. This parameter is only returned by DescribeSnapshots.
", "Snapshot$Description": "The description for the snapshot.
", "Snapshot$KmsKeyId": "The Amazon Resource Name (ARN) of the Key Management Service (KMS) KMS key that was used to protect the volume encryption key for the parent volume.
", - "Snapshot$OwnerId": "The ID of the account that owns the EBS snapshot.
", + "Snapshot$OwnerId": "The ID of the Amazon Web Services account that owns the EBS snapshot.
", "Snapshot$Progress": "The progress of the snapshot, as a percentage.
", "Snapshot$SnapshotId": "The ID of the snapshot. Each snapshot receives a unique identifier when it is created.
", "Snapshot$StateMessage": "Encrypted Amazon EBS snapshots are copied asynchronously. If a snapshot copy operation fails (for example, if the proper Key Management Service (KMS) permissions are not obtained) this field displays error state details to help you diagnose why the error occurred. This parameter is only returned by DescribeSnapshots.
", "Snapshot$VolumeId": "The ID of the volume that was used to create the snapshot. Snapshots created by the CopySnapshot action have an arbitrary volume ID that should not be used for any purpose.
", - "Snapshot$OwnerAlias": "The Amazon Web Services owner alias, from an Amazon-maintained list (amazon
). This is not the user-configured account alias set using the IAM console.
The Amazon Web Services owner alias, from an Amazon-maintained list (amazon
). This is not the user-configured Amazon Web Services account alias set using the IAM console.
The ARN of the Outpost on which the snapshot is stored. For more information, see Amazon EBS local snapshots on Outposts in the Amazon Elastic Compute Cloud User Guide.
", "SnapshotDetail$Description": "A description for the snapshot.
", "SnapshotDetail$DeviceName": "The block device mapping for the snapshot.
", @@ -15468,7 +15468,7 @@ "SnapshotTaskDetail$StatusMessage": "A detailed status message for the import snapshot task.
", "SnapshotTaskDetail$Url": "The URL of the disk image from which the snapshot is created.
", "SpotDatafeedSubscription$Bucket": "The name of the Amazon S3 bucket where the Spot Instance data feed is located.
", - "SpotDatafeedSubscription$OwnerId": "The account ID of the account.
", + "SpotDatafeedSubscription$OwnerId": "The Amazon Web Services account ID of the account.
", "SpotDatafeedSubscription$Prefix": "The prefix for the data feed files.
", "SpotFleetLaunchSpecification$AddressingType": "Deprecated.
", "SpotFleetLaunchSpecification$ImageId": "The ID of the AMI.
", @@ -15524,7 +15524,7 @@ "Subnet$CidrBlock": "The IPv4 CIDR block assigned to the subnet.
", "Subnet$SubnetId": "The ID of the subnet.
", "Subnet$VpcId": "The ID of the VPC the subnet is in.
", - "Subnet$OwnerId": "The ID of the account that owns the subnet.
", + "Subnet$OwnerId": "The ID of the Amazon Web Services account that owns the subnet.
", "Subnet$SubnetArn": "The Amazon Resource Name (ARN) of the subnet.
", "Subnet$OutpostArn": "The Amazon Resource Name (ARN) of the Outpost.
", "SubnetAssociation$SubnetId": "The ID of the subnet.
", @@ -15692,7 +15692,7 @@ "Vpc$CidrBlock": "The primary IPv4 CIDR block for the VPC.
", "Vpc$DhcpOptionsId": "The ID of the set of DHCP options you've associated with the VPC.
", "Vpc$VpcId": "The ID of the VPC.
", - "Vpc$OwnerId": "The ID of the account that owns the VPC.
", + "Vpc$OwnerId": "The ID of the Amazon Web Services account that owns the VPC.
", "VpcAttachment$VpcId": "The ID of the VPC.
", "VpcCidrBlockAssociation$AssociationId": "The association ID for the IPv4 CIDR block.
", "VpcCidrBlockAssociation$CidrBlock": "The IPv4 CIDR block.
", @@ -15713,7 +15713,7 @@ "VpcPeeringConnection$VpcPeeringConnectionId": "The ID of the VPC peering connection.
", "VpcPeeringConnectionStateReason$Message": "A message that provides more information about the status, if applicable.
", "VpcPeeringConnectionVpcInfo$CidrBlock": "The IPv4 CIDR block for the VPC.
", - "VpcPeeringConnectionVpcInfo$OwnerId": "The ID of the account that owns the VPC.
", + "VpcPeeringConnectionVpcInfo$OwnerId": "The ID of the Amazon Web Services account that owns the VPC.
", "VpcPeeringConnectionVpcInfo$VpcId": "The ID of the VPC.
", "VpcPeeringConnectionVpcInfo$Region": "The Region in which the VPC is located.
", "VpnConnection$CustomerGatewayConfiguration": "The configuration information for the VPN connection's customer gateway (in the native XML format). This element is always present in the CreateVpnConnection response; however, it's present in the DescribeVpnConnections response only if the VPN connection is in the pending
or available
state.
Adds a thing to a billing group.
", "AddThingToThingGroup": "Adds a thing to a thing group.
", "AssociateTargetsWithJob": "Associates a group with a continuous job. The following criteria must be met:
The job must have been created with the targetSelection
field set to \"CONTINUOUS\".
The job status must currently be \"IN_PROGRESS\".
The total number of targets associated with a job must not exceed 100.
Attaches a policy to the specified target.
", + "AttachPolicy": "Attaches the specified policy to the specified principal (certificate or other credential).
", "AttachPrincipalPolicy": "Attaches the specified policy to the specified principal (certificate or other credential).
Note: This API is deprecated. Please use AttachPolicy instead.
", "AttachSecurityProfile": "Associates a Device Defender security profile with a thing group or this account. Each thing group or account can have up to five security profiles associated with it.
", "AttachThingPrincipal": "Attaches the specified principal to the specified thing. A principal can be X.509 certificates, IAM users, groups, and roles, Amazon Cognito identities or federated identities.
", diff --git a/models/apis/iotsitewise/2019-12-02/api-2.json b/models/apis/iotsitewise/2019-12-02/api-2.json index 38c53288632..2ba4f8c6d16 100644 --- a/models/apis/iotsitewise/2019-12-02/api-2.json +++ b/models/apis/iotsitewise/2019-12-02/api-2.json @@ -1638,7 +1638,8 @@ "enum":[ "IN_SYNC", "OUT_OF_SYNC", - "SYNC_FAILED" + "SYNC_FAILED", + "UNKNOWN" ] }, "ClientToken":{ @@ -1660,6 +1661,13 @@ "assetProperty":{"shape":"Property"} } }, + "ComputeLocation":{ + "type":"string", + "enum":[ + "EDGE", + "CLOUD" + ] + }, "ConfigurationErrorDetails":{ "type":"structure", "required":[ @@ -1702,6 +1710,11 @@ "error":{"httpStatusCode":409}, "exception":true }, + "CoreDeviceThingName":{ + "type":"string", + "max":128, + "min":1 + }, "CreateAccessPolicyRequest":{ "type":"structure", "required":[ @@ -2464,6 +2477,29 @@ "min":1, "pattern":"[^\\u0000-\\u001F\\u007F]+" }, + "DetailedError":{ + "type":"structure", + "required":[ + "code", + "message" + ], + "members":{ + "code":{"shape":"DetailedErrorCode"}, + "message":{"shape":"DetailedErrorMessage"} + } + }, + "DetailedErrorCode":{ + "type":"string", + "enum":[ + "INCOMPATIBLE_COMPUTE_LOCATION", + "INCOMPATIBLE_FORWARDING_CONFIGURATION" + ] + }, + "DetailedErrorMessage":{"type":"string"}, + "DetailedErrors":{ + "type":"list", + "member":{"shape":"DetailedError"} + }, "DisassociateAssetsRequest":{ "type":"structure", "required":[ @@ -2519,7 +2555,8 @@ ], "members":{ "code":{"shape":"ErrorCode"}, - "message":{"shape":"ErrorMessage"} + "message":{"shape":"ErrorMessage"}, + "details":{"shape":"DetailedErrors"} } }, "ErrorMessage":{"type":"string"}, @@ -2544,6 +2581,20 @@ "type":"list", "member":{"shape":"ExpressionVariable"} }, + "ForwardingConfig":{ + "type":"structure", + "required":["state"], + "members":{ + "state":{"shape":"ForwardingConfigState"} + } + }, + "ForwardingConfigState":{ + "type":"string", + "enum":[ + "DISABLED", + "ENABLED" + ] + }, "GatewayCapabilitySummaries":{ "type":"list", "member":{"shape":"GatewayCapabilitySummary"} @@ -2561,9 +2612,9 @@ }, "GatewayPlatform":{ "type":"structure", - "required":["greengrass"], "members":{ - "greengrass":{"shape":"Greengrass"} + "greengrass":{"shape":"Greengrass"}, + "greengrassV2":{"shape":"GreengrassV2"} } }, "GatewaySummaries":{ @@ -2581,6 +2632,7 @@ "members":{ "gatewayId":{"shape":"ID"}, "gatewayName":{"shape":"Name"}, + "gatewayPlatform":{"shape":"GatewayPlatform"}, "gatewayCapabilitySummaries":{"shape":"GatewayCapabilitySummaries"}, "creationDate":{"shape":"Timestamp"}, "lastUpdateDate":{"shape":"Timestamp"} @@ -2831,6 +2883,13 @@ "groupArn":{"shape":"ARN"} } }, + "GreengrassV2":{ + "type":"structure", + "required":["coreDeviceThingName"], + "members":{ + "coreDeviceThingName":{"shape":"CoreDeviceThingName"} + } + }, "GroupIdentity":{ "type":"structure", "required":["id"], @@ -3358,6 +3417,14 @@ "Measurement":{ "type":"structure", "members":{ + "processingConfig":{"shape":"MeasurementProcessingConfig"} + } + }, + "MeasurementProcessingConfig":{ + "type":"structure", + "required":["forwardingConfig"], + "members":{ + "forwardingConfig":{"shape":"ForwardingConfig"} } }, "Metric":{ @@ -3370,7 +3437,15 @@ "members":{ "expression":{"shape":"Expression"}, "variables":{"shape":"ExpressionVariables"}, - "window":{"shape":"MetricWindow"} + "window":{"shape":"MetricWindow"}, + "processingConfig":{"shape":"MetricProcessingConfig"} + } + }, + "MetricProcessingConfig":{ + "type":"structure", + "required":["computeLocation"], + "members":{ + "computeLocation":{"shape":"ComputeLocation"} } }, "MetricWindow":{ @@ -3825,7 +3900,16 @@ ], "members":{ "expression":{"shape":"Expression"}, - "variables":{"shape":"ExpressionVariables"} + "variables":{"shape":"ExpressionVariables"}, + "processingConfig":{"shape":"TransformProcessingConfig"} + } + }, + "TransformProcessingConfig":{ + "type":"structure", + "required":["computeLocation"], + "members":{ + "computeLocation":{"shape":"ComputeLocation"}, + "forwardingConfig":{"shape":"ForwardingConfig"} } }, "TraversalDirection":{ diff --git a/models/apis/iotsitewise/2019-12-02/docs-2.json b/models/apis/iotsitewise/2019-12-02/docs-2.json index 9d4387ea13e..349e66a7302 100644 --- a/models/apis/iotsitewise/2019-12-02/docs-2.json +++ b/models/apis/iotsitewise/2019-12-02/docs-2.json @@ -31,7 +31,7 @@ "DescribeLoggingOptions": "Retrieves the current IoT SiteWise logging options.
", "DescribePortal": "Retrieves information about a portal.
", "DescribeProject": "Retrieves information about a project.
", - "DescribeStorageConfiguration": "Retrieves information about the storage configuration for IoT SiteWise.
", + "DescribeStorageConfiguration": "Retrieves information about the storage configuration for IoT SiteWise.
Exporting data to Amazon S3 is currently in preview release and is subject to change. We recommend that you use this feature only with test data, and not in production environments.
Disassociates a child asset from the given parent asset through a hierarchy defined in the parent asset's model.
", "GetAssetPropertyAggregates": "Gets aggregated values for an asset property. For more information, see Querying aggregates in the IoT SiteWise User Guide.
To identify an asset property, you must specify one of the following:
The assetId
and propertyId
of an asset property.
A propertyAlias
, which is a data stream alias (for example, /company/windfarm/3/turbine/7/temperature
). To define an asset property's alias, see UpdateAssetProperty.
Gets an asset property's current value. For more information, see Querying current values in the IoT SiteWise User Guide.
To identify an asset property, you must specify one of the following:
The assetId
and propertyId
of an asset property.
A propertyAlias
, which is a data stream alias (for example, /company/windfarm/3/turbine/7/temperature
). To define an asset property's alias, see UpdateAssetProperty.
Retrieves the list of tags for an IoT SiteWise resource.
", "PutDefaultEncryptionConfiguration": "Sets the default encryption configuration for the Amazon Web Services account. For more information, see Key management in the IoT SiteWise User Guide.
", "PutLoggingOptions": "Sets logging options for IoT SiteWise.
", - "PutStorageConfiguration": "Configures storage settings for IoT SiteWise.
", + "PutStorageConfiguration": "Configures storage settings for IoT SiteWise.
Exporting data to Amazon S3 is currently in preview release and is subject to change. We recommend that you use this feature only with test data, and not in production environments.
Adds tags to an IoT SiteWise resource. If a tag already exists for the resource, this operation updates the tag's value.
", "UntagResource": "Removes a tag from an IoT SiteWise resource.
", "UpdateAccessPolicy": "Updates an existing access policy that specifies an identity's access to an IoT SiteWise Monitor portal or project resource.
", @@ -583,6 +583,13 @@ "DescribeAssetPropertyResponse$compositeModel": "The composite asset model that declares this asset property, if this asset property exists in a composite model.
" } }, + "ComputeLocation": { + "base": null, + "refs": { + "MetricProcessingConfig$computeLocation": "The compute location for the given metric property.
", + "TransformProcessingConfig$computeLocation": "The compute location for the given transform property.
" + } + }, "ConfigurationErrorDetails": { "base": "Contains the details of an IoT SiteWise configuration error.
", "refs": { @@ -609,6 +616,12 @@ "refs": { } }, + "CoreDeviceThingName": { + "base": null, + "refs": { + "GreengrassV2$coreDeviceThingName": "The name of the IoT thing for your IoT Greengrass V2 core device.
" + } + }, "CreateAccessPolicyRequest": { "base": null, "refs": { @@ -920,6 +933,30 @@ "UpdateProjectRequest$projectDescription": "A new description for the project.
" } }, + "DetailedError": { + "base": "Contains detailed error information.
", + "refs": { + "DetailedErrors$member": null + } + }, + "DetailedErrorCode": { + "base": null, + "refs": { + "DetailedError$code": "The error code.
" + } + }, + "DetailedErrorMessage": { + "base": null, + "refs": { + "DetailedError$message": "The error message.
" + } + }, + "DetailedErrors": { + "base": null, + "refs": { + "ErrorDetails$details": "A list of detailed errors.
" + } + }, "DisassociateAssetsRequest": { "base": null, "refs": { @@ -1008,6 +1045,19 @@ "Transform$variables": "The list of variables used in the expression.
" } }, + "ForwardingConfig": { + "base": "The forwarding configuration for a given property.
", + "refs": { + "MeasurementProcessingConfig$forwardingConfig": "The forwarding configuration for the given measurement property.
", + "TransformProcessingConfig$forwardingConfig": null + } + }, + "ForwardingConfigState": { + "base": null, + "refs": { + "ForwardingConfig$state": "The forwarding state for the given property.
" + } + }, "GatewayCapabilitySummaries": { "base": null, "refs": { @@ -1025,7 +1075,8 @@ "base": "Contains a gateway's platform information.
", "refs": { "CreateGatewayRequest$gatewayPlatform": "The gateway's platform. You can only specify one platform in a gateway.
", - "DescribeGatewayResponse$gatewayPlatform": "The gateway's platform.
" + "DescribeGatewayResponse$gatewayPlatform": "The gateway's platform.
", + "GatewaySummary$gatewayPlatform": null } }, "GatewaySummaries": { @@ -1086,6 +1137,12 @@ "GatewayPlatform$greengrass": "A gateway that runs on IoT Greengrass.
" } }, + "GreengrassV2": { + "base": "Contains details for a gateway that runs on IoT Greengrass V2. To create a gateway that runs on IoT Greengrass V2, you must deploy the IoT SiteWise Edge component to your gateway device. Your Greengrass device role must use the AWSIoTSiteWiseEdgeAccess
policy. For more information, see Using IoT SiteWise at the edge in the IoT SiteWise User Guide.
A gateway that runs on IoT Greengrass V2.
" + } + }, "GroupIdentity": { "base": "Contains information for a group identity in an access policy.
", "refs": { @@ -1488,12 +1545,24 @@ "PropertyType$measurement": "Specifies an asset measurement property. A measurement represents a device's raw sensor data stream, such as timestamped temperature values or timestamped power values.
" } }, + "MeasurementProcessingConfig": { + "base": "The processing configuration for the given measurement property. You can configure measurements to be kept at the edge or forwarded to the Amazon Web Services Cloud. By default, measurements are forwarded to the cloud.
", + "refs": { + "Measurement$processingConfig": "The processing configuration for the given measurement property. You can configure measurements to be kept at the edge or forwarded to the Amazon Web Services Cloud. By default, measurements are forwarded to the cloud.
" + } + }, "Metric": { "base": "Contains an asset metric property. With metrics, you can calculate aggregate functions, such as an average, maximum, or minimum, as specified through an expression. A metric maps several values to a single value (such as a sum).
The maximum number of dependent/cascading variables used in any one metric calculation is 10. Therefore, a root metric can have up to 10 cascading metrics in its computational dependency tree. Additionally, a metric can only have a data type of DOUBLE
and consume properties with data types of INTEGER
or DOUBLE
.
For more information, see Metrics in the IoT SiteWise User Guide.
", "refs": { "PropertyType$metric": "Specifies an asset metric property. A metric contains a mathematical expression that uses aggregate functions to process all input data points over a time interval and output a single data point, such as to calculate the average hourly temperature.
" } }, + "MetricProcessingConfig": { + "base": "The processing configuration for the given metric property. You can configure metrics to be computed at the edge or in the Amazon Web Services Cloud. By default, metrics are forwarded to the cloud.
", + "refs": { + "Metric$processingConfig": "The processing configuration for the given metric property. You can configure metrics to be computed at the edge or in the Amazon Web Services Cloud. By default, metrics are forwarded to the cloud.
" + } + }, "MetricWindow": { "base": "Contains a time interval window used for data aggregate computations (for example, average, sum, count, and so on).
", "refs": { @@ -2017,6 +2086,12 @@ "PropertyType$transform": "Specifies an asset transform property. A transform contains a mathematical expression that maps a property's data points from one form to another, such as a unit conversion from Celsius to Fahrenheit.
" } }, + "TransformProcessingConfig": { + "base": "The processing configuration for the given transform property. You can configure transforms to be kept at the edge or forwarded to the Amazon Web Services Cloud. You can also configure transforms to be computed at the edge or in the cloud.
", + "refs": { + "Transform$processingConfig": "The processing configuration for the given transform property. You can configure transforms to be kept at the edge or forwarded to the Amazon Web Services Cloud. You can also configure transforms to be computed at the edge or in the cloud.
" + } + }, "TraversalDirection": { "base": null, "refs": { diff --git a/models/apis/savingsplans/2019-06-28/api-2.json b/models/apis/savingsplans/2019-06-28/api-2.json index 04e49cacf25..97fce7d71f8 100644 --- a/models/apis/savingsplans/2019-06-28/api-2.json +++ b/models/apis/savingsplans/2019-06-28/api-2.json @@ -755,7 +755,7 @@ "TermDurationInSeconds":{"type":"long"}, "UUID":{ "type":"string", - "pattern":"^(([0-9a-f]+)(-?))+$" + "pattern":"[a-f0-9]+(-[a-f0-9]+)*" }, "UUIDs":{ "type":"list", diff --git a/models/endpoints/endpoints.json b/models/endpoints/endpoints.json index b04bea45edd..cccc0c30c25 100644 --- a/models/endpoints/endpoints.json +++ b/models/endpoints/endpoints.json @@ -261,6 +261,29 @@ "us-west-2" : { } } }, + "amplify" : { + "endpoints" : { + "ap-east-1" : { }, + "ap-northeast-1" : { }, + "ap-northeast-2" : { }, + "ap-south-1" : { }, + "ap-southeast-1" : { }, + "ap-southeast-2" : { }, + "ca-central-1" : { }, + "eu-central-1" : { }, + "eu-north-1" : { }, + "eu-south-1" : { }, + "eu-west-1" : { }, + "eu-west-2" : { }, + "eu-west-3" : { }, + "me-south-1" : { }, + "sa-east-1" : { }, + "us-east-1" : { }, + "us-east-2" : { }, + "us-west-1" : { }, + "us-west-2" : { } + } + }, "amplifybackend" : { "endpoints" : { "ap-northeast-1" : { }, @@ -1789,6 +1812,7 @@ "ap-east-1" : { }, "ap-northeast-1" : { }, "ap-northeast-2" : { }, + "ap-northeast-3" : { }, "ap-south-1" : { }, "ap-southeast-1" : { }, "ap-southeast-2" : { }, @@ -7570,6 +7594,7 @@ }, "dax" : { "endpoints" : { + "cn-north-1" : { }, "cn-northwest-1" : { } } }, @@ -10253,6 +10278,11 @@ "us-iso-east-1" : { } } }, + "license-manager" : { + "endpoints" : { + "us-iso-east-1" : { } + } + }, "logs" : { "endpoints" : { "us-iso-east-1" : { } diff --git a/service/chime/api.go b/service/chime/api.go index 913dde15b2f..a3582966df3 100644 --- a/service/chime/api.go +++ b/service/chime/api.go @@ -17630,6 +17630,213 @@ func (c *Chime) SendChannelMessageWithContext(ctx aws.Context, input *SendChanne return out, req.Send() } +const opStartMeetingTranscription = "StartMeetingTranscription" + +// StartMeetingTranscriptionRequest generates a "aws/request.Request" representing the +// client's request for the StartMeetingTranscription 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 StartMeetingTranscription for more information on using the StartMeetingTranscription +// 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 StartMeetingTranscriptionRequest method. +// req, resp := client.StartMeetingTranscriptionRequest(params) +// +// err := req.Send() +// if err == nil { // resp is now filled +// fmt.Println(resp) +// } +// +// See also, https://docs.aws.amazon.com/goto/WebAPI/chime-2018-05-01/StartMeetingTranscription +func (c *Chime) StartMeetingTranscriptionRequest(input *StartMeetingTranscriptionInput) (req *request.Request, output *StartMeetingTranscriptionOutput) { + op := &request.Operation{ + Name: opStartMeetingTranscription, + HTTPMethod: "POST", + HTTPPath: "/meetings/{meetingId}/transcription?operation=start", + } + + if input == nil { + input = &StartMeetingTranscriptionInput{} + } + + output = &StartMeetingTranscriptionOutput{} + req = c.newRequest(op, input, output) + req.Handlers.Unmarshal.Swap(restjson.UnmarshalHandler.Name, protocol.UnmarshalDiscardBodyHandler) + return +} + +// StartMeetingTranscription API operation for Amazon Chime. +// +// Start transcription for the specified meetingId. +// +// Returns awserr.Error for service API and SDK errors. Use runtime type assertions +// with awserr.Error's Code and Message methods to get detailed information about +// the error. +// +// See the AWS API reference guide for Amazon Chime's +// API operation StartMeetingTranscription for usage and error information. +// +// Returned Error Types: +// * NotFoundException +// One or more of the resources in the request does not exist in the system. +// +// * ForbiddenException +// The client is permanently forbidden from making the request. +// +// * BadRequestException +// The input parameters don't match the service's restrictions. +// +// * ResourceLimitExceededException +// The request exceeds the resource limit. +// +// * ThrottledClientException +// The client exceeded its request rate limit. +// +// * UnauthorizedClientException +// The client is not currently authorized to make the request. +// +// * UnprocessableEntityException +// The request was well-formed but was unable to be followed due to semantic +// errors. +// +// * ServiceUnavailableException +// The service is currently unavailable. +// +// * ServiceFailureException +// The service encountered an unexpected error. +// +// See also, https://docs.aws.amazon.com/goto/WebAPI/chime-2018-05-01/StartMeetingTranscription +func (c *Chime) StartMeetingTranscription(input *StartMeetingTranscriptionInput) (*StartMeetingTranscriptionOutput, error) { + req, out := c.StartMeetingTranscriptionRequest(input) + return out, req.Send() +} + +// StartMeetingTranscriptionWithContext is the same as StartMeetingTranscription with the addition of +// the ability to pass a context and additional request options. +// +// See StartMeetingTranscription 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 *Chime) StartMeetingTranscriptionWithContext(ctx aws.Context, input *StartMeetingTranscriptionInput, opts ...request.Option) (*StartMeetingTranscriptionOutput, error) { + req, out := c.StartMeetingTranscriptionRequest(input) + req.SetContext(ctx) + req.ApplyOptions(opts...) + return out, req.Send() +} + +const opStopMeetingTranscription = "StopMeetingTranscription" + +// StopMeetingTranscriptionRequest generates a "aws/request.Request" representing the +// client's request for the StopMeetingTranscription 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 StopMeetingTranscription for more information on using the StopMeetingTranscription +// 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 StopMeetingTranscriptionRequest method. +// req, resp := client.StopMeetingTranscriptionRequest(params) +// +// err := req.Send() +// if err == nil { // resp is now filled +// fmt.Println(resp) +// } +// +// See also, https://docs.aws.amazon.com/goto/WebAPI/chime-2018-05-01/StopMeetingTranscription +func (c *Chime) StopMeetingTranscriptionRequest(input *StopMeetingTranscriptionInput) (req *request.Request, output *StopMeetingTranscriptionOutput) { + op := &request.Operation{ + Name: opStopMeetingTranscription, + HTTPMethod: "POST", + HTTPPath: "/meetings/{meetingId}/transcription?operation=stop", + } + + if input == nil { + input = &StopMeetingTranscriptionInput{} + } + + output = &StopMeetingTranscriptionOutput{} + req = c.newRequest(op, input, output) + req.Handlers.Unmarshal.Swap(restjson.UnmarshalHandler.Name, protocol.UnmarshalDiscardBodyHandler) + return +} + +// StopMeetingTranscription API operation for Amazon Chime. +// +// Stops transcription for the specified meetingId. +// +// Returns awserr.Error for service API and SDK errors. Use runtime type assertions +// with awserr.Error's Code and Message methods to get detailed information about +// the error. +// +// See the AWS API reference guide for Amazon Chime's +// API operation StopMeetingTranscription for usage and error information. +// +// Returned Error Types: +// * ForbiddenException +// The client is permanently forbidden from making the request. +// +// * NotFoundException +// One or more of the resources in the request does not exist in the system. +// +// * BadRequestException +// The input parameters don't match the service's restrictions. +// +// * ThrottledClientException +// The client exceeded its request rate limit. +// +// * UnauthorizedClientException +// The client is not currently authorized to make the request. +// +// * UnprocessableEntityException +// The request was well-formed but was unable to be followed due to semantic +// errors. +// +// * ServiceUnavailableException +// The service is currently unavailable. +// +// * ServiceFailureException +// The service encountered an unexpected error. +// +// See also, https://docs.aws.amazon.com/goto/WebAPI/chime-2018-05-01/StopMeetingTranscription +func (c *Chime) StopMeetingTranscription(input *StopMeetingTranscriptionInput) (*StopMeetingTranscriptionOutput, error) { + req, out := c.StopMeetingTranscriptionRequest(input) + return out, req.Send() +} + +// StopMeetingTranscriptionWithContext is the same as StopMeetingTranscription with the addition of +// the ability to pass a context and additional request options. +// +// See StopMeetingTranscription 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 *Chime) StopMeetingTranscriptionWithContext(ctx aws.Context, input *StopMeetingTranscriptionInput, opts ...request.Option) (*StopMeetingTranscriptionOutput, error) { + req, out := c.StopMeetingTranscriptionRequest(input) + req.SetContext(ctx) + req.ApplyOptions(opts...) + return out, req.Send() +} + const opTagAttendee = "TagAttendee" // TagAttendeeRequest generates a "aws/request.Request" representing the @@ -20396,7 +20603,7 @@ type Account struct { // AccountId is a required field AccountId *string `type:"string" required:"true"` - // The status of the account, Suspended or Active. + // The status of the account. AccountStatus *string `type:"string" enum:"AccountStatus"` // The Amazon Chime account type. For more information about different account @@ -28878,6 +29085,168 @@ func (s *EmergencyCallingConfiguration) SetDNIS(v []*DNISEmergencyCallingConfigu return s } +// Settings specific to the Amazon Transcribe Medical engine. +type EngineTranscribeMedicalSettings struct { + _ struct{} `type:"structure"` + + // The language code specified for the Amazon Transcribe Medical engine. + // + // LanguageCode is a required field + LanguageCode *string `type:"string" required:"true" enum:"TranscribeMedicalLanguageCode"` + + // The AWS Region passed to Amazon Transcribe Medical. If you don't specify + // a Region, Amazon Chime uses the Region closest to the meeting's Region. + Region *string `type:"string" enum:"TranscribeMedicalRegion"` + + // The specialty specified for the Amazon Transcribe Medical engine. + // + // Specialty is a required field + Specialty *string `type:"string" required:"true" enum:"TranscribeMedicalSpecialty"` + + // The type of transcription. + // + // Type is a required field + Type *string `type:"string" required:"true" enum:"TranscribeMedicalType"` + + // The name of the vocabulary passed to Amazon Transcribe Medical. + VocabularyName *string `type:"string"` +} + +// String returns the string representation +func (s EngineTranscribeMedicalSettings) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s EngineTranscribeMedicalSettings) GoString() string { + return s.String() +} + +// Validate inspects the fields of the type to determine if they are valid. +func (s *EngineTranscribeMedicalSettings) Validate() error { + invalidParams := request.ErrInvalidParams{Context: "EngineTranscribeMedicalSettings"} + if s.LanguageCode == nil { + invalidParams.Add(request.NewErrParamRequired("LanguageCode")) + } + if s.Specialty == nil { + invalidParams.Add(request.NewErrParamRequired("Specialty")) + } + if s.Type == nil { + invalidParams.Add(request.NewErrParamRequired("Type")) + } + + if invalidParams.Len() > 0 { + return invalidParams + } + return nil +} + +// SetLanguageCode sets the LanguageCode field's value. +func (s *EngineTranscribeMedicalSettings) SetLanguageCode(v string) *EngineTranscribeMedicalSettings { + s.LanguageCode = &v + return s +} + +// SetRegion sets the Region field's value. +func (s *EngineTranscribeMedicalSettings) SetRegion(v string) *EngineTranscribeMedicalSettings { + s.Region = &v + return s +} + +// SetSpecialty sets the Specialty field's value. +func (s *EngineTranscribeMedicalSettings) SetSpecialty(v string) *EngineTranscribeMedicalSettings { + s.Specialty = &v + return s +} + +// SetType sets the Type field's value. +func (s *EngineTranscribeMedicalSettings) SetType(v string) *EngineTranscribeMedicalSettings { + s.Type = &v + return s +} + +// SetVocabularyName sets the VocabularyName field's value. +func (s *EngineTranscribeMedicalSettings) SetVocabularyName(v string) *EngineTranscribeMedicalSettings { + s.VocabularyName = &v + return s +} + +// Settings specific to the Amazon Transcribe engine. +type EngineTranscribeSettings struct { + _ struct{} `type:"structure"` + + // The language code specified for the Amazon Transcribe engine. + // + // LanguageCode is a required field + LanguageCode *string `type:"string" required:"true" enum:"TranscribeLanguageCode"` + + // The AWS Region passed to Amazon Transcribe. If you don't specify a Region, + // Amazon Chime uses the Region closest to the meeting's Region. + Region *string `type:"string" enum:"TranscribeRegion"` + + // The filtering method passed to Amazon Transcribe. + VocabularyFilterMethod *string `type:"string" enum:"TranscribeVocabularyFilterMethod"` + + // The name of the vocabulary filter passed to Amazon Transcribe. + VocabularyFilterName *string `type:"string"` + + // The name of the vocabulary passed to Amazon Transcribe. + VocabularyName *string `type:"string"` +} + +// String returns the string representation +func (s EngineTranscribeSettings) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s EngineTranscribeSettings) GoString() string { + return s.String() +} + +// Validate inspects the fields of the type to determine if they are valid. +func (s *EngineTranscribeSettings) Validate() error { + invalidParams := request.ErrInvalidParams{Context: "EngineTranscribeSettings"} + if s.LanguageCode == nil { + invalidParams.Add(request.NewErrParamRequired("LanguageCode")) + } + + if invalidParams.Len() > 0 { + return invalidParams + } + return nil +} + +// SetLanguageCode sets the LanguageCode field's value. +func (s *EngineTranscribeSettings) SetLanguageCode(v string) *EngineTranscribeSettings { + s.LanguageCode = &v + return s +} + +// SetRegion sets the Region field's value. +func (s *EngineTranscribeSettings) SetRegion(v string) *EngineTranscribeSettings { + s.Region = &v + return s +} + +// SetVocabularyFilterMethod sets the VocabularyFilterMethod field's value. +func (s *EngineTranscribeSettings) SetVocabularyFilterMethod(v string) *EngineTranscribeSettings { + s.VocabularyFilterMethod = &v + return s +} + +// SetVocabularyFilterName sets the VocabularyFilterName field's value. +func (s *EngineTranscribeSettings) SetVocabularyFilterName(v string) *EngineTranscribeSettings { + s.VocabularyFilterName = &v + return s +} + +// SetVocabularyName sets the VocabularyName field's value. +func (s *EngineTranscribeSettings) SetVocabularyName(v string) *EngineTranscribeSettings { + s.VocabularyName = &v + return s +} + // The configuration that allows a bot to receive outgoing events. Can be either // an HTTPS endpoint or a Lambda function ARN. type EventsConfiguration struct { @@ -34370,7 +34739,7 @@ func (s *MediaCapturePipeline) SetUpdatedTimestamp(v time.Time) *MediaCapturePip } // A set of endpoints used by clients to connect to the media service group -// for a Amazon Chime SDK meeting. +// for an Amazon Chime SDK meeting. type MediaPlacement struct { _ struct{} `type:"structure"` @@ -34380,7 +34749,7 @@ type MediaPlacement struct { // The audio host URL. AudioHostUrl *string `type:"string"` - // The event ingestion URL. + // The URL of the S3 bucket used to store the captured media. EventIngestionUrl *string `type:"string"` // The screen data URL. @@ -38114,6 +38483,136 @@ func (s *SipRuleTargetApplication) SetSipMediaApplicationId(v string) *SipRuleTa return s } +type StartMeetingTranscriptionInput struct { + _ struct{} `type:"structure"` + + // The unique ID of the meeting being transcribed. + // + // MeetingId is a required field + MeetingId *string `location:"uri" locationName:"meetingId" type:"string" required:"true"` + + // The configuration for the current transcription operation. Must contain EngineTranscribeSettings + // or EngineTranscribeMedicalSettings. + // + // TranscriptionConfiguration is a required field + TranscriptionConfiguration *TranscriptionConfiguration `type:"structure" required:"true"` +} + +// String returns the string representation +func (s StartMeetingTranscriptionInput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s StartMeetingTranscriptionInput) GoString() string { + return s.String() +} + +// Validate inspects the fields of the type to determine if they are valid. +func (s *StartMeetingTranscriptionInput) Validate() error { + invalidParams := request.ErrInvalidParams{Context: "StartMeetingTranscriptionInput"} + if s.MeetingId == nil { + invalidParams.Add(request.NewErrParamRequired("MeetingId")) + } + if s.MeetingId != nil && len(*s.MeetingId) < 1 { + invalidParams.Add(request.NewErrParamMinLen("MeetingId", 1)) + } + if s.TranscriptionConfiguration == nil { + invalidParams.Add(request.NewErrParamRequired("TranscriptionConfiguration")) + } + if s.TranscriptionConfiguration != nil { + if err := s.TranscriptionConfiguration.Validate(); err != nil { + invalidParams.AddNested("TranscriptionConfiguration", err.(request.ErrInvalidParams)) + } + } + + if invalidParams.Len() > 0 { + return invalidParams + } + return nil +} + +// SetMeetingId sets the MeetingId field's value. +func (s *StartMeetingTranscriptionInput) SetMeetingId(v string) *StartMeetingTranscriptionInput { + s.MeetingId = &v + return s +} + +// SetTranscriptionConfiguration sets the TranscriptionConfiguration field's value. +func (s *StartMeetingTranscriptionInput) SetTranscriptionConfiguration(v *TranscriptionConfiguration) *StartMeetingTranscriptionInput { + s.TranscriptionConfiguration = v + return s +} + +type StartMeetingTranscriptionOutput struct { + _ struct{} `type:"structure"` +} + +// String returns the string representation +func (s StartMeetingTranscriptionOutput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s StartMeetingTranscriptionOutput) GoString() string { + return s.String() +} + +type StopMeetingTranscriptionInput struct { + _ struct{} `type:"structure"` + + // The unique ID of the meeting for which you stop transcription. + // + // MeetingId is a required field + MeetingId *string `location:"uri" locationName:"meetingId" type:"string" required:"true"` +} + +// String returns the string representation +func (s StopMeetingTranscriptionInput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s StopMeetingTranscriptionInput) GoString() string { + return s.String() +} + +// Validate inspects the fields of the type to determine if they are valid. +func (s *StopMeetingTranscriptionInput) Validate() error { + invalidParams := request.ErrInvalidParams{Context: "StopMeetingTranscriptionInput"} + if s.MeetingId == nil { + invalidParams.Add(request.NewErrParamRequired("MeetingId")) + } + if s.MeetingId != nil && len(*s.MeetingId) < 1 { + invalidParams.Add(request.NewErrParamMinLen("MeetingId", 1)) + } + + if invalidParams.Len() > 0 { + return invalidParams + } + return nil +} + +// SetMeetingId sets the MeetingId field's value. +func (s *StopMeetingTranscriptionInput) SetMeetingId(v string) *StopMeetingTranscriptionInput { + s.MeetingId = &v + return s +} + +type StopMeetingTranscriptionOutput struct { + _ struct{} `type:"structure"` +} + +// String returns the string representation +func (s StopMeetingTranscriptionOutput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s StopMeetingTranscriptionOutput) GoString() string { + return s.String() +} + // The streaming configuration associated with an Amazon Chime Voice Connector. // Specifies whether media streaming is enabled for sending to Amazon Kinesis, // and shows the retention period for the Amazon Kinesis data, in hours. @@ -38782,6 +39281,60 @@ func (s *ThrottledClientException) RequestID() string { return s.RespMetadata.RequestID } +// The configuration for the current transcription operation. Must contain EngineTranscribeSettings +// or EngineTranscribeMedicalSettings. +type TranscriptionConfiguration struct { + _ struct{} `type:"structure"` + + // The transcription configuration settings passed to Amazon Transcribe. + EngineTranscribeMedicalSettings *EngineTranscribeMedicalSettings `type:"structure"` + + // The transcription configuration settings passed to Amazon Transcribe. + EngineTranscribeSettings *EngineTranscribeSettings `type:"structure"` +} + +// String returns the string representation +func (s TranscriptionConfiguration) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s TranscriptionConfiguration) GoString() string { + return s.String() +} + +// Validate inspects the fields of the type to determine if they are valid. +func (s *TranscriptionConfiguration) Validate() error { + invalidParams := request.ErrInvalidParams{Context: "TranscriptionConfiguration"} + if s.EngineTranscribeMedicalSettings != nil { + if err := s.EngineTranscribeMedicalSettings.Validate(); err != nil { + invalidParams.AddNested("EngineTranscribeMedicalSettings", err.(request.ErrInvalidParams)) + } + } + if s.EngineTranscribeSettings != nil { + if err := s.EngineTranscribeSettings.Validate(); err != nil { + invalidParams.AddNested("EngineTranscribeSettings", err.(request.ErrInvalidParams)) + } + } + + if invalidParams.Len() > 0 { + return invalidParams + } + return nil +} + +// SetEngineTranscribeMedicalSettings sets the EngineTranscribeMedicalSettings field's value. +func (s *TranscriptionConfiguration) SetEngineTranscribeMedicalSettings(v *EngineTranscribeMedicalSettings) *TranscriptionConfiguration { + s.EngineTranscribeMedicalSettings = v + return s +} + +// SetEngineTranscribeSettings sets the EngineTranscribeSettings field's value. +func (s *TranscriptionConfiguration) SetEngineTranscribeSettings(v *EngineTranscribeSettings) *TranscriptionConfiguration { + s.EngineTranscribeSettings = v + return s +} + // The client is not currently authorized to make the request. type UnauthorizedClientException struct { _ struct{} `type:"structure"` @@ -42340,6 +42893,226 @@ func SortOrder_Values() []string { } } +const ( + // TranscribeLanguageCodeEnUs is a TranscribeLanguageCode enum value + TranscribeLanguageCodeEnUs = "en-US" + + // TranscribeLanguageCodeEnGb is a TranscribeLanguageCode enum value + TranscribeLanguageCodeEnGb = "en-GB" + + // TranscribeLanguageCodeEsUs is a TranscribeLanguageCode enum value + TranscribeLanguageCodeEsUs = "es-US" + + // TranscribeLanguageCodeFrCa is a TranscribeLanguageCode enum value + TranscribeLanguageCodeFrCa = "fr-CA" + + // TranscribeLanguageCodeFrFr is a TranscribeLanguageCode enum value + TranscribeLanguageCodeFrFr = "fr-FR" + + // TranscribeLanguageCodeEnAu is a TranscribeLanguageCode enum value + TranscribeLanguageCodeEnAu = "en-AU" + + // TranscribeLanguageCodeItIt is a TranscribeLanguageCode enum value + TranscribeLanguageCodeItIt = "it-IT" + + // TranscribeLanguageCodeDeDe is a TranscribeLanguageCode enum value + TranscribeLanguageCodeDeDe = "de-DE" + + // TranscribeLanguageCodePtBr is a TranscribeLanguageCode enum value + TranscribeLanguageCodePtBr = "pt-BR" + + // TranscribeLanguageCodeJaJp is a TranscribeLanguageCode enum value + TranscribeLanguageCodeJaJp = "ja-JP" + + // TranscribeLanguageCodeKoKr is a TranscribeLanguageCode enum value + TranscribeLanguageCodeKoKr = "ko-KR" + + // TranscribeLanguageCodeZhCn is a TranscribeLanguageCode enum value + TranscribeLanguageCodeZhCn = "zh-CN" +) + +// TranscribeLanguageCode_Values returns all elements of the TranscribeLanguageCode enum +func TranscribeLanguageCode_Values() []string { + return []string{ + TranscribeLanguageCodeEnUs, + TranscribeLanguageCodeEnGb, + TranscribeLanguageCodeEsUs, + TranscribeLanguageCodeFrCa, + TranscribeLanguageCodeFrFr, + TranscribeLanguageCodeEnAu, + TranscribeLanguageCodeItIt, + TranscribeLanguageCodeDeDe, + TranscribeLanguageCodePtBr, + TranscribeLanguageCodeJaJp, + TranscribeLanguageCodeKoKr, + TranscribeLanguageCodeZhCn, + } +} + +const ( + // TranscribeMedicalLanguageCodeEnUs is a TranscribeMedicalLanguageCode enum value + TranscribeMedicalLanguageCodeEnUs = "en-US" +) + +// TranscribeMedicalLanguageCode_Values returns all elements of the TranscribeMedicalLanguageCode enum +func TranscribeMedicalLanguageCode_Values() []string { + return []string{ + TranscribeMedicalLanguageCodeEnUs, + } +} + +const ( + // TranscribeMedicalRegionUsEast1 is a TranscribeMedicalRegion enum value + TranscribeMedicalRegionUsEast1 = "us-east-1" + + // TranscribeMedicalRegionUsEast2 is a TranscribeMedicalRegion enum value + TranscribeMedicalRegionUsEast2 = "us-east-2" + + // TranscribeMedicalRegionUsWest2 is a TranscribeMedicalRegion enum value + TranscribeMedicalRegionUsWest2 = "us-west-2" + + // TranscribeMedicalRegionApSoutheast2 is a TranscribeMedicalRegion enum value + TranscribeMedicalRegionApSoutheast2 = "ap-southeast-2" + + // TranscribeMedicalRegionCaCentral1 is a TranscribeMedicalRegion enum value + TranscribeMedicalRegionCaCentral1 = "ca-central-1" + + // TranscribeMedicalRegionEuWest1 is a TranscribeMedicalRegion enum value + TranscribeMedicalRegionEuWest1 = "eu-west-1" +) + +// TranscribeMedicalRegion_Values returns all elements of the TranscribeMedicalRegion enum +func TranscribeMedicalRegion_Values() []string { + return []string{ + TranscribeMedicalRegionUsEast1, + TranscribeMedicalRegionUsEast2, + TranscribeMedicalRegionUsWest2, + TranscribeMedicalRegionApSoutheast2, + TranscribeMedicalRegionCaCentral1, + TranscribeMedicalRegionEuWest1, + } +} + +const ( + // TranscribeMedicalSpecialtyPrimarycare is a TranscribeMedicalSpecialty enum value + TranscribeMedicalSpecialtyPrimarycare = "PRIMARYCARE" + + // TranscribeMedicalSpecialtyCardiology is a TranscribeMedicalSpecialty enum value + TranscribeMedicalSpecialtyCardiology = "CARDIOLOGY" + + // TranscribeMedicalSpecialtyNeurology is a TranscribeMedicalSpecialty enum value + TranscribeMedicalSpecialtyNeurology = "NEUROLOGY" + + // TranscribeMedicalSpecialtyOncology is a TranscribeMedicalSpecialty enum value + TranscribeMedicalSpecialtyOncology = "ONCOLOGY" + + // TranscribeMedicalSpecialtyRadiology is a TranscribeMedicalSpecialty enum value + TranscribeMedicalSpecialtyRadiology = "RADIOLOGY" + + // TranscribeMedicalSpecialtyUrology is a TranscribeMedicalSpecialty enum value + TranscribeMedicalSpecialtyUrology = "UROLOGY" +) + +// TranscribeMedicalSpecialty_Values returns all elements of the TranscribeMedicalSpecialty enum +func TranscribeMedicalSpecialty_Values() []string { + return []string{ + TranscribeMedicalSpecialtyPrimarycare, + TranscribeMedicalSpecialtyCardiology, + TranscribeMedicalSpecialtyNeurology, + TranscribeMedicalSpecialtyOncology, + TranscribeMedicalSpecialtyRadiology, + TranscribeMedicalSpecialtyUrology, + } +} + +const ( + // TranscribeMedicalTypeConversation is a TranscribeMedicalType enum value + TranscribeMedicalTypeConversation = "CONVERSATION" + + // TranscribeMedicalTypeDictation is a TranscribeMedicalType enum value + TranscribeMedicalTypeDictation = "DICTATION" +) + +// TranscribeMedicalType_Values returns all elements of the TranscribeMedicalType enum +func TranscribeMedicalType_Values() []string { + return []string{ + TranscribeMedicalTypeConversation, + TranscribeMedicalTypeDictation, + } +} + +const ( + // TranscribeRegionUsEast2 is a TranscribeRegion enum value + TranscribeRegionUsEast2 = "us-east-2" + + // TranscribeRegionUsEast1 is a TranscribeRegion enum value + TranscribeRegionUsEast1 = "us-east-1" + + // TranscribeRegionUsWest2 is a TranscribeRegion enum value + TranscribeRegionUsWest2 = "us-west-2" + + // TranscribeRegionApNortheast2 is a TranscribeRegion enum value + TranscribeRegionApNortheast2 = "ap-northeast-2" + + // TranscribeRegionApSoutheast2 is a TranscribeRegion enum value + TranscribeRegionApSoutheast2 = "ap-southeast-2" + + // TranscribeRegionApNortheast1 is a TranscribeRegion enum value + TranscribeRegionApNortheast1 = "ap-northeast-1" + + // TranscribeRegionCaCentral1 is a TranscribeRegion enum value + TranscribeRegionCaCentral1 = "ca-central-1" + + // TranscribeRegionEuCentral1 is a TranscribeRegion enum value + TranscribeRegionEuCentral1 = "eu-central-1" + + // TranscribeRegionEuWest1 is a TranscribeRegion enum value + TranscribeRegionEuWest1 = "eu-west-1" + + // TranscribeRegionEuWest2 is a TranscribeRegion enum value + TranscribeRegionEuWest2 = "eu-west-2" + + // TranscribeRegionSaEast1 is a TranscribeRegion enum value + TranscribeRegionSaEast1 = "sa-east-1" +) + +// TranscribeRegion_Values returns all elements of the TranscribeRegion enum +func TranscribeRegion_Values() []string { + return []string{ + TranscribeRegionUsEast2, + TranscribeRegionUsEast1, + TranscribeRegionUsWest2, + TranscribeRegionApNortheast2, + TranscribeRegionApSoutheast2, + TranscribeRegionApNortheast1, + TranscribeRegionCaCentral1, + TranscribeRegionEuCentral1, + TranscribeRegionEuWest1, + TranscribeRegionEuWest2, + TranscribeRegionSaEast1, + } +} + +const ( + // TranscribeVocabularyFilterMethodRemove is a TranscribeVocabularyFilterMethod enum value + TranscribeVocabularyFilterMethodRemove = "remove" + + // TranscribeVocabularyFilterMethodMask is a TranscribeVocabularyFilterMethod enum value + TranscribeVocabularyFilterMethodMask = "mask" + + // TranscribeVocabularyFilterMethodTag is a TranscribeVocabularyFilterMethod enum value + TranscribeVocabularyFilterMethodTag = "tag" +) + +// TranscribeVocabularyFilterMethod_Values returns all elements of the TranscribeVocabularyFilterMethod enum +func TranscribeVocabularyFilterMethod_Values() []string { + return []string{ + TranscribeVocabularyFilterMethodRemove, + TranscribeVocabularyFilterMethodMask, + TranscribeVocabularyFilterMethodTag, + } +} + const ( // UserTypePrivateUser is a UserType enum value UserTypePrivateUser = "PrivateUser" diff --git a/service/chime/chimeiface/interface.go b/service/chime/chimeiface/interface.go index 3acd2d817ee..4e182fa8ea9 100644 --- a/service/chime/chimeiface/interface.go +++ b/service/chime/chimeiface/interface.go @@ -782,6 +782,14 @@ type ChimeAPI interface { SendChannelMessageWithContext(aws.Context, *chime.SendChannelMessageInput, ...request.Option) (*chime.SendChannelMessageOutput, error) SendChannelMessageRequest(*chime.SendChannelMessageInput) (*request.Request, *chime.SendChannelMessageOutput) + StartMeetingTranscription(*chime.StartMeetingTranscriptionInput) (*chime.StartMeetingTranscriptionOutput, error) + StartMeetingTranscriptionWithContext(aws.Context, *chime.StartMeetingTranscriptionInput, ...request.Option) (*chime.StartMeetingTranscriptionOutput, error) + StartMeetingTranscriptionRequest(*chime.StartMeetingTranscriptionInput) (*request.Request, *chime.StartMeetingTranscriptionOutput) + + StopMeetingTranscription(*chime.StopMeetingTranscriptionInput) (*chime.StopMeetingTranscriptionOutput, error) + StopMeetingTranscriptionWithContext(aws.Context, *chime.StopMeetingTranscriptionInput, ...request.Option) (*chime.StopMeetingTranscriptionOutput, error) + StopMeetingTranscriptionRequest(*chime.StopMeetingTranscriptionInput) (*request.Request, *chime.StopMeetingTranscriptionOutput) + TagAttendee(*chime.TagAttendeeInput) (*chime.TagAttendeeOutput, error) TagAttendeeWithContext(aws.Context, *chime.TagAttendeeInput, ...request.Option) (*chime.TagAttendeeOutput, error) TagAttendeeRequest(*chime.TagAttendeeInput) (*request.Request, *chime.TagAttendeeOutput) diff --git a/service/ec2/api.go b/service/ec2/api.go index 2671cd32d6b..e84fda30309 100644 --- a/service/ec2/api.go +++ b/service/ec2/api.go @@ -604,10 +604,11 @@ func (c *EC2) AllocateAddressRequest(input *AllocateAddressInput) (req *request. // AllocateAddress API operation for Amazon Elastic Compute Cloud. // -// Allocates an Elastic IP address to your account. After you allocate the Elastic -// IP address you can associate it with an instance or network interface. After -// you release an Elastic IP address, it is released to the IP address pool -// and can be allocated to a different account. +// Allocates an Elastic IP address to your Amazon Web Services account. After +// you allocate the Elastic IP address you can associate it with an instance +// or network interface. After you release an Elastic IP address, it is released +// to the IP address pool and can be allocated to a different Amazon Web Services +// account. // // You can allocate an Elastic IP address from an address pool owned by Amazon // Web Services or from an address pool created from a public IPv4 address range @@ -618,9 +619,9 @@ func (c *EC2) AllocateAddressRequest(input *AllocateAddressInput) (req *request. // // [EC2-VPC] If you release an Elastic IP address, you might be able to recover // it. You cannot recover an Elastic IP address that you released after it is -// allocated to another account. You cannot recover an Elastic IP address for -// EC2-Classic. To attempt to recover an Elastic IP address that you released, -// specify it in this operation. +// allocated to another Amazon Web Services account. You cannot recover an Elastic +// IP address for EC2-Classic. To attempt to recover an Elastic IP address that +// you released, specify it in this operation. // // An Elastic IP address is for use either in the EC2-Classic platform or in // a VPC. By default, you can allocate 5 Elastic IP addresses for EC2-Classic @@ -2291,11 +2292,12 @@ func (c *EC2) AttachVolumeRequest(input *AttachVolumeInput) (req *request.Reques // After you attach an EBS volume, you must make it available. For more information, // see Make an EBS volume available for use (https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ebs-using-volumes.html). // -// If a volume has an Marketplace product code: +// If a volume has an Amazon Web Services Marketplace product code: // // * The volume can be attached only to a stopped instance. // -// * Marketplace product codes are copied from the volume to the instance. +// * Amazon Web Services Marketplace product codes are copied from the volume +// to the instance. // // * You must be subscribed to the product. // @@ -6020,8 +6022,8 @@ func (c *EC2) CreateNetworkInterfacePermissionRequest(input *CreateNetworkInterf // Grants an Amazon Web Services-authorized account permission to attach the // specified network interface to an instance in their account. // -// You can grant permission to a single account only, and only one account at -// a time. +// You can grant permission to a single Amazon Web Services account only, and +// only one account at a time. // // 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 @@ -6717,8 +6719,8 @@ func (c *EC2) CreateSnapshotRequest(input *CreateSnapshotInput) (req *request.Re // an Outpost, the snapshot can be stored on the same Outpost as the volume, // or in the Region for that Outpost. // -// When a snapshot is created, any Marketplace product codes that are associated -// with the source volume are propagated to the snapshot. +// When a snapshot is created, any Amazon Web Services Marketplace product codes +// that are associated with the source volume are propagated to the snapshot. // // You can take a snapshot of an attached volume that is in use. However, snapshots // only capture data that has been written to your Amazon EBS volume at the @@ -6903,8 +6905,8 @@ func (c *EC2) CreateSpotDatafeedSubscriptionRequest(input *CreateSpotDatafeedSub // CreateSpotDatafeedSubscription API operation for Amazon Elastic Compute Cloud. // // Creates a data feed for Spot Instances, enabling you to view Spot Instance -// usage logs. You can create one data feed per account. For more information, -// see Spot Instance data feed (https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/spot-data-feeds.html) +// usage logs. You can create one data feed per Amazon Web Services account. +// For more information, see Spot Instance data feed (https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/spot-data-feeds.html) // in the Amazon EC2 User Guide for Linux Instances. // // Returns awserr.Error for service API and SDK errors. Use runtime type assertions @@ -8364,7 +8366,8 @@ func (c *EC2) CreateVolumeRequest(input *CreateVolumeInput) (req *request.Reques // Zone. // // You can create a new empty volume or restore a volume from an EBS snapshot. -// Any Marketplace product codes from the snapshot are propagated to the volume. +// Any Amazon Web Services Marketplace product codes from the snapshot are propagated +// to the volume. // // You can create encrypted volumes. Encrypted volumes must be attached to instances // that support Amazon EBS encryption. Volumes that are created from encrypted @@ -8813,9 +8816,9 @@ func (c *EC2) CreateVpcPeeringConnectionRequest(input *CreateVpcPeeringConnectio // // Requests a VPC peering connection between two VPCs: a requester VPC that // you own and an accepter VPC with which to create the connection. The accepter -// VPC can belong to another account and can be in a different Region to the -// requester VPC. The requester VPC and accepter VPC cannot have overlapping -// CIDR blocks. +// VPC can belong to another Amazon Web Services account and can be in a different +// Region to the requester VPC. The requester VPC and accepter VPC cannot have +// overlapping CIDR blocks. // // Limitations and rules apply to a VPC peering connection. For more information, // see the limitations (https://docs.aws.amazon.com/vpc/latest/peering/vpc-peering-basics.html#vpc-peering-limitations) @@ -14548,7 +14551,8 @@ func (c *EC2) DescribeCapacityReservationsRequest(input *DescribeCapacityReserva // DescribeCapacityReservations API operation for Amazon Elastic Compute Cloud. // // Describes one or more of your Capacity Reservations. The results describe -// only the Capacity Reservations in the Region that you're currently using. +// only the Capacity Reservations in the Amazon Web Services Region that you're +// currently using. // // 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 @@ -23921,25 +23925,25 @@ func (c *EC2) DescribeSnapshotsRequest(input *DescribeSnapshotsInput) (req *requ // snapshots available to you. // // The snapshots available to you include public snapshots, private snapshots -// that you own, and private snapshots owned by other accounts for which you -// have explicit create volume permissions. +// that you own, and private snapshots owned by other Amazon Web Services accounts +// for which you have explicit create volume permissions. // // The create volume permissions fall into the following categories: // // * public: The owner of the snapshot granted create volume permissions -// for the snapshot to the all group. All accounts have create volume permissions -// for these snapshots. +// for the snapshot to the all group. All Amazon Web Services accounts have +// create volume permissions for these snapshots. // // * explicit: The owner of the snapshot granted create volume permissions -// to a specific account. +// to a specific Amazon Web Services account. // -// * implicit: An account has implicit create volume permissions for all -// snapshots it owns. +// * implicit: An Amazon Web Services account has implicit create volume +// permissions for all snapshots it owns. // // The list of snapshots returned can be filtered by specifying snapshot IDs, -// snapshot owners, or accounts with create volume permissions. If no options -// are specified, Amazon EC2 returns all snapshots for which you have create -// volume permissions. +// snapshot owners, or Amazon Web Services accounts with create volume permissions. +// If no options are specified, Amazon EC2 returns all snapshots for which you +// have create volume permissions. // // If you specify one or more snapshot IDs, only snapshots that have the specified // IDs are returned. If you specify an invalid snapshot ID, an error is returned. @@ -23948,13 +23952,14 @@ func (c *EC2) DescribeSnapshotsRequest(input *DescribeSnapshotsInput) (req *requ // // If you specify one or more snapshot owners using the OwnerIds option, only // snapshots from the specified owners and for which you have access are returned. -// The results can include the account IDs of the specified owners, amazon for -// snapshots owned by Amazon, or self for snapshots that you own. +// The results can include the Amazon Web Services account IDs of the specified +// owners, amazon for snapshots owned by Amazon, or self for snapshots that +// you own. // // If you specify a list of restorable users, only snapshots with create snapshot -// permissions for those users are returned. You can specify account IDs (if -// you own the snapshots), self for snapshots for which you own or have explicit -// permissions, or all for public snapshots. +// permissions for those users are returned. You can specify Amazon Web Services +// account IDs (if you own the snapshots), self for snapshots for which you +// own or have explicit permissions, or all for public snapshots. // // If you are describing a long list of snapshots, we recommend that you paginate // the output to make the list more manageable. The MaxResults parameter sets @@ -29045,8 +29050,8 @@ func (c *EC2) DetachVolumeRequest(input *DetachVolumeInput) (req *request.Reques // while the instance is running. To detach the root volume, stop the instance // first. // -// When a volume with an Marketplace product code is detached from an instance, -// the product code is no longer associated with the instance. +// When a volume with an Amazon Web Services Marketplace product code is detached +// from an instance, the product code is no longer associated with the instance. // // For more information, see Detach an Amazon EBS volume (https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ebs-detaching-volume.html) // in the Amazon Elastic Compute Cloud User Guide. @@ -31919,9 +31924,9 @@ func (c *EC2) GetCapacityReservationUsageRequest(input *GetCapacityReservationUs // // Gets usage information about a Capacity Reservation. If the Capacity Reservation // is shared, it shows usage information for the Capacity Reservation owner -// and each account that is currently using the shared capacity. If the Capacity -// Reservation is not shared, it shows only the Capacity Reservation owner's -// usage. +// and each Amazon Web Services account that is currently using the shared capacity. +// If the Capacity Reservation is not shared, it shows only the Capacity Reservation +// owner's usage. // // 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 @@ -34895,16 +34900,16 @@ func (c *EC2) ModifyDefaultCreditSpecificationRequest(input *ModifyDefaultCredit // ModifyDefaultCreditSpecification API operation for Amazon Elastic Compute Cloud. // // Modifies the default credit option for CPU usage of burstable performance -// instances. The default credit option is set at the account level per Region, -// and is specified per instance family. All new burstable performance instances -// in the account launch using the default credit option. +// instances. The default credit option is set at the account level per Amazon +// Web Services Region, and is specified per instance family. All new burstable +// performance instances in the account launch using the default credit option. // // ModifyDefaultCreditSpecification is an asynchronous operation, which works -// at an Region level and modifies the credit option for each Availability Zone. -// All zones in a Region are updated within five minutes. But if instances are -// launched during this operation, they might not get the new credit option -// until the zone is updated. To verify whether the update has occurred, you -// can call GetDefaultCreditSpecification and check DefaultCreditSpecification +// at an Amazon Web Services Region level and modifies the credit option for +// each Availability Zone. All zones in a Region are updated within five minutes. +// But if instances are launched during this operation, they might not get the +// new credit option until the zone is updated. To verify whether the update +// has occurred, you can call GetDefaultCreditSpecification and check DefaultCreditSpecification // for updates. // // For more information, see Burstable performance instances (https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/burstable-performance-instances.html) @@ -36575,14 +36580,15 @@ func (c *EC2) ModifySnapshotAttributeRequest(input *ModifySnapshotAttributeInput // ModifySnapshotAttribute API operation for Amazon Elastic Compute Cloud. // // Adds or removes permission settings for the specified snapshot. You may add -// or remove specified account IDs from a snapshot's list of create volume permissions, -// but you cannot do both in a single operation. If you need to both add and -// remove account IDs for a snapshot, you must use multiple operations. You -// can make up to 500 modifications to a snapshot in a single operation. +// or remove specified Amazon Web Services account IDs from a snapshot's list +// of create volume permissions, but you cannot do both in a single operation. +// If you need to both add and remove account IDs for a snapshot, you must use +// multiple operations. You can make up to 500 modifications to a snapshot in +// a single operation. // -// Encrypted snapshots and snapshots with Marketplace product codes cannot be -// made public. Snapshots encrypted with your default KMS key cannot be shared -// with other accounts. +// Encrypted snapshots and snapshots with Amazon Web Services Marketplace product +// codes cannot be made public. Snapshots encrypted with your default KMS key +// cannot be shared with other accounts. // // For more information about modifying snapshot permissions, see Share a snapshot // (https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ebs-modifying-snapshot-permissions.html) @@ -37885,16 +37891,17 @@ func (c *EC2) ModifyVpcPeeringConnectionOptionsRequest(input *ModifyVpcPeeringCo // * Enable/disable the ability to resolve public DNS hostnames to private // IP addresses when queried from instances in the peer VPC. // -// If the peered VPCs are in the same account, you can enable DNS resolution -// for queries from the local VPC. This ensures that queries from the local -// VPC resolve to private IP addresses in the peer VPC. This option is not available -// if the peered VPCs are in different different accounts or different Regions. -// For peered VPCs in different accounts, each account owner must initiate a -// separate request to modify the peering connection options. For inter-region -// peering connections, you must use the Region for the requester VPC to modify -// the requester VPC peering options and the Region for the accepter VPC to -// modify the accepter VPC peering options. To verify which VPCs are the accepter -// and the requester for a VPC peering connection, use the DescribeVpcPeeringConnections +// If the peered VPCs are in the same Amazon Web Services account, you can enable +// DNS resolution for queries from the local VPC. This ensures that queries +// from the local VPC resolve to private IP addresses in the peer VPC. This +// option is not available if the peered VPCs are in different different Amazon +// Web Services accounts or different Regions. For peered VPCs in different +// Amazon Web Services accounts, each Amazon Web Services account owner must +// initiate a separate request to modify the peering connection options. For +// inter-region peering connections, you must use the Region for the requester +// VPC to modify the requester VPC peering options and the Region for the accepter +// VPC to modify the accepter VPC peering options. To verify which VPCs are +// the accepter and the requester for a VPC peering connection, use the DescribeVpcPeeringConnections // command. // // Returns awserr.Error for service API and SDK errors. Use runtime type assertions @@ -39738,7 +39745,7 @@ func (c *EC2) ReleaseAddressRequest(input *ReleaseAddressInput) (req *request.Re // Be sure to update your DNS records and any servers or devices that communicate // with the address. If you attempt to release an Elastic IP address that you // already released, you'll get an AuthFailure error if the address is already -// allocated to another account. +// allocated to another Amazon Web Services account. // // [EC2-VPC] After you release an Elastic IP address for use in a VPC, you might // be able to recover it. For more information, see AllocateAddress. @@ -43872,7 +43879,7 @@ type Address struct { // The ID of the network interface. NetworkInterfaceId *string `locationName:"networkInterfaceId" type:"string"` - // The ID of the account that owns the network interface. + // The ID of the Amazon Web Services account that owns the network interface. NetworkInterfaceOwnerId *string `locationName:"networkInterfaceOwnerId" type:"string"` // The private IP address associated with the Elastic IP address. @@ -49121,7 +49128,7 @@ type CapacityReservation struct { // was created. OutpostArn *string `locationName:"outpostArn" type:"string"` - // The ID of the account that owns the Capacity Reservation. + // The ID of the Amazon Web Services account that owns the Capacity Reservation. OwnerId *string `locationName:"ownerId" type:"string"` // The date and time at which the Capacity Reservation was started. @@ -49155,10 +49162,10 @@ type CapacityReservation struct { // can have one of the following tenancy settings: // // * default - The Capacity Reservation is created on hardware that is shared - // with other accounts. + // with other Amazon Web Services accounts. // // * dedicated - The Capacity Reservation is created on single-tenant hardware - // that is dedicated to a single account. + // that is dedicated to a single Amazon Web Services account. Tenancy *string `locationName:"tenancy" type:"string" enum:"CapacityReservationTenancy"` // The total number of instances for which the Capacity Reservation reserves @@ -49303,7 +49310,7 @@ type CapacityReservationGroup struct { // The ARN of the resource group. GroupArn *string `locationName:"groupArn" type:"string"` - // The ID of the account that owns the resource group. + // The ID of the Amazon Web Services account that owns the resource group. OwnerId *string `locationName:"ownerId" type:"string"` } @@ -49588,7 +49595,7 @@ type CarrierGateway struct { // The ID of the carrier gateway. CarrierGatewayId *string `locationName:"carrierGatewayId" type:"string"` - // The account ID of the owner of the carrier gateway. + // The Amazon Web Services account ID of the owner of the carrier gateway. OwnerId *string `locationName:"ownerId" type:"string"` // The state of the carrier gateway. @@ -49691,8 +49698,8 @@ func (s *CertificateAuthenticationRequest) SetClientRootCertificateChainArn(v st } // Provides authorization for Amazon to bring a specific IP address range to -// a specific account using bring your own IP addresses (BYOIP). For more information, -// see Configuring your BYOIP address range (https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-byoip.html#prepare-for-byoip) +// a specific Amazon Web Services account using bring your own IP addresses +// (BYOIP). For more information, see Configuring your BYOIP address range (https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-byoip.html#prepare-for-byoip) // in the Amazon Elastic Compute Cloud User Guide. type CidrAuthorizationContext struct { _ struct{} `type:"structure"` @@ -50982,8 +50989,8 @@ func (s *ConfirmProductInstanceInput) SetProductCode(v string) *ConfirmProductIn type ConfirmProductInstanceOutput struct { _ struct{} `type:"structure"` - // The account ID of the instance owner. This is only present if the product - // code is attached to the instance. + // The Amazon Web Services account ID of the instance owner. This is only present + // if the product code is attached to the instance. OwnerId *string `locationName:"ownerId" type:"string"` // The return value of the request. Returns true if the specified product code @@ -51936,10 +51943,10 @@ type CreateCapacityReservationInput struct { // can have one of the following tenancy settings: // // * default - The Capacity Reservation is created on hardware that is shared - // with other accounts. + // with other Amazon Web Services accounts. // // * dedicated - The Capacity Reservation is created on single-tenant hardware - // that is dedicated to a single account. + // that is dedicated to a single Amazon Web Services account. Tenancy *string `type:"string" enum:"CapacityReservationTenancy"` } @@ -55697,7 +55704,7 @@ func (s *CreateNetworkInterfaceOutput) SetNetworkInterface(v *NetworkInterface) type CreateNetworkInterfacePermissionInput struct { _ struct{} `type:"structure"` - // The account ID. + // The Amazon Web Services account ID. AwsAccountId *string `type:"string"` // The Amazon Web Service. Currently not supported. @@ -59280,7 +59287,7 @@ type CreateVolumePermission struct { // The group to be added or removed. The possible value is all. Group *string `locationName:"group" type:"string" enum:"PermissionGroup"` - // The ID of the account to be added or removed. + // The ID of the Amazon Web Services account to be added or removed. UserId *string `locationName:"userId" type:"string"` } @@ -59310,10 +59317,10 @@ func (s *CreateVolumePermission) SetUserId(v string) *CreateVolumePermission { type CreateVolumePermissionModifications struct { _ struct{} `type:"structure"` - // Adds the specified account ID or group to the list. + // Adds the specified Amazon Web Services account ID or group to the list. Add []*CreateVolumePermission `locationNameList:"item" type:"list"` - // Removes the specified account ID or group from the list. + // Removes the specified Amazon Web Services account ID or group from the list. Remove []*CreateVolumePermission `locationNameList:"item" type:"list"` } @@ -59930,9 +59937,9 @@ type CreateVpcPeeringConnectionInput struct { // it is UnauthorizedOperation. DryRun *bool `locationName:"dryRun" type:"boolean"` - // The account ID of the owner of the accepter VPC. + // The Amazon Web Services account ID of the owner of the accepter VPC. // - // Default: Your account ID + // Default: Your Amazon Web Services account ID PeerOwnerId *string `locationName:"peerOwnerId" type:"string"` // The Region code for the accepter VPC, if the accepter VPC is located in a @@ -65425,7 +65432,8 @@ type DescribeAddressesInput struct { // * network-interface-id - [EC2-VPC] The ID of the network interface that // the address is associated with, if any. // - // * network-interface-owner-id - The account ID of the owner. + // * network-interface-owner-id - The Amazon Web Services account ID of the + // owner. // // * private-ip-address - [EC2-VPC] The private IP address associated with // the Elastic IP address. @@ -65891,7 +65899,8 @@ type DescribeCapacityReservationsInput struct { // * instance-type - The type of instance for which the Capacity Reservation // reserves capacity. // - // * owner-id - The ID of the account that owns the Capacity Reservation. + // * owner-id - The ID of the Amazon Web Services account that owns the Capacity + // Reservation. // // * availability-zone-id - The Availability Zone ID of the Capacity Reservation. // @@ -65903,8 +65912,9 @@ type DescribeCapacityReservationsInput struct { // * tenancy - Indicates the tenancy of the Capacity Reservation. A Capacity // Reservation can have one of the following tenancy settings: default - // The Capacity Reservation is created on hardware that is shared with other - // accounts. dedicated - The Capacity Reservation is created on single-tenant - // hardware that is dedicated to a single account. + // Amazon Web Services accounts. dedicated - The Capacity Reservation is + // created on single-tenant hardware that is dedicated to a single Amazon + // Web Services account. // // * outpost-arn - The Amazon Resource Name (ARN) of the Outpost on which // the Capacity Reservation was created. @@ -66061,7 +66071,8 @@ type DescribeCarrierGatewaysInput struct { // * state - The state of the carrier gateway (pending | failed | available // | deleting | deleted). // - // * owner-id - The account ID of the owner of the carrier gateway. + // * owner-id - The Amazon Web Services account ID of the owner of the carrier + // gateway. // // * tag: