The identifier for the Amazon Machine Image (AMI) that's used to create the EC2 instance. You can specify the AMI for the instance using an AMI alias or an AWS Systems Manager (SSM) path. The default AMI is used if the parameter isn't explicitly assigned a value in the request.
AMI aliases
Amazon Linux 2: amazonlinux-2-x86_64
Ubuntu 18.04: ubuntu-18.04-x86_64
Amazon Linux (default): amazonlinux-1-x86_64
SSM paths
Amazon Linux 2: resolve:ssm:/aws/service/cloud9/amis/amazonlinux-2-x86_64
Ubuntu 18.04: resolve:ssm:/aws/service/cloud9/amis/ubuntu-18.04-x86_64
Amazon Linux (default): resolve:ssm:/aws/service/cloud9/amis/amazonlinux-1-x86_64
The identifier for the Amazon Machine Image (AMI) that's used to create the EC2 instance. To choose an AMI for the instance, you must specify a valid AMI alias or a valid AWS Systems Manager (SSM) path.
The default AMI is used if the parameter isn't explicitly assigned a value in the request.
AMI aliases
Amazon Linux (default): amazonlinux-1-x86_64
Amazon Linux 2: amazonlinux-2-x86_64
Ubuntu 18.04: ubuntu-18.04-x86_64
SSM paths
Amazon Linux (default): resolve:ssm:/aws/service/cloud9/amis/amazonlinux-1-x86_64
Amazon Linux 2: resolve:ssm:/aws/service/cloud9/amis/amazonlinux-2-x86_64
Ubuntu 18.04: resolve:ssm:/aws/service/cloud9/amis/ubuntu-18.04-x86_64
Cancels one or more Spot Instance requests.
Canceling a Spot Instance request does not terminate running Spot Instances associated with the request.
Determines whether a product code is associated with an instance. This action can only be used by the owner of the product code. It is useful when a product code owner must verify whether another user's instance is eligible for support.
", "CopyFpgaImage": "Copies the specified Amazon FPGA Image (AFI) to the current Region.
", - "CopyImage": "Initiates the copy of an AMI. You can copy an AMI from one Region to another, or from a Region to an AWS Outpost. You can't copy an AMI from an Outpost to a Region, from one Outpost to another, or within the same Outpost.
To copy an AMI from one Region to another, specify the source Region using the SourceRegion parameter, and specify the destination Region using its endpoint. Copies of encrypted backing snapshots for the AMI are encrypted. Copies of unencrypted backing snapshots remain unencrypted, unless you set Encrypted during the copy operation. You cannot create an unencrypted copy of an encrypted backing snapshot.
To copy an AMI from a Region to an Outpost, specify the source Region using the SourceRegion parameter, and specify the ARN of the destination Outpost using DestinationOutpostArn. Backing snapshots copied to an Outpost are encrypted by default using the default encryption key for the Region, or a different key that you specify in the request using KmsKeyId. Outposts do not support unencrypted snapshots. For more information, Amazon EBS local snapshots on Outposts in the Amazon Elastic Compute Cloud User Guide.
For more information about the prerequisites and limits when copying an AMI, see Copying an AMI in the Amazon Elastic Compute Cloud User Guide.
", + "CopyImage": "Initiates the copy of an AMI. You can copy an AMI from one Region to another, or from a Region to an AWS Outpost. You can't copy an AMI from an Outpost to a Region, from one Outpost to another, or within the same Outpost. To copy an AMI to another partition, see CreateStoreImageTask.
To copy an AMI from one Region to another, specify the source Region using the SourceRegion parameter, and specify the destination Region using its endpoint. Copies of encrypted backing snapshots for the AMI are encrypted. Copies of unencrypted backing snapshots remain unencrypted, unless you set Encrypted during the copy operation. You cannot create an unencrypted copy of an encrypted backing snapshot.
To copy an AMI from a Region to an Outpost, specify the source Region using the SourceRegion parameter, and specify the ARN of the destination Outpost using DestinationOutpostArn. Backing snapshots copied to an Outpost are encrypted by default using the default encryption key for the Region, or a different key that you specify in the request using KmsKeyId. Outposts do not support unencrypted snapshots. For more information, Amazon EBS local snapshots on Outposts in the Amazon Elastic Compute Cloud User Guide.
For more information about the prerequisites and limits when copying an AMI, see Copying an AMI in the Amazon Elastic Compute Cloud User Guide.
", "CopySnapshot": "Copies a point-in-time snapshot of an EBS volume and stores it in Amazon S3. You can copy a snapshot within the same Region, from one Region to another, or from a Region to an Outpost. You can't copy a snapshot from an Outpost to a Region, from one Outpost to another, or within the same Outpost.
You can use the snapshot to create EBS volumes or Amazon Machine Images (AMIs).
When copying snapshots to a Region, copies of encrypted EBS snapshots remain encrypted. Copies of unencrypted snapshots remain unencrypted, unless you enable encryption for the snapshot copy operation. By default, encrypted snapshot copies use the default AWS Key Management Service (AWS KMS) customer master key (CMK); however, you can specify a different CMK. To copy an encrypted snapshot that has been shared from another account, you must have permissions for the CMK used to encrypt the snapshot.
Snapshots copied to an Outpost are encrypted by default using the default encryption key for the Region, or a different key that you specify in the request using KmsKeyId. Outposts do not support unencrypted snapshots. For more information, Amazon EBS local snapshots on Outposts in the Amazon Elastic Compute Cloud User Guide.
Snapshots created by copying another snapshot have an arbitrary volume ID that should not be used for any purpose.
For more information, see Copying an Amazon EBS snapshot in the Amazon Elastic Compute Cloud User Guide.
", "CreateCapacityReservation": "Creates a new Capacity Reservation with the specified attributes.
Capacity Reservations enable you to reserve capacity for your Amazon EC2 instances in a specific Availability Zone for any duration. This gives you the flexibility to selectively add capacity reservations and still get the Regional RI discounts for that usage. By creating Capacity Reservations, you ensure that you always have access to Amazon EC2 capacity when you need it, for as long as you need it. For more information, see Capacity Reservations in the Amazon EC2 User Guide.
Your request to create a Capacity Reservation could fail if Amazon EC2 does not have sufficient capacity to fulfill the request. If your request fails due to Amazon EC2 capacity constraints, either try again at a later time, try in a different Availability Zone, or request a smaller capacity reservation. If your application is flexible across instance types and sizes, try to create a Capacity Reservation with different instance attributes.
Your request could also fail if the requested quantity exceeds your On-Demand Instance limit for the selected instance type. If your request fails due to limit constraints, increase your On-Demand Instance limit for the required instance type and try again. For more information about increasing your instance limits, see Amazon EC2 Service Quotas in the Amazon EC2 User Guide.
", "CreateCarrierGateway": "Creates a carrier gateway. For more information about carrier gateways, see Carrier gateways in the AWS Wavelength Developer Guide.
", @@ -75,12 +75,14 @@ "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.
", + "CreateRestoreImageTask": "Starts a task that restores an AMI from an S3 object that was previously created by using CreateStoreImageTask.
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.
", "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 AWS 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 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 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 Tagging 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 AWS 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.
AWS 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.
", "CreateTags": "Adds or overwrites only the specified tags for the specified Amazon EC2 resource or resources. When you specify an existing tag key, the value is overwritten with the new value. Each resource can have a maximum of 50 tags. Each tag consists of a key and optional value. Tag keys must be unique per resource.
For more information about tags, see Tagging Your Resources in the Amazon Elastic Compute Cloud User Guide. For more information about creating IAM policies that control users' access to resources based on tags, see Supported Resource-Level Permissions for Amazon EC2 API Actions in the Amazon Elastic Compute Cloud User Guide.
", "CreateTrafficMirrorFilter": "Creates a Traffic Mirror filter.
A Traffic Mirror filter is a set of rules that defines the traffic to mirror.
By default, no traffic is mirrored. To mirror traffic, use CreateTrafficMirrorFilterRule to add Traffic Mirror rules to the filter. The rules you add define what traffic gets mirrored. You can also use ModifyTrafficMirrorFilterNetworkServices to mirror supported network services.
", @@ -255,6 +257,7 @@ "DescribeSpotInstanceRequests": "Describes the specified Spot Instance requests.
You can use DescribeSpotInstanceRequests to find a running Spot Instance by examining the response. If the status of the Spot Instance is fulfilled, the instance ID appears in the response and contains the identifier of the instance. Alternatively, you can use DescribeInstances with a filter to look for instances where the instance lifecycle is spot.
We recommend that you set MaxResults to a value between 5 and 1000 to limit the number of results returned. This paginates the output, which makes the list more manageable and returns the results faster. 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 DescribeSpotInstanceRequests request to retrieve the remaining results.
Spot Instance requests are deleted four hours after they are canceled and their instances are terminated.
", "DescribeSpotPriceHistory": "Describes the Spot price history. For more information, see Spot Instance pricing history in the Amazon EC2 User Guide for Linux Instances.
When you specify a start and end time, this operation returns the prices of the instance types within the time range that you specified and the time when the price changed. The price is valid within the time period that you specified; the response merely indicates the last time that the price changed.
", "DescribeStaleSecurityGroups": "[VPC only] Describes the stale security group rules for security groups in a specified VPC. Rules are stale when they reference a deleted security group in a peer VPC, or a security group in a peer VPC for which the VPC peering connection has been deleted.
", + "DescribeStoreImageTasks": "Describes the progress of the AMI store tasks. You can describe the store tasks for specified AMIs. If you don't specify the AMIs, you get a paginated list of store tasks from the last 31 days.
For each AMI task, the response indicates if the task is InProgress, Completed, or Failed. For tasks InProgress, the response shows the estimated progress as a percentage.
Tasks are listed in reverse chronological order. Currently, only tasks from the past 31 days can be viewed.
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.
", "DescribeSubnets": "Describes one or more of your subnets.
For more information, see Your VPC and Subnets in the Amazon Virtual Private Cloud User Guide.
", "DescribeTags": "Describes the specified tags for your EC2 resources.
For more information about tags, see Tagging Your Resources in the Amazon Elastic Compute Cloud User Guide.
", "DescribeTrafficMirrorFilters": "Describes one or more Traffic Mirror filters.
", @@ -1436,6 +1439,7 @@ "CreateNetworkInterfaceRequest$DryRun": "Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.
Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.
Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.
Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.
Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.
Returns true if the request succeeds; otherwise, it returns an error.
Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.
Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.
Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.
Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.
Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.
Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.
Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.
Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.
Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.
Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.
Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.
Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.
Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.
Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.
Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.
The maximum number of results to return in a single call. To retrieve the remaining results, make another call with the returned NextToken value. This value can be between 1 and 200. You cannot specify this parameter and the ImageIDs parameter in the same call.
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 AWS account alias set using the IAM console. We recommend that you use the related parameter instead of this filter.
owner-id - The AWS 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, sc1for 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 AWS 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.
The ID of the AMI.
", "DeregisterImageRequest$ImageId": "The ID of the AMI.
", "DescribeImageAttributeRequest$ImageId": "The ID of the AMI.
", "ExportImageRequest$ImageId": "The ID of the image.
", + "ImageIdList$member": null, "ImageIdStringList$member": null, "ModifyImageAttributeRequest$ImageId": "The ID of the AMI.
", "RequestLaunchTemplateData$ImageId": "The ID of the AMI.
", @@ -7839,6 +7884,12 @@ "ScheduledInstancesLaunchSpecification$ImageId": "The ID of the Amazon Machine Image (AMI).
" } }, + "ImageIdList": { + "base": null, + "refs": { + "DescribeStoreImageTasksRequest$ImageIds": "The AMI IDs for which to show progress. Up to 20 AMI IDs can be included in a request.
" + } + }, "ImageIdStringList": { "base": null, "refs": { @@ -8820,6 +8871,7 @@ "SpotOptionsRequest$MinTargetCapacity": "The minimum target capacity for Spot Instances in the fleet. If the minimum target capacity is not reached, the fleet launches no instances.
", "StaleIpPermission$FromPort": "The start of the port range for the TCP and UDP protocols, or an ICMP type number. A value of -1 indicates all ICMP types.
The end of the port range for the TCP and UDP protocols, or an ICMP type number. A value of -1 indicates all ICMP types.
The progress of the task as a percentage.
", "Subnet$AvailableIpAddressCount": "The number of unused private IPv4 addresses in the subnet. The IPv4 addresses for any stopped instances are considered unavailable.
", "TargetCapacitySpecification$TotalTargetCapacity": "The number of units to request, filled using DefaultTargetCapacityType.
The number of On-Demand units to request. If you specify a target capacity for Spot units, you cannot specify a target capacity for On-Demand units.
", @@ -10040,6 +10092,7 @@ "NetworkInsightsPath$CreatedDate": "The time stamp when the path was created.
", "SnapshotInfo$StartTime": "Time this snapshot was started. This is the same for all snapshots initiated by the same request.
", "SpotFleetRequestConfig$CreateTime": "The creation date and time of the request.
", + "StoreImageTaskResult$TaskStartTime": "The time the task started.
", "VolumeStatusEvent$NotAfter": "The latest end time of the event.
", "VolumeStatusEvent$NotBefore": "The earliest start time of the event.
", "VpcEndpoint$CreationTimestamp": "The date and time that the VPC endpoint was created.
", @@ -12664,6 +12717,18 @@ "refs": { } }, + "S3ObjectTag": { + "base": "The tags to apply to the AMI object that will be stored in the S3 bucket. For more information, see Categorizing your storage using tags in the Amazon Simple Storage Service User Guide.
", + "refs": { + "S3ObjectTagList$member": null + } + }, + "S3ObjectTagList": { + "base": null, + "refs": { + "CreateStoreImageTaskRequest$S3ObjectTags": "The tags to apply to the AMI object that will be stored in the S3 bucket.
" + } + }, "S3Storage": { "base": "Describes the storage parameters for S3 and S3 buckets for an instance store-backed AMI.
", "refs": { @@ -13393,6 +13458,18 @@ "CreateFpgaImageRequest$LogsStorageLocation": "The location in Amazon S3 for the output logs.
" } }, + "StoreImageTaskResult": { + "base": "The information about the AMI store task, including the progress of the task.
", + "refs": { + "StoreImageTaskResultSet$member": null + } + }, + "StoreImageTaskResultSet": { + "base": null, + "refs": { + "DescribeStoreImageTasksResult$StoreImageTaskResults": "The information about the AMI store tasks.
" + } + }, "String": { "base": null, "refs": { @@ -13684,6 +13761,10 @@ "CreatePlacementGroupRequest$GroupName": "A name for the placement group. Must be unique within the scope of your account for the Region.
Constraints: Up to 255 ASCII characters
", "CreateReplaceRootVolumeTaskRequest$ClientToken": "Unique, case-sensitive identifier you provide to ensure the idempotency of the request. If you do not specify a client token, a randomly generated token is used for the request to ensure idempotency. For more information, see Ensuring Idempotency.
", "CreateReservedInstancesListingRequest$ClientToken": "Unique, case-sensitive identifier you provide to ensure idempotency of your listings. This helps avoid duplicate listings. For more information, see Ensuring Idempotency.
", + "CreateRestoreImageTaskRequest$Bucket": "The name of the S3 bucket that contains the stored AMI object.
", + "CreateRestoreImageTaskRequest$ObjectKey": "The name of the stored AMI object in the bucket.
", + "CreateRestoreImageTaskRequest$Name": "The name for the restored AMI. The name must be unique for AMIs in the Region for this account. If you do not provide a name, the new AMI gets the same name as the original AMI.
", + "CreateRestoreImageTaskResult$ImageId": "The AMI ID.
", "CreateRouteRequest$DestinationCidrBlock": "The IPv4 CIDR address block used for the destination match. Routing decisions are based on the most specific match. 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 IPv6 CIDR block used for the destination match. Routing decisions are based on the most specific match.
", "CreateSecurityGroupRequest$Description": "A description for the security group. This is informational only.
Constraints: Up to 255 characters in length
Constraints for EC2-Classic: ASCII characters
Constraints for EC2-VPC: a-z, A-Z, 0-9, spaces, and ._-:/()#,@[]+=&;{}!$*
", @@ -13695,6 +13776,8 @@ "CreateSnapshotsRequest$OutpostArn": "The Amazon Resource Name (ARN) of the AWS Outpost on which to create the local snapshots.
To create snapshots from an instance in a Region, omit this parameter. The snapshots are created in the same Region as the instance.
To create snapshots from an instance on an Outpost and store the snapshots in the Region, omit this parameter. The snapshots are created in the Region for the Outpost.
To create snapshots from an instance on an Outpost and store the snapshots on an Outpost, specify the ARN of the destination Outpost. The snapshots must be created on the same Outpost as the instance.
For more information, see Creating multi-volume local snapshots from instances on an Outpost in the Amazon Elastic Compute Cloud User Guide.
", "CreateSpotDatafeedSubscriptionRequest$Bucket": "The name of the Amazon S3 bucket in which to store the Spot Instance data feed. For more information about bucket names, see Rules for bucket naming in the Amazon S3 Developer Guide.
", "CreateSpotDatafeedSubscriptionRequest$Prefix": "The prefix for the data feed file names.
", + "CreateStoreImageTaskRequest$Bucket": "The name of the S3 bucket in which the AMI object will be stored. The bucket must be in the Region in which the request is being made. The AMI object appears in the bucket only after the upload task has completed.
", + "CreateStoreImageTaskResult$ObjectKey": "The name of the stored AMI object in the S3 bucket.
", "CreateSubnetRequest$AvailabilityZone": "The Availability Zone or Local Zone for the subnet.
Default: AWS selects one for you. If you create more than one subnet in your VPC, we do not necessarily select a different zone for each subnet.
To create a subnet in a Local Zone, set this value to the Local Zone ID, for example us-west-2-lax-1a. For information about the Regions that support Local Zones, see Available Regions in the Amazon Elastic Compute Cloud User Guide.
To create a subnet in an Outpost, set this value to the Availability Zone for the Outpost and specify the Outpost ARN.
", "CreateSubnetRequest$AvailabilityZoneId": "The AZ ID or the Local Zone ID of the subnet.
", "CreateSubnetRequest$CidrBlock": "The IPv4 network range for the subnet, in CIDR notation. For example, 10.0.0.0/24. 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 token for the next set of results.
", "DescribeSpotPriceHistoryResult$NextToken": "The token required to retrieve the next set of results. This value is null or an empty string when there are no more results to return.
", "DescribeStaleSecurityGroupsResult$NextToken": "The token to use when requesting the next set of items. If there are no additional items to return, the string is empty.
", + "DescribeStoreImageTasksRequest$NextToken": "The token for the next page of results.
", + "DescribeStoreImageTasksResult$NextToken": "The token to use to retrieve the next page of results. This value is null when there are no more results to return.
The token for the next page of results.
", "DescribeSubnetsResult$NextToken": "The token to use to retrieve the next page of results. This value is null when there are no more results to return.
The token to retrieve the next page of results.
", @@ -14650,6 +14735,8 @@ "RunInstancesRequest$ClientToken": "Unique, case-sensitive identifier you provide to ensure the idempotency of the request. If you do not specify a client token, a randomly generated token is used for the request to ensure idempotency.
For more information, see Ensuring Idempotency.
Constraints: Maximum 64 ASCII characters
", "RunInstancesRequest$PrivateIpAddress": "[EC2-VPC] The primary IPv4 address. You must specify a value from the IPv4 address range of the subnet.
Only one private IP address can be designated as primary. You can't specify this option if you've specified the option to designate a private IP address as the primary IP address in a network interface specification. You cannot specify this option if you're launching more than one instance in the request.
You cannot specify this option and the network interfaces option in the same request.
", "RunScheduledInstancesRequest$ClientToken": "Unique, case-sensitive identifier that ensures the idempotency of the request. For more information, see Ensuring Idempotency.
", + "S3ObjectTag$Key": "The key of the tag.
Constraints: Tag keys are case-sensitive and can be up to 128 Unicode characters in length. May not begin with aws:.
The value of the tag.
Constraints: Tag values are case-sensitive and can be up to 256 Unicode characters in length.
", "S3Storage$AWSAccessKeyId": "The access key ID of the owner of the bucket. Before you specify a value for your access key ID, review and follow the guidance in Best Practices for Managing AWS Access Keys.
", "S3Storage$Bucket": "The bucket in which to store the AMI. You can specify a bucket that you already own or a new bucket that Amazon EC2 creates on your behalf. If you specify a bucket that belongs to someone else, Amazon EC2 returns an error.
", "S3Storage$Prefix": "The beginning of the file name of the AMI.
", @@ -14783,6 +14870,11 @@ "StateReason$Message": "The message for the state change.
Server.InsufficientInstanceCapacity: There was insufficient capacity available to satisfy the launch request.
Server.InternalError: An internal error caused the instance to terminate during launch.
Server.ScheduledStop: The instance was stopped due to a scheduled retirement.
Server.SpotInstanceShutdown: The instance was stopped because the number of Spot requests with a maximum price equal to or higher than the Spot price exceeded available capacity or because of an increase in the Spot price.
Server.SpotInstanceTermination: The instance was terminated because the number of Spot requests with a maximum price equal to or higher than the Spot price exceeded available capacity or because of an increase in the Spot price.
Client.InstanceInitiatedShutdown: The instance was shut down using the shutdown -h command from the instance.
Client.InstanceTerminated: The instance was terminated or rebooted during AMI creation.
Client.InternalError: A client error caused the instance to terminate during launch.
Client.InvalidSnapshot.NotFound: The specified snapshot was not found.
Client.UserInitiatedHibernate: Hibernation was initiated on the instance.
Client.UserInitiatedShutdown: The instance was shut down using the Amazon EC2 API.
Client.VolumeLimitExceeded: The limit on the number of EBS volumes or total storage was exceeded. Decrease usage or request an increase in your account limits.
The name of the S3 bucket.
", "StorageLocation$Key": "The key.
", + "StoreImageTaskResult$AmiId": "The ID of the AMI that is being stored.
", + "StoreImageTaskResult$Bucket": "The name of the S3 bucket that contains the stored AMI object.
", + "StoreImageTaskResult$S3objectKey": "The name of the stored AMI object in the bucket.
", + "StoreImageTaskResult$StoreTaskState": "The state of the store task (InProgress, Completed, or Failed).
If the tasks fails, the reason for the failure is returned. If the task succeeds, null is returned.
The Availability Zone of the subnet.
", "Subnet$AvailabilityZoneId": "The AZ ID of the subnet.
", @@ -15276,6 +15368,7 @@ "CreateNetworkInterfaceRequest$TagSpecifications": "The tags to apply to the new network interface.
", "CreatePlacementGroupRequest$TagSpecifications": "The tags to apply to the new placement group.
", "CreateReplaceRootVolumeTaskRequest$TagSpecifications": "The tags to apply to the root volume replacement task.
", + "CreateRestoreImageTaskRequest$TagSpecifications": "The tags to apply to the AMI and snapshots on restoration. You can tag the AMI, the snapshots, or both.
To tag the AMI, the value for ResourceType must be image.
To tag the snapshots, the value for ResourceType must be snapshot. The same tag is applied to all of the snapshots that are created.
The tags to assign to the route table.
", "CreateSecurityGroupRequest$TagSpecifications": "The tags to assign to the security group.
", "CreateSnapshotRequest$TagSpecifications": "The tags to apply to the snapshot during creation.
", diff --git a/models/apis/medialive/2017-10-14/api-2.json b/models/apis/medialive/2017-10-14/api-2.json index 3107841a58..fcaeed62c9 100644 --- a/models/apis/medialive/2017-10-14/api-2.json +++ b/models/apis/medialive/2017-10-14/api-2.json @@ -3574,7 +3574,7 @@ "locationName": "tags" }, "Vpc": { - "shape": "VpcOutputSettings", + "shape": "VpcOutputSettingsDescription", "locationName": "vpc" } } @@ -3684,7 +3684,7 @@ "locationName": "tags" }, "Vpc": { - "shape": "VpcOutputSettings", + "shape": "VpcOutputSettingsDescription", "locationName": "vpc" } } @@ -4296,7 +4296,7 @@ "locationName": "tags" }, "Vpc": { - "shape": "VpcOutputSettings", + "shape": "VpcOutputSettingsDescription", "locationName": "vpc" } } @@ -4647,7 +4647,7 @@ "locationName": "tags" }, "Vpc": { - "shape": "VpcOutputSettings", + "shape": "VpcOutputSettingsDescription", "locationName": "vpc" } } @@ -5600,6 +5600,10 @@ "shape": "EbuTtDFillLineGapControl", "locationName": "fillLineGap" }, + "CopyrightHolder": { + "shape": "__stringMax1000", + "locationName": "copyrightHolder" + }, "FontFamily": { "shape": "__string", "locationName": "fontFamily" @@ -11272,7 +11276,7 @@ "locationName": "tags" }, "Vpc": { - "shape": "VpcOutputSettings", + "shape": "VpcOutputSettingsDescription", "locationName": "vpc" } } @@ -11502,7 +11506,7 @@ "locationName": "tags" }, "Vpc": { - "shape": "VpcOutputSettings", + "shape": "VpcOutputSettingsDescription", "locationName": "vpc" } } @@ -11765,6 +11769,10 @@ "shape": "__string", "locationName": "targetCustomerId" }, + "TargetRegion": { + "shape": "__string", + "locationName": "targetRegion" + }, "TransferType": { "shape": "InputDeviceTransferType", "locationName": "transferType" @@ -12578,6 +12586,27 @@ "SubnetIds" ] }, + "VpcOutputSettingsDescription": { + "type": "structure", + "members": { + "AvailabilityZones": { + "shape": "__listOf__string", + "locationName": "availabilityZones" + }, + "NetworkInterfaceIds": { + "shape": "__listOf__string", + "locationName": "networkInterfaceIds" + }, + "SecurityGroupIds": { + "shape": "__listOf__string", + "locationName": "securityGroupIds" + }, + "SubnetIds": { + "shape": "__listOf__string", + "locationName": "subnetIds" + } + } + }, "WavCodingMode": { "type": "string", "enum": [ diff --git a/models/apis/medialive/2017-10-14/docs-2.json b/models/apis/medialive/2017-10-14/docs-2.json index 49b260296c..6f6b026f11 100644 --- a/models/apis/medialive/2017-10-14/docs-2.json +++ b/models/apis/medialive/2017-10-14/docs-2.json @@ -3276,11 +3276,16 @@ "VpcOutputSettings": { "base": "The properties for a private VPC Output\nWhen this property is specified, the output egress addresses will be created in a user specified VPC\n", "refs": { - "Channel$Vpc": "Settings for VPC output", - "ChannelSummary$Vpc": "Settings for VPC output", "CreateChannel$Vpc": "Settings for VPC output" } }, + "VpcOutputSettingsDescription": { + "base": "The properties for a private VPC Output\n", + "refs": { + "Channel$Vpc": "Settings for VPC output", + "ChannelSummary$Vpc": "Settings for VPC output" + } + }, "WavCodingMode": { "base": "Wav Coding Mode", "refs": { @@ -4159,7 +4164,11 @@ "UpdateInput$InputSecurityGroups": "A list of security groups referenced by IDs to attach to the input.", "VpcOutputSettings$PublicAddressAllocationIds": "List of public address allocation ids to associate with ENIs that will be created in Output VPC.\nMust specify one for SINGLE_PIPELINE, two for STANDARD channels\n", "VpcOutputSettings$SecurityGroupIds": "A list of up to 5 EC2 VPC security group IDs to attach to the Output VPC network interfaces.\nIf none are specified then the VPC default security group will be used\n", - "VpcOutputSettings$SubnetIds": "A list of VPC subnet IDs from the same VPC.\nIf STANDARD channel, subnet IDs must be mapped to two unique availability zones (AZ).\n" + "VpcOutputSettings$SubnetIds": "A list of VPC subnet IDs from the same VPC.\nIf STANDARD channel, subnet IDs must be mapped to two unique availability zones (AZ).\n", + "VpcOutputSettingsDescription$AvailabilityZones": "The Availability Zones where the vpc subnets are located.\nThe first Availability Zone applies to the first subnet in the list of subnets.\nThe second Availability Zone applies to the second subnet.\n", + "VpcOutputSettingsDescription$NetworkInterfaceIds": "A list of Elastic Network Interfaces created by MediaLive in the customer's VPC\n", + "VpcOutputSettingsDescription$SecurityGroupIds": "A list of up EC2 VPC security group IDs attached to the Output VPC network interfaces.\n", + "VpcOutputSettingsDescription$SubnetIds": "A list of VPC subnet IDs from the same VPC.\nIf STANDARD channel, subnet IDs must be mapped to two unique availability zones (AZ).\n" } }, "__longMin0Max1099511627775": { diff --git a/models/apis/ssm/2014-11-06/api-2.json b/models/apis/ssm/2014-11-06/api-2.json index 6e89217f45..7796190b79 100644 --- a/models/apis/ssm/2014-11-06/api-2.json +++ b/models/apis/ssm/2014-11-06/api-2.json @@ -1719,6 +1719,21 @@ {"shape":"InternalServerError"} ] }, + "UnlabelParameterVersion":{ + "name":"UnlabelParameterVersion", + "http":{ + "method":"POST", + "requestUri":"/" + }, + "input":{"shape":"UnlabelParameterVersionRequest"}, + "output":{"shape":"UnlabelParameterVersionResult"}, + "errors":[ + {"shape":"InternalServerError"}, + {"shape":"TooManyUpdates"}, + {"shape":"ParameterNotFound"}, + {"shape":"ParameterVersionNotFound"} + ] + }, "UpdateAssociation":{ "name":"UpdateAssociation", "http":{ @@ -2762,6 +2777,11 @@ "WindowExecutionId":{"shape":"MaintenanceWindowExecutionId"} } }, + "ChangeDetailsValue":{ + "type":"string", + "max":32768, + "min":1 + }, "ChangeRequestName":{ "type":"string", "max":1024, @@ -4208,6 +4228,18 @@ "InstancesWithUnreportedNotApplicablePatches":{ "shape":"Integer", "box":true + }, + "InstancesWithCriticalNonCompliantPatches":{ + "shape":"InstancesCount", + "box":true + }, + "InstancesWithSecurityNonCompliantPatches":{ + "shape":"InstancesCount", + "box":true + }, + "InstancesWithOtherNonCompliantPatches":{ + "shape":"InstancesCount", + "box":true } } }, @@ -5507,7 +5539,19 @@ "OperationEndTime":{"shape":"DateTime"}, "Operation":{"shape":"PatchOperationType"}, "LastNoRebootInstallOperationTime":{"shape":"DateTime"}, - "RebootOption":{"shape":"RebootOption"} + "RebootOption":{"shape":"RebootOption"}, + "CriticalNonCompliantCount":{ + "shape":"PatchCriticalNonCompliantCount", + "box":true + }, + "SecurityNonCompliantCount":{ + "shape":"PatchSecurityNonCompliantCount", + "box":true + }, + "OtherNonCompliantCount":{ + "shape":"PatchOtherNonCompliantCount", + "box":true + } } }, "InstancePatchStateFilter":{ @@ -8079,6 +8123,7 @@ "min":10 }, "PatchContentUrl":{"type":"string"}, + "PatchCriticalNonCompliantCount":{"type":"integer"}, "PatchDeploymentStatus":{ "type":"string", "enum":[ @@ -8231,6 +8276,7 @@ "type":"list", "member":{"shape":"PatchOrchestratorFilterValue"} }, + "PatchOtherNonCompliantCount":{"type":"integer"}, "PatchProduct":{"type":"string"}, "PatchProductFamily":{"type":"string"}, "PatchPropertiesList":{ @@ -8288,6 +8334,7 @@ "max":10, "min":0 }, + "PatchSecurityNonCompliantCount":{"type":"integer"}, "PatchSet":{ "type":"string", "enum":[ @@ -9327,7 +9374,9 @@ "ChangeRequestName":{"shape":"ChangeRequestName"}, "ClientToken":{"shape":"IdempotencyToken"}, "Runbooks":{"shape":"Runbooks"}, - "Tags":{"shape":"TagList"} + "Tags":{"shape":"TagList"}, + "ScheduledEndTime":{"shape":"DateTime"}, + "ChangeDetails":{"shape":"ChangeDetailsValue"} } }, "StartChangeRequestExecutionResult":{ @@ -9682,6 +9731,29 @@ "type":"string", "pattern":"[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}" }, + "UnlabelParameterVersionRequest":{ + "type":"structure", + "required":[ + "Name", + "ParameterVersion", + "Labels" + ], + "members":{ + "Name":{"shape":"PSParameterName"}, + "ParameterVersion":{ + "shape":"PSParameterVersion", + "box":true + }, + "Labels":{"shape":"ParameterLabelList"} + } + }, + "UnlabelParameterVersionResult":{ + "type":"structure", + "members":{ + "RemovedLabels":{"shape":"ParameterLabelList"}, + "InvalidLabels":{"shape":"ParameterLabelList"} + } + }, "UnsupportedCalendarException":{ "type":"structure", "members":{ diff --git a/models/apis/ssm/2014-11-06/docs-2.json b/models/apis/ssm/2014-11-06/docs-2.json index c4fd791198..81b4e332d3 100644 --- a/models/apis/ssm/2014-11-06/docs-2.json +++ b/models/apis/ssm/2014-11-06/docs-2.json @@ -62,7 +62,7 @@ "DescribeSessions": "Retrieves a list of all active sessions (both connected and disconnected) or terminated sessions from the past 30 days.
", "GetAutomationExecution": "Get detailed information about a particular Automation execution.
", "GetCalendarState": "Gets the state of the AWS Systems Manager Change Calendar at an optional, specified time. If you specify a time, GetCalendarState returns the state of the calendar at a specific time, and returns the next time that the Change Calendar state will transition. If you do not specify a time, GetCalendarState assumes the current time. Change Calendar entries have two possible states: OPEN or CLOSED.
If you specify more than one calendar in a request, the command returns the status of OPEN only if all calendars in the request are open. If one or more calendars in the request are closed, the status returned is CLOSED.
For more information about Systems Manager Change Calendar, see AWS Systems Manager Change Calendar in the AWS Systems Manager User Guide.
", - "GetCommandInvocation": "Returns detailed information about command execution for an invocation or plugin.
", + "GetCommandInvocation": "Returns detailed information about command execution for an invocation or plugin.
GetCommandInvocation only gives the execution status of a plugin in a document. To get the command execution status on a specific instance, use ListCommandInvocations. To get the command execution status across instances, use ListCommands.
Retrieves the Session Manager connection status for an instance to determine whether it is running and ready to receive Session Manager connections.
", "GetDefaultPatchBaseline": "Retrieves the default patch baseline. Note that Systems Manager supports creating multiple default patch baselines. For example, you can create a default patch baseline for each operating system.
If you do not specify an operating system value, the default patch baseline for Windows is returned.
", "GetDeployablePatchSnapshotForInstance": "Retrieves the current snapshot for the patch baseline the instance uses. This API is primarily used by the AWS-RunPatchBaseline Systems Manager document.
", @@ -84,7 +84,7 @@ "GetPatchBaseline": "Retrieves information about a patch baseline.
", "GetPatchBaselineForPatchGroup": "Retrieves the patch baseline that should be used for the specified patch group.
", "GetServiceSetting": " ServiceSetting is an account-level setting for an AWS service. This setting defines how a user interacts with or uses a service or a feature of a service. For example, if an AWS service charges money to the account based on feature or service usage, then the AWS service team might create a default setting of \"false\". This means the user can't use this feature unless they change the setting to \"true\" and intentionally opt in for a paid feature.
Services map a SettingId object to a setting value. AWS services teams define the default value for a SettingId. You can't create a new SettingId, but you can overwrite the default value if you have the ssm:UpdateServiceSetting permission for the setting. Use the UpdateServiceSetting API action to change the default setting. Or use the ResetServiceSetting to change the value back to the original value defined by the AWS service team.
Query the current service setting for the account.
", - "LabelParameterVersion": "A parameter label is a user-defined alias to help you manage different versions of a parameter. When you modify a parameter, Systems Manager automatically saves a new version and increments the version number by one. A label can help you remember the purpose of a parameter when there are multiple versions.
Parameter labels have the following requirements and restrictions.
A version of a parameter can have a maximum of 10 labels.
You can't attach the same label to different versions of the same parameter. For example, if version 1 has the label Production, then you can't attach Production to version 2.
You can move a label from one version of a parameter to another.
You can't create a label when you create a new parameter. You must attach a label to a specific version of a parameter.
You can't delete a parameter label. If you no longer want to use a parameter label, then you must move it to a different version of a parameter.
A label can have a maximum of 100 characters.
Labels can contain letters (case sensitive), numbers, periods (.), hyphens (-), or underscores (_).
Labels can't begin with a number, \"aws,\" or \"ssm\" (not case sensitive). If a label fails to meet these requirements, then the label is not associated with a parameter and the system displays it in the list of InvalidLabels.
A parameter label is a user-defined alias to help you manage different versions of a parameter. When you modify a parameter, Systems Manager automatically saves a new version and increments the version number by one. A label can help you remember the purpose of a parameter when there are multiple versions.
Parameter labels have the following requirements and restrictions.
A version of a parameter can have a maximum of 10 labels.
You can't attach the same label to different versions of the same parameter. For example, if version 1 has the label Production, then you can't attach Production to version 2.
You can move a label from one version of a parameter to another.
You can't create a label when you create a new parameter. You must attach a label to a specific version of a parameter.
If you no longer want to use a parameter label, then you can either delete it or move it to a different version of a parameter.
A label can have a maximum of 100 characters.
Labels can contain letters (case sensitive), numbers, periods (.), hyphens (-), or underscores (_).
Labels can't begin with a number, \"aws,\" or \"ssm\" (not case sensitive). If a label fails to meet these requirements, then the label is not associated with a parameter and the system displays it in the list of InvalidLabels.
Retrieves all versions of an association for a specific association ID.
", "ListAssociations": "Returns all State Manager associations in the current AWS account and Region. You can limit the results to a specific State Manager association document or instance by specifying a filter.
", "ListCommandInvocations": "An invocation is copy of a command sent to a specific instance. A command can apply to one or more instances. A command invocation applies to one instance. For example, if a user runs SendCommand against three instances, then a command invocation is created for each requested instance ID. ListCommandInvocations provide status about command execution.
", @@ -119,6 +119,7 @@ "StartSession": "Initiates a connection to a target (for example, an instance) for a Session Manager session. Returns a URL and token that can be used to open a WebSocket connection for sending input and receiving outputs.
AWS CLI usage: start-session is an interactive command that requires the Session Manager plugin to be installed on the client machine making the call. For information, see Install the Session Manager plugin for the AWS CLI in the AWS Systems Manager User Guide.
AWS Tools for PowerShell usage: Start-SSMSession is not currently supported by AWS Tools for PowerShell on Windows local machines.
Stop an Automation that is currently running.
", "TerminateSession": "Permanently ends a session and closes the data connection between the Session Manager client and SSM Agent on the instance. A terminated session cannot be resumed.
", + "UnlabelParameterVersion": "Remove a label or labels from a parameter.
", "UpdateAssociation": "Updates an association. You can update the association name and version, the document version, schedule, parameters, and Amazon S3 output.
In order to call this API action, your IAM user account, group, or role must be configured with permission to call the DescribeAssociation API action. If you don't have permission to call DescribeAssociation, then you receive the following error: An error occurred (AccessDeniedException) when calling the UpdateAssociation operation: User: <user_arn> is not authorized to perform: ssm:DescribeAssociation on resource: <resource_arn>
When you update an association, the association immediately runs against the specified targets.
Updates the status of the Systems Manager document associated with the specified instance.
", "UpdateDocument": "Updates one or more values for an SSM document.
", @@ -885,7 +886,7 @@ "CreatePatchBaselineRequest$ApprovedPatchesEnableNonSecurity": "Indicates whether the list of approved patches includes non-security updates that should be applied to the instances. The default value is 'false'. Applies to Linux instances only.
", "DeleteDocumentRequest$Force": "Some SSM document types require that you specify a Force flag before you can delete the document. For example, you must specify a Force flag to delete a document of type ApplicationConfigurationSchema. You can restrict access to the Force flag in an AWS Identity and Access Management (IAM) policy.
The system checks if the target is being referenced by a task. If the target is being referenced, the system returns an error and does not deregister the target from the maintenance window.
", - "DescribeAutomationStepExecutionsRequest$ReverseOrder": "A boolean that indicates whether to list step executions in reverse order by start time. The default value is false.
", + "DescribeAutomationStepExecutionsRequest$ReverseOrder": "A boolean that indicates whether to list step executions in reverse order by start time. The default value is 'false'.
", "DocumentVersionInfo$IsDefaultVersion": "An identifier for the default version of the document.
", "GetParameterHistoryRequest$WithDecryption": "Return decrypted values for secure string parameters. This flag is ignored for String and StringList parameter types.
", "GetParameterRequest$WithDecryption": "Return decrypted values for secure string parameters. This flag is ignored for String and StringList parameter types.
", @@ -894,9 +895,9 @@ "GetParametersRequest$WithDecryption": "Return decrypted secure string value. Return decrypted values for secure string parameters. This flag is ignored for String and StringList parameter types.
", "GetPatchBaselineResult$ApprovedPatchesEnableNonSecurity": "Indicates whether the list of approved patches includes non-security updates that should be applied to the instances. The default value is 'false'. Applies to Linux instances only.
", "InstanceInformation$IsLatestVersion": "Indicates whether the latest version of SSM Agent is running on your Linux Managed Instance. This field does not indicate whether or not the latest version is installed on Windows managed instances, because some older versions of Windows Server use the EC2Config service to process SSM requests.
", - "ListCommandInvocationsRequest$Details": "(Optional) If set this returns the response of the command executions and any command output. By default this is set to False.
", + "ListCommandInvocationsRequest$Details": "(Optional) If set this returns the response of the command executions and any command output. The default value is 'false'.
", "PatchRule$EnableNonSecurity": "For instances identified by the approval rule filters, enables a patch baseline to apply non-security updates available in the specified repository. The default value is 'false'. Applies to Linux instances only.
", - "PutParameterRequest$Overwrite": "Overwrite an existing parameter. If not specified, will default to \"false\".
", + "PutParameterRequest$Overwrite": "Overwrite an existing parameter. The default value is 'false'.
", "ResolvedTargets$Truncated": "A boolean value indicating whether the resolved target list is truncated.
", "StepExecution$IsEnd": "The flag which can be used to end automation no matter whether the step succeeds or fails.
", "StepExecution$IsCritical": "The flag which can be used to help decide whether the failure of current step leads to the Automation failure.
", @@ -946,6 +947,12 @@ "refs": { } }, + "ChangeDetailsValue": { + "base": null, + "refs": { + "StartChangeRequestExecutionRequest$ChangeDetails": "User-provided details about the change. If no details are provided, content specified in the Template information section of the associated change template is added.
" + } + }, "ChangeRequestName": { "base": null, "refs": { @@ -1045,7 +1052,7 @@ "base": null, "refs": { "CommandInvocation$Status": "Whether or not the invocation succeeded, failed, or is pending.
", - "GetCommandInvocationResult$Status": "The status of this invocation plugin. This status can be different than StatusDetails.
" + "GetCommandInvocationResult$Status": "The status of this invocation plugin. This status can be different than StatusDetails.
The name of the plugin. Must be one of the following: aws:updateAgent, aws:domainjoin, aws:applications, aws:runPowerShellScript, aws:psmodule, aws:cloudWatch, aws:runShellScript, or aws:updateSSMAgent.
", - "GetCommandInvocationRequest$PluginName": "The name of the plugin for which you want detailed results. If the document contains only one plugin, you can omit the name and details for that plugin are returned. If the document contains more than one plugin, you must specify the name of the plugin for which you want to view details.
Plugin names are also referred to as step names in Systems Manager documents. For example, aws:RunShellScript is a plugin.
The name of the plugin for which you want detailed results. If the document contains only one plugin, you can omit the name and details for that plugin. If the document contains more than one plugin, you must specify the name of the plugin for which you want to view details.
Plugin names are also referred to as step names in Systems Manager documents. For example, aws:RunShellScript is a plugin.
To find the PluginName, check the document content and find the name of the plugin. Alternatively, use ListCommandInvocations with the CommandId and Details parameters. The PluginName is the Name attribute of the CommandPlugin object in the CommandPlugins list.
The name of the plugin, or step name, for which details are reported. For example, aws:RunShellScript is a plugin.
The date and time, in ISO-8601 Extended format, when the session began.
", "Session$EndDate": "The date and time, in ISO-8601 Extended format, when the session was terminated.
", "StartChangeRequestExecutionRequest$ScheduledTime": "The date and time specified in the change request to run the Automation runbooks.
The Automation runbooks specified for the runbook workflow can't run until all required approvals for the change request have been received.
The time that the requester expects the runbook workflow related to the change request to complete. The time is an estimate only that the requester provides for reviewers.
", "StepExecution$ExecutionStartTime": "If a step has begun execution, this contains the time the step started. If the step is in Pending status, this field is not populated.
", "StepExecution$ExecutionEndTime": "If a step has finished execution, this contains the time the execution ended. If the step has not yet concluded, this field is not populated.
", "UpdateOpsItemRequest$ActualStartTime": "The time a runbook workflow started. Currently reported only for the OpsItem type /aws/changerequest.
The name of the document for which you are the owner.
", "DocumentDefaultVersionDescription$Name": "The name of the document.
", "DocumentVersionInfo$Name": "The document name.
", - "GetCommandInvocationResult$DocumentName": "The name of the document that was run. For example, AWS-RunShellScript.
", + "GetCommandInvocationResult$DocumentName": "The name of the document that was run. For example, AWS-RunShellScript.
The name of the document.
", "ListDocumentMetadataHistoryResponse$Name": "The name of the document.
", "ModifyDocumentPermissionRequest$Name": "The name of the document that you want to share.
", @@ -2446,7 +2454,7 @@ "StartChangeRequestExecutionRequest$DocumentVersion": "The version of the change template document to run during the runbook workflow.
", "UpdateAssociationRequest$DocumentVersion": "The document version you want update for the association.
", "UpdateDocumentMetadataRequest$DocumentVersion": "The version of a document to update.
", - "UpdateDocumentRequest$DocumentVersion": "(Required) The latest version of the document that you want to update. The latest document version can be specified using the $LATEST variable or by the version number. Updating a previous version of a document is not supported.
" + "UpdateDocumentRequest$DocumentVersion": "The version of the document that you want to update. Currently, Systems Manager supports updating only the latest version of the document. You can specify the version number of the latest version or use the $LATEST variable.
The instance ID for which you want to view all associations.
", "DescribeInstanceAssociationsStatusRequest$InstanceId": "The instance IDs for which you want association status information.
", "DescribeInstancePatchesRequest$InstanceId": "The ID of the instance whose patch state information should be retrieved.
", - "GetCommandInvocationRequest$InstanceId": "(Required) The ID of the managed instance targeted by the command. A managed instance can be an EC2 instance or an instance in your hybrid environment that is configured for Systems Manager.
", + "GetCommandInvocationRequest$InstanceId": "(Required) The ID of the managed instance targeted by the command. A managed instance can be an Amazon Elastic Compute Cloud (Amazon EC2) instance or an instance in your hybrid environment that is configured for AWS Systems Manager.
", "GetCommandInvocationResult$InstanceId": "The ID of the managed instance targeted by the command. A managed instance can be an EC2 instance or an instance in your hybrid environment that is configured for Systems Manager.
", "GetDeployablePatchSnapshotForInstanceRequest$InstanceId": "The ID of the instance for which the appropriate patch snapshot should be retrieved.
", "GetDeployablePatchSnapshotForInstanceResult$InstanceId": "The ID of the instance.
", @@ -3131,7 +3139,10 @@ "base": null, "refs": { "DescribePatchGroupStateResult$InstancesWithInstalledPendingRebootPatches": "The number of instances with patches installed by Patch Manager that have not been rebooted after the patch installation. The status of these instances is NON_COMPLIANT.
", - "DescribePatchGroupStateResult$InstancesWithInstalledRejectedPatches": "The number of instances with patches installed that are specified in a RejectedPatches list. Patches with a status of INSTALLED_REJECTED were typically installed before they were added to a RejectedPatches list.
If ALLOW_AS_DEPENDENCY is the specified option for RejectedPatchesAction, the value of InstancesWithInstalledRejectedPatches will always be 0 (zero).
The number of instances with patches installed that are specified in a RejectedPatches list. Patches with a status of INSTALLED_REJECTED were typically installed before they were added to a RejectedPatches list.
If ALLOW_AS_DEPENDENCY is the specified option for RejectedPatchesAction, the value of InstancesWithInstalledRejectedPatches will always be 0 (zero).
The number of instances where patches that are specified as \"Critical\" for compliance reporting in the patch baseline are not installed. These patches might be missing, have failed installation, were rejected, or were installed but awaiting a required instance reboot. The status of these instances is NON_COMPLIANT.
The number of instances where patches that are specified as \"Security\" in a patch advisory are not installed. These patches might be missing, have failed installation, were rejected, or were installed but awaiting a required instance reboot. The status of these instances is NON_COMPLIANT.
The number of instances with patches installed that are specified as other than \"Critical\" or \"Security\" but are not compliant with the patch baseline. The status of these instances is NON_COMPLIANT.
" } }, "Integer": { @@ -5341,7 +5352,8 @@ "ParameterHistory$Name": "The name of the parameter.
", "ParameterMetadata$Name": "The parameter name.
", "ParameterNameList$member": null, - "PutParameterRequest$Name": "The fully qualified name of the parameter that you want to add to the system. The fully qualified name includes the complete hierarchy of the parameter path and name. For parameters in a hierarchy, you must include a leading forward slash character (/) when you create or reference a parameter. For example: /Dev/DBServer/MySQL/db-string13
Naming Constraints:
Parameter names are case sensitive.
A parameter name must be unique within an AWS Region
A parameter name can't be prefixed with \"aws\" or \"ssm\" (case-insensitive).
Parameter names can include only the following symbols and letters: a-zA-Z0-9_.-
In addition, the slash character ( / ) is used to delineate hierarchies in parameter names. For example: /Dev/Production/East/Project-ABC/MyParameter
A parameter name can't include spaces.
Parameter hierarchies are limited to a maximum depth of fifteen levels.
For additional information about valid values for parameter names, see Creating Systems Manager parameters in the AWS Systems Manager User Guide.
The maximum length constraint listed below includes capacity for additional system attributes that are not part of the name. The maximum length for a parameter name, including the full length of the parameter ARN, is 1011 characters. For example, the length of the following parameter name is 65 characters, not 20 characters:
arn:aws:ssm:us-east-2:111122223333:parameter/ExampleParameterName
The fully qualified name of the parameter that you want to add to the system. The fully qualified name includes the complete hierarchy of the parameter path and name. For parameters in a hierarchy, you must include a leading forward slash character (/) when you create or reference a parameter. For example: /Dev/DBServer/MySQL/db-string13
Naming Constraints:
Parameter names are case sensitive.
A parameter name must be unique within an AWS Region
A parameter name can't be prefixed with \"aws\" or \"ssm\" (case-insensitive).
Parameter names can include only the following symbols and letters: a-zA-Z0-9_.-
In addition, the slash character ( / ) is used to delineate hierarchies in parameter names. For example: /Dev/Production/East/Project-ABC/MyParameter
A parameter name can't include spaces.
Parameter hierarchies are limited to a maximum depth of fifteen levels.
For additional information about valid values for parameter names, see Creating Systems Manager parameters in the AWS Systems Manager User Guide.
The maximum length constraint listed below includes capacity for additional system attributes that are not part of the name. The maximum length for a parameter name, including the full length of the parameter ARN, is 1011 characters. For example, the length of the following parameter name is 65 characters, not 20 characters:
arn:aws:ssm:us-east-2:111122223333:parameter/ExampleParameterName
The parameter name of which you want to delete one or more labels.
" } }, "PSParameterSelector": { @@ -5366,7 +5378,8 @@ "Parameter$Version": "The parameter version.
", "ParameterHistory$Version": "The parameter version.
", "ParameterMetadata$Version": "The parameter version.
", - "PutParameterResult$Version": "The new version number of a parameter. If you edit a parameter value, Parameter Store automatically creates a new version and assigns this new version a unique ID. You can reference a parameter version ID in API actions or in Systems Manager documents (SSM documents). By default, if you don't specify a specific version, the system returns the latest parameter value when a parameter is called.
" + "PutParameterResult$Version": "The new version number of a parameter. If you edit a parameter value, Parameter Store automatically creates a new version and assigns this new version a unique ID. You can reference a parameter version ID in API actions or in Systems Manager documents (SSM documents). By default, if you don't specify a specific version, the system returns the latest parameter value when a parameter is called.
", + "UnlabelParameterVersionRequest$ParameterVersion": "The specific version of the parameter which you want to delete one or more labels from. If it is not present, the call will fail.
" } }, "Parameter": { @@ -5435,7 +5448,10 @@ "refs": { "LabelParameterVersionRequest$Labels": "One or more labels to attach to the specified parameter version.
", "LabelParameterVersionResult$InvalidLabels": "The label does not meet the requirements. For information about parameter label requirements, see Labeling parameters in the AWS Systems Manager User Guide.
", - "ParameterHistory$Labels": "Labels assigned to the parameter version.
" + "ParameterHistory$Labels": "Labels assigned to the parameter version.
", + "UnlabelParameterVersionRequest$Labels": "One or more labels to delete from the specified parameter version.
", + "UnlabelParameterVersionResult$RemovedLabels": "A list of all labels deleted from the parameter.
", + "UnlabelParameterVersionResult$InvalidLabels": "The labels that are not attached to the given parameter version.
" } }, "ParameterLimitExceeded": { @@ -5765,6 +5781,12 @@ "Patch$ContentUrl": "The URL where more information can be obtained about the patch.
" } }, + "PatchCriticalNonCompliantCount": { + "base": null, + "refs": { + "InstancePatchState$CriticalNonCompliantCount": "The number of instances where patches that are specified as \"Critical\" for compliance reporting in the patch baseline are not installed. These patches might be missing, have failed installation, were rejected, or were installed but awaiting a required instance reboot. The status of these instances is NON_COMPLIANT.
The value for the filter.
" } }, + "PatchOtherNonCompliantCount": { + "base": null, + "refs": { + "InstancePatchState$OtherNonCompliantCount": "The number of instances with patches installed that are specified as other than \"Critical\" or \"Security\" but are not compliant with the patch baseline. The status of these instances is NON_COMPLIANT.
" + } + }, "PatchProduct": { "base": null, "refs": { @@ -6063,6 +6091,12 @@ "PatchRuleGroup$PatchRules": "The rules that make up the rule group.
" } }, + "PatchSecurityNonCompliantCount": { + "base": null, + "refs": { + "InstancePatchState$SecurityNonCompliantCount": "The number of instances where patches that are specified as \"Security\" in a patch advisory are not installed. These patches might be missing, have failed installation, were rejected, or were installed but awaiting a required instance reboot. The status of these instances is NON_COMPLIANT.
A numeric response code generated after running the plugin.
", - "GetCommandInvocationResult$ResponseCode": "The error level response code for the plugin script. If the response code is -1, then the command has not started running on the instance, or it was not received by the instance.
" + "GetCommandInvocationResult$ResponseCode": "The error level response code for the plugin script. If the response code is -1, then the command has not started running on the instance, or it was not received by the instance.
A cron expression that specifies a schedule when the association runs.
", + "Association$ScheduleExpression": "A cron expression that specifies a schedule when the association runs. The schedule runs in Coordinated Universal Time (UTC).
", "AssociationDescription$ScheduleExpression": "A cron expression that specifies a schedule when the association runs.
", "AssociationVersionInfo$ScheduleExpression": "The cron or rate schedule specified for the association when the association version was created.
", "CreateAssociationBatchRequestEntry$ScheduleExpression": "A cron expression that specifies a schedule when the association runs.
", @@ -6974,13 +7008,13 @@ "StandardErrorContent": { "base": null, "refs": { - "GetCommandInvocationResult$StandardErrorContent": "The first 8,000 characters written by the plugin to stderr. If the command has not finished running, then this string is empty.
" + "GetCommandInvocationResult$StandardErrorContent": "The first 8,000 characters written by the plugin to stderr. If the command has not finished running, then this string is empty.
The first 24,000 characters written by the plugin to stdout. If the command has not finished running, if ExecutionStatus is neither Succeeded nor Failed, then this string is empty.
" + "GetCommandInvocationResult$StandardOutputContent": "The first 24,000 characters written by the plugin to stdout. If the command has not finished running, if ExecutionStatus is neither Succeeded nor Failed, then this string is empty.
A detailed status of the command execution. StatusDetails includes more information than Status because it includes states resulting from error and concurrency control parameters. StatusDetails can show different results than Status. For more information about these statuses, see Understanding command statuses in the AWS Systems Manager User Guide. StatusDetails can be one of the following values:
Pending: The command has not been sent to any instances.
In Progress: The command has been sent to at least one instance but has not reached a final state on all instances.
Success: The command successfully ran on all invocations. This is a terminal state.
Delivery Timed Out: The value of MaxErrors or more command invocations shows a status of Delivery Timed Out. This is a terminal state.
Execution Timed Out: The value of MaxErrors or more command invocations shows a status of Execution Timed Out. This is a terminal state.
Failed: The value of MaxErrors or more command invocations shows a status of Failed. This is a terminal state.
Incomplete: The command was attempted on all instances and one or more invocations does not have a value of Success but not enough invocations failed for the status to be Failed. This is a terminal state.
Canceled: The command was terminated before it was completed. This is a terminal state.
Rate Exceeded: The number of instances targeted by the command exceeded the account limit for pending invocations. The system has canceled the command before running it on any instance. This is a terminal state.
A detailed status of the command execution for each invocation (each instance targeted by the command). StatusDetails includes more information than Status because it includes states resulting from error and concurrency control parameters. StatusDetails can show different results than Status. For more information about these statuses, see Understanding command statuses in the AWS Systems Manager User Guide. StatusDetails can be one of the following values:
Pending: The command has not been sent to the instance.
In Progress: The command has been sent to the instance but has not reached a terminal state.
Success: The execution of the command or plugin was successfully completed. This is a terminal state.
Delivery Timed Out: The command was not delivered to the instance before the delivery timeout expired. Delivery timeouts do not count against the parent command's MaxErrors limit, but they do contribute to whether the parent command status is Success or Incomplete. This is a terminal state.
Execution Timed Out: Command execution started on the instance, but the execution was not complete before the execution timeout expired. Execution timeouts count against the MaxErrors limit of the parent command. This is a terminal state.
Failed: The command was not successful on the instance. For a plugin, this indicates that the result code was not zero. For a command invocation, this indicates that the result code for one or more plugins was not zero. Invocation failures count against the MaxErrors limit of the parent command. This is a terminal state.
Canceled: The command was terminated before it was completed. This is a terminal state.
Undeliverable: The command can't be delivered to the instance. The instance might not exist or might not be responding. Undeliverable invocations don't count against the parent command's MaxErrors limit and don't contribute to whether the parent command status is Success or Incomplete. This is a terminal state.
Terminated: The parent command exceeded its MaxErrors limit and subsequent command invocations were canceled by the system. This is a terminal state.
A detailed status of the plugin execution. StatusDetails includes more information than Status because it includes states resulting from error and concurrency control parameters. StatusDetails can show different results than Status. For more information about these statuses, see Understanding command statuses in the AWS Systems Manager User Guide. StatusDetails can be one of the following values:
Pending: The command has not been sent to the instance.
In Progress: The command has been sent to the instance but has not reached a terminal state.
Success: The execution of the command or plugin was successfully completed. This is a terminal state.
Delivery Timed Out: The command was not delivered to the instance before the delivery timeout expired. Delivery timeouts do not count against the parent command's MaxErrors limit, but they do contribute to whether the parent command status is Success or Incomplete. This is a terminal state.
Execution Timed Out: Command execution started on the instance, but the execution was not complete before the execution timeout expired. Execution timeouts count against the MaxErrors limit of the parent command. This is a terminal state.
Failed: The command was not successful on the instance. For a plugin, this indicates that the result code was not zero. For a command invocation, this indicates that the result code for one or more plugins was not zero. Invocation failures count against the MaxErrors limit of the parent command. This is a terminal state.
Canceled: The command was terminated before it was completed. This is a terminal state.
Undeliverable: The command can't be delivered to the instance. The instance might not exist, or it might not be responding. Undeliverable invocations don't count against the parent command's MaxErrors limit, and they don't contribute to whether the parent command status is Success or Incomplete. This is a terminal state.
Terminated: The parent command exceeded its MaxErrors limit and subsequent command invocations were canceled by the system. This is a terminal state.
A detailed status of the command execution for an invocation. StatusDetails includes more information than Status because it includes states resulting from error and concurrency control parameters. StatusDetails can show different results than Status. For more information about these statuses, see Understanding command statuses in the AWS Systems Manager User Guide. StatusDetails can be one of the following values:
Pending: The command has not been sent to the instance.
In Progress: The command has been sent to the instance but has not reached a terminal state.
Delayed: The system attempted to send the command to the target, but the target was not available. The instance might not be available because of network issues, because the instance was stopped, or for similar reasons. The system will try to send the command again.
Success: The command or plugin ran successfully. This is a terminal state.
Delivery Timed Out: The command was not delivered to the instance before the delivery timeout expired. Delivery timeouts do not count against the parent command's MaxErrors limit, but they do contribute to whether the parent command status is Success or Incomplete. This is a terminal state.
Execution Timed Out: The command started to run on the instance, but the execution was not complete before the timeout expired. Execution timeouts count against the MaxErrors limit of the parent command. This is a terminal state.
Failed: The command wasn't run successfully on the instance. For a plugin, this indicates that the result code was not zero. For a command invocation, this indicates that the result code for one or more plugins was not zero. Invocation failures count against the MaxErrors limit of the parent command. This is a terminal state.
Canceled: The command was terminated before it was completed. This is a terminal state.
Undeliverable: The command can't be delivered to the instance. The instance might not exist or might not be responding. Undeliverable invocations don't count against the parent command's MaxErrors limit and don't contribute to whether the parent command status is Success or Incomplete. This is a terminal state.
Terminated: The parent command exceeded its MaxErrors limit and subsequent command invocations were canceled by the system. This is a terminal state.
A detailed status of the command execution for an invocation. StatusDetails includes more information than Status because it includes states resulting from error and concurrency control parameters. StatusDetails can show different results than Status. For more information about these statuses, see Understanding command statuses in the AWS Systems Manager User Guide. StatusDetails can be one of the following values:
Pending: The command has not been sent to the instance.
In Progress: The command has been sent to the instance but has not reached a terminal state.
Delayed: The system attempted to send the command to the target, but the target was not available. The instance might not be available because of network issues, because the instance was stopped, or for similar reasons. The system will try to send the command again.
Success: The command or plugin ran successfully. This is a terminal state.
Delivery Timed Out: The command was not delivered to the instance before the delivery timeout expired. Delivery timeouts do not count against the parent command's MaxErrors limit, but they do contribute to whether the parent command status is Success or Incomplete. This is a terminal state.
Execution Timed Out: The command started to run on the instance, but the execution was not complete before the timeout expired. Execution timeouts count against the MaxErrors limit of the parent command. This is a terminal state.
Failed: The command wasn't run successfully on the instance. For a plugin, this indicates that the result code was not zero. For a command invocation, this indicates that the result code for one or more plugins was not zero. Invocation failures count against the MaxErrors limit of the parent command. This is a terminal state.
Canceled: The command was terminated before it was completed. This is a terminal state.
Undeliverable: The command can't be delivered to the instance. The instance might not exist or might not be responding. Undeliverable invocations don't count against the parent command's MaxErrors limit and don't contribute to whether the parent command status is Success or Incomplete. This is a terminal state.
Terminated: The parent command exceeded its MaxErrors limit and subsequent command invocations were canceled by the system. This is a terminal state.
The date and time the plugin started running. Date and time are written in ISO 8601 format. For example, June 7, 2017 is represented as 2017-06-7. The following sample AWS CLI command uses the InvokedBefore filter.
aws ssm list-commands --filters key=InvokedBefore,value=2017-06-07T00:00:00Z
If the plugin has not started to run, the string is empty.
", - "GetCommandInvocationResult$ExecutionElapsedTime": "Duration since ExecutionStartDateTime.
", - "GetCommandInvocationResult$ExecutionEndDateTime": "The date and time the plugin was finished running. Date and time are written in ISO 8601 format. For example, June 7, 2017 is represented as 2017-06-7. The following sample AWS CLI command uses the InvokedAfter filter.
aws ssm list-commands --filters key=InvokedAfter,value=2017-06-07T00:00:00Z
If the plugin has not started to run, the string is empty.
" + "GetCommandInvocationResult$ExecutionElapsedTime": "Duration since ExecutionStartDateTime.
The date and time the plugin finished running. Date and time are written in ISO 8601 format. For example, June 7, 2017 is represented as 2017-06-7. The following sample AWS CLI command uses the InvokedAfter filter.
aws ssm list-commands --filters key=InvokedAfter,value=2017-06-07T00:00:00Z
If the plugin has not started to run, the string is empty.
" } }, "StringList": { @@ -7341,7 +7375,7 @@ "base": null, "refs": { "Activation$Tags": "Tags assigned to the activation.
", - "AddTagsToResourceRequest$Tags": "One or more tags. The value parameter is required, but if you don't want the tag to have a value, specify the parameter with no value, and we set the value to an empty string.
Do not enter personally identifiable information in this field.
One or more tags. The value parameter is required.
Do not enter personally identifiable information in this field.
Optional metadata that you assign to a resource. Tags enable you to categorize a resource in different ways, such as by purpose, owner, or environment. For example, you might want to tag an activation to identify which servers or virtual machines (VMs) in your on-premises environment you intend to activate. In this case, you could specify the following key name/value pairs:
Key=OS,Value=Windows
Key=Environment,Value=Production
When you install SSM Agent on your on-premises servers and VMs, you specify an activation ID and code. When you specify the activation ID and code, tags assigned to the activation are automatically applied to the on-premises servers or VMs.
You can't add tags to or delete tags from an existing activation. You can tag your on-premises servers and VMs after they connect to Systems Manager for the first time and are assigned a managed instance ID. This means they are listed in the AWS Systems Manager console with an ID that is prefixed with \"mi-\". For information about how to add tags to your managed instances, see AddTagsToResource. For information about how to remove tags from your managed instances, see RemoveTagsFromResource.
", "CreateDocumentRequest$Tags": "Optional metadata that you assign to a resource. Tags enable you to categorize a resource in different ways, such as by purpose, owner, or environment. For example, you might want to tag an SSM document to identify the types of targets or the environment where it will run. In this case, you could specify the following key name/value pairs:
Key=OS,Value=Windows
Key=Environment,Value=Production
To add tags to an existing SSM document, use the AddTagsToResource action.
Optional metadata that you assign to a resource. Tags enable you to categorize a resource in different ways, such as by purpose, owner, or environment. For example, you might want to tag a maintenance window to identify the type of tasks it will run, the types of targets, and the environment it will run in. In this case, you could specify the following key name/value pairs:
Key=TaskType,Value=AgentUpdate
Key=OS,Value=Windows
Key=Environment,Value=Production
To add tags to an existing maintenance window, use the AddTagsToResource action.
The deletion ID returned by the DeleteInventory action.
The calendar entry contained in the specified Systems Manager document is not supported.
", "refs": { @@ -7735,8 +7779,8 @@ "CommandInvocation$StandardErrorUrl": "The URL to the plugin's StdErr file in Amazon S3, if the S3 bucket was defined for the parent command. For an invocation, StandardErrorUrl is populated if there is just one plugin defined for the command, and the S3 bucket was defined for the command.
", "CommandPlugin$StandardOutputUrl": "The URL for the complete text written by the plugin to stdout in Amazon S3. If the S3 bucket for the command was not specified, then this string is empty.
", "CommandPlugin$StandardErrorUrl": "The URL for the complete text written by the plugin to stderr. If execution is not yet complete, then this string is empty.
", - "GetCommandInvocationResult$StandardOutputUrl": "The URL for the complete text written by the plugin to stdout in Amazon S3. If an S3 bucket was not specified, then this string is empty.
", - "GetCommandInvocationResult$StandardErrorUrl": "The URL for the complete text written by the plugin to stderr. If the command has not finished running, then this string is empty.
", + "GetCommandInvocationResult$StandardOutputUrl": "The URL for the complete text written by the plugin to stdout in Amazon Simple Storage Service (Amazon S3). If an S3 bucket was not specified, then this string is empty.
The URL for the complete text written by the plugin to stderr. If the command has not finished running, then this string is empty.
A URL for an S3 bucket where you want to store the results of this request.
" } }, diff --git a/service/cloud9/api.go b/service/cloud9/api.go index f0715df23b..2e717b9e1f 100644 --- a/service/cloud9/api.go +++ b/service/cloud9/api.go @@ -1568,25 +1568,27 @@ type CreateEnvironmentEC2Input struct { Description *string `locationName:"description" type:"string" sensitive:"true"` // The identifier for the Amazon Machine Image (AMI) that's used to create the - // EC2 instance. You can specify the AMI for the instance using an AMI alias - // or an AWS Systems Manager (SSM) path. The default AMI is used if the parameter - // isn't explicitly assigned a value in the request. + // EC2 instance. To choose an AMI for the instance, you must specify a valid + // AMI alias or a valid AWS Systems Manager (SSM) path. + // + // The default AMI is used if the parameter isn't explicitly assigned a value + // in the request. // // AMI aliases // + // * Amazon Linux (default): amazonlinux-1-x86_64 + // // * Amazon Linux 2: amazonlinux-2-x86_64 // // * Ubuntu 18.04: ubuntu-18.04-x86_64 // - // * Amazon Linux (default): amazonlinux-1-x86_64 - // // SSM paths // + // * Amazon Linux (default): resolve:ssm:/aws/service/cloud9/amis/amazonlinux-1-x86_64 + // // * Amazon Linux 2: resolve:ssm:/aws/service/cloud9/amis/amazonlinux-2-x86_64 // // * Ubuntu 18.04: resolve:ssm:/aws/service/cloud9/amis/ubuntu-18.04-x86_64 - // - // * Amazon Linux (default): resolve:ssm:/aws/service/cloud9/amis/amazonlinux-1-x86_64 ImageId *string `locationName:"imageId" type:"string"` // The type of instance to connect to the environment (for example, t2.micro). diff --git a/service/ec2/api.go b/service/ec2/api.go index 7ef8fd88fd..b4467f331b 100644 --- a/service/ec2/api.go +++ b/service/ec2/api.go @@ -3399,7 +3399,8 @@ func (c *EC2) CopyImageRequest(input *CopyImageInput) (req *request.Request, out // // Initiates the copy of an AMI. You can copy an AMI from one Region to another, // or from a Region to an AWS Outpost. You can't copy an AMI from an Outpost -// to a Region, from one Outpost to another, or within the same Outpost. +// to a Region, from one Outpost to another, or within the same Outpost. To +// copy an AMI to another partition, see CreateStoreImageTask (https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_CreateStoreImageTask.html). // // To copy an AMI from one Region to another, specify the source Region using // the SourceRegion parameter, and specify the destination Region using its @@ -6034,6 +6035,88 @@ func (c *EC2) CreateReservedInstancesListingWithContext(ctx aws.Context, input * return out, req.Send() } +const opCreateRestoreImageTask = "CreateRestoreImageTask" + +// CreateRestoreImageTaskRequest generates a "aws/request.Request" representing the +// client's request for the CreateRestoreImageTask 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 CreateRestoreImageTask for more information on using the CreateRestoreImageTask +// 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 CreateRestoreImageTaskRequest method. +// req, resp := client.CreateRestoreImageTaskRequest(params) +// +// err := req.Send() +// if err == nil { // resp is now filled +// fmt.Println(resp) +// } +// +// See also, https://docs.aws.amazon.com/goto/WebAPI/ec2-2016-11-15/CreateRestoreImageTask +func (c *EC2) CreateRestoreImageTaskRequest(input *CreateRestoreImageTaskInput) (req *request.Request, output *CreateRestoreImageTaskOutput) { + op := &request.Operation{ + Name: opCreateRestoreImageTask, + HTTPMethod: "POST", + HTTPPath: "/", + } + + if input == nil { + input = &CreateRestoreImageTaskInput{} + } + + output = &CreateRestoreImageTaskOutput{} + req = c.newRequest(op, input, output) + return +} + +// CreateRestoreImageTask API operation for Amazon Elastic Compute Cloud. +// +// Starts a task that restores an AMI from an S3 object that was previously +// created by using CreateStoreImageTask (https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_CreateStoreImageTask.html). +// +// To use this API, you must have the required permissions. For more information, +// see Permissions for storing and restoring AMIs using S3 (https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ami-store-restore.html#ami-s3-permissions) +// in the Amazon Elastic Compute Cloud User Guide. +// +// For more information, see Store and restore an AMI using S3 (https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ami-store-restore.html) +// in the Amazon Elastic Compute Cloud User Guide. +// +// Returns awserr.Error for service API and SDK errors. Use runtime type assertions +// with awserr.Error's Code and Message methods to get detailed information about +// the error. +// +// See the AWS API reference guide for Amazon Elastic Compute Cloud's +// API operation CreateRestoreImageTask for usage and error information. +// See also, https://docs.aws.amazon.com/goto/WebAPI/ec2-2016-11-15/CreateRestoreImageTask +func (c *EC2) CreateRestoreImageTask(input *CreateRestoreImageTaskInput) (*CreateRestoreImageTaskOutput, error) { + req, out := c.CreateRestoreImageTaskRequest(input) + return out, req.Send() +} + +// CreateRestoreImageTaskWithContext is the same as CreateRestoreImageTask with the addition of +// the ability to pass a context and additional request options. +// +// See CreateRestoreImageTask 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 *EC2) CreateRestoreImageTaskWithContext(ctx aws.Context, input *CreateRestoreImageTaskInput, opts ...request.Option) (*CreateRestoreImageTaskOutput, error) { + req, out := c.CreateRestoreImageTaskRequest(input) + req.SetContext(ctx) + req.ApplyOptions(opts...) + return out, req.Send() +} + const opCreateRoute = "CreateRoute" // CreateRouteRequest generates a "aws/request.Request" representing the @@ -6575,6 +6658,87 @@ func (c *EC2) CreateSpotDatafeedSubscriptionWithContext(ctx aws.Context, input * return out, req.Send() } +const opCreateStoreImageTask = "CreateStoreImageTask" + +// CreateStoreImageTaskRequest generates a "aws/request.Request" representing the +// client's request for the CreateStoreImageTask 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 CreateStoreImageTask for more information on using the CreateStoreImageTask +// 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 CreateStoreImageTaskRequest method. +// req, resp := client.CreateStoreImageTaskRequest(params) +// +// err := req.Send() +// if err == nil { // resp is now filled +// fmt.Println(resp) +// } +// +// See also, https://docs.aws.amazon.com/goto/WebAPI/ec2-2016-11-15/CreateStoreImageTask +func (c *EC2) CreateStoreImageTaskRequest(input *CreateStoreImageTaskInput) (req *request.Request, output *CreateStoreImageTaskOutput) { + op := &request.Operation{ + Name: opCreateStoreImageTask, + HTTPMethod: "POST", + HTTPPath: "/", + } + + if input == nil { + input = &CreateStoreImageTaskInput{} + } + + output = &CreateStoreImageTaskOutput{} + req = c.newRequest(op, input, output) + return +} + +// CreateStoreImageTask API operation for Amazon Elastic Compute Cloud. +// +// 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 (https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ami-store-restore.html#ami-s3-permissions) +// in the Amazon Elastic Compute Cloud User Guide. +// +// For more information, see Store and restore an AMI using S3 (https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ami-store-restore.html) +// in the Amazon Elastic Compute Cloud User Guide. +// +// Returns awserr.Error for service API and SDK errors. Use runtime type assertions +// with awserr.Error's Code and Message methods to get detailed information about +// the error. +// +// See the AWS API reference guide for Amazon Elastic Compute Cloud's +// API operation CreateStoreImageTask for usage and error information. +// See also, https://docs.aws.amazon.com/goto/WebAPI/ec2-2016-11-15/CreateStoreImageTask +func (c *EC2) CreateStoreImageTask(input *CreateStoreImageTaskInput) (*CreateStoreImageTaskOutput, error) { + req, out := c.CreateStoreImageTaskRequest(input) + return out, req.Send() +} + +// CreateStoreImageTaskWithContext is the same as CreateStoreImageTask with the addition of +// the ability to pass a context and additional request options. +// +// See CreateStoreImageTask 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 *EC2) CreateStoreImageTaskWithContext(ctx aws.Context, input *CreateStoreImageTaskInput, opts ...request.Option) (*CreateStoreImageTaskOutput, error) { + req, out := c.CreateStoreImageTaskRequest(input) + req.SetContext(ctx) + req.ApplyOptions(opts...) + return out, req.Send() +} + const opCreateSubnet = "CreateSubnet" // CreateSubnetRequest generates a "aws/request.Request" representing the @@ -23889,6 +24053,96 @@ func (c *EC2) DescribeStaleSecurityGroupsPagesWithContext(ctx aws.Context, input return p.Err() } +const opDescribeStoreImageTasks = "DescribeStoreImageTasks" + +// DescribeStoreImageTasksRequest generates a "aws/request.Request" representing the +// client's request for the DescribeStoreImageTasks 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 DescribeStoreImageTasks for more information on using the DescribeStoreImageTasks +// 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 DescribeStoreImageTasksRequest method. +// req, resp := client.DescribeStoreImageTasksRequest(params) +// +// err := req.Send() +// if err == nil { // resp is now filled +// fmt.Println(resp) +// } +// +// See also, https://docs.aws.amazon.com/goto/WebAPI/ec2-2016-11-15/DescribeStoreImageTasks +func (c *EC2) DescribeStoreImageTasksRequest(input *DescribeStoreImageTasksInput) (req *request.Request, output *DescribeStoreImageTasksOutput) { + op := &request.Operation{ + Name: opDescribeStoreImageTasks, + HTTPMethod: "POST", + HTTPPath: "/", + } + + if input == nil { + input = &DescribeStoreImageTasksInput{} + } + + output = &DescribeStoreImageTasksOutput{} + req = c.newRequest(op, input, output) + return +} + +// DescribeStoreImageTasks API operation for Amazon Elastic Compute Cloud. +// +// Describes the progress of the AMI store tasks. You can describe the store +// tasks for specified AMIs. If you don't specify the AMIs, you get a paginated +// list of store tasks from the last 31 days. +// +// For each AMI task, the response indicates if the task is InProgress, Completed, +// or Failed. For tasks InProgress, the response shows the estimated progress +// as a percentage. +// +// Tasks are listed in reverse chronological order. Currently, only tasks from +// the past 31 days can be viewed. +// +// To use this API, you must have the required permissions. For more information, +// see Permissions for storing and restoring AMIs using S3 (https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ami-store-restore.html#ami-s3-permissions) +// in the Amazon Elastic Compute Cloud User Guide. +// +// For more information, see Store and restore an AMI using S3 (https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ami-store-restore.html) +// in the Amazon Elastic Compute Cloud User Guide. +// +// Returns awserr.Error for service API and SDK errors. Use runtime type assertions +// with awserr.Error's Code and Message methods to get detailed information about +// the error. +// +// See the AWS API reference guide for Amazon Elastic Compute Cloud's +// API operation DescribeStoreImageTasks for usage and error information. +// See also, https://docs.aws.amazon.com/goto/WebAPI/ec2-2016-11-15/DescribeStoreImageTasks +func (c *EC2) DescribeStoreImageTasks(input *DescribeStoreImageTasksInput) (*DescribeStoreImageTasksOutput, error) { + req, out := c.DescribeStoreImageTasksRequest(input) + return out, req.Send() +} + +// DescribeStoreImageTasksWithContext is the same as DescribeStoreImageTasks with the addition of +// the ability to pass a context and additional request options. +// +// See DescribeStoreImageTasks 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 *EC2) DescribeStoreImageTasksWithContext(ctx aws.Context, input *DescribeStoreImageTasksInput, opts ...request.Option) (*DescribeStoreImageTasksOutput, error) { + req, out := c.DescribeStoreImageTasksRequest(input) + req.SetContext(ctx) + req.ApplyOptions(opts...) + return out, req.Send() +} + const opDescribeSubnets = "DescribeSubnets" // DescribeSubnetsRequest generates a "aws/request.Request" representing the @@ -53821,6 +54075,119 @@ func (s *CreateReservedInstancesListingOutput) SetReservedInstancesListings(v [] return s } +type CreateRestoreImageTaskInput struct { + _ struct{} `type:"structure"` + + // The name of the S3 bucket that contains the stored AMI object. + // + // Bucket is a required field + Bucket *string `type:"string" required:"true"` + + // Checks whether you have the required permissions for the action, without + // actually making the request, and provides an error response. If you have + // the required permissions, the error response is DryRunOperation. Otherwise, + // it is UnauthorizedOperation. + DryRun *bool `type:"boolean"` + + // The name for the restored AMI. The name must be unique for AMIs in the Region + // for this account. If you do not provide a name, the new AMI gets the same + // name as the original AMI. + Name *string `type:"string"` + + // The name of the stored AMI object in the bucket. + // + // ObjectKey is a required field + ObjectKey *string `type:"string" required:"true"` + + // The tags to apply to the AMI and snapshots on restoration. You can tag the + // AMI, the snapshots, or both. + // + // * To tag the AMI, the value for ResourceType must be image. + // + // * To tag the snapshots, the value for ResourceType must be snapshot. The + // same tag is applied to all of the snapshots that are created. + TagSpecifications []*TagSpecification `locationName:"TagSpecification" locationNameList:"item" type:"list"` +} + +// String returns the string representation +func (s CreateRestoreImageTaskInput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s CreateRestoreImageTaskInput) GoString() string { + return s.String() +} + +// Validate inspects the fields of the type to determine if they are valid. +func (s *CreateRestoreImageTaskInput) Validate() error { + invalidParams := request.ErrInvalidParams{Context: "CreateRestoreImageTaskInput"} + if s.Bucket == nil { + invalidParams.Add(request.NewErrParamRequired("Bucket")) + } + if s.ObjectKey == nil { + invalidParams.Add(request.NewErrParamRequired("ObjectKey")) + } + + if invalidParams.Len() > 0 { + return invalidParams + } + return nil +} + +// SetBucket sets the Bucket field's value. +func (s *CreateRestoreImageTaskInput) SetBucket(v string) *CreateRestoreImageTaskInput { + s.Bucket = &v + return s +} + +// SetDryRun sets the DryRun field's value. +func (s *CreateRestoreImageTaskInput) SetDryRun(v bool) *CreateRestoreImageTaskInput { + s.DryRun = &v + return s +} + +// SetName sets the Name field's value. +func (s *CreateRestoreImageTaskInput) SetName(v string) *CreateRestoreImageTaskInput { + s.Name = &v + return s +} + +// SetObjectKey sets the ObjectKey field's value. +func (s *CreateRestoreImageTaskInput) SetObjectKey(v string) *CreateRestoreImageTaskInput { + s.ObjectKey = &v + return s +} + +// SetTagSpecifications sets the TagSpecifications field's value. +func (s *CreateRestoreImageTaskInput) SetTagSpecifications(v []*TagSpecification) *CreateRestoreImageTaskInput { + s.TagSpecifications = v + return s +} + +type CreateRestoreImageTaskOutput struct { + _ struct{} `type:"structure"` + + // The AMI ID. + ImageId *string `locationName:"imageId" type:"string"` +} + +// String returns the string representation +func (s CreateRestoreImageTaskOutput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s CreateRestoreImageTaskOutput) GoString() string { + return s.String() +} + +// SetImageId sets the ImageId field's value. +func (s *CreateRestoreImageTaskOutput) SetImageId(v string) *CreateRestoreImageTaskOutput { + s.ImageId = &v + return s +} + type CreateRouteInput struct { _ struct{} `type:"structure"` @@ -54533,6 +54900,104 @@ func (s *CreateSpotDatafeedSubscriptionOutput) SetSpotDatafeedSubscription(v *Sp return s } +type CreateStoreImageTaskInput struct { + _ struct{} `type:"structure"` + + // The name of the S3 bucket in which the AMI object will be stored. The bucket + // must be in the Region in which the request is being made. The AMI object + // appears in the bucket only after the upload task has completed. + // + // Bucket is a required field + Bucket *string `type:"string" required:"true"` + + // Checks whether you have the required permissions for the action, without + // actually making the request, and provides an error response. If you have + // the required permissions, the error response is DryRunOperation. Otherwise, + // it is UnauthorizedOperation. + DryRun *bool `type:"boolean"` + + // The ID of the AMI. + // + // ImageId is a required field + ImageId *string `type:"string" required:"true"` + + // The tags to apply to the AMI object that will be stored in the S3 bucket. + S3ObjectTags []*S3ObjectTag `locationName:"S3ObjectTag" locationNameList:"item" type:"list"` +} + +// String returns the string representation +func (s CreateStoreImageTaskInput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s CreateStoreImageTaskInput) GoString() string { + return s.String() +} + +// Validate inspects the fields of the type to determine if they are valid. +func (s *CreateStoreImageTaskInput) Validate() error { + invalidParams := request.ErrInvalidParams{Context: "CreateStoreImageTaskInput"} + if s.Bucket == nil { + invalidParams.Add(request.NewErrParamRequired("Bucket")) + } + if s.ImageId == nil { + invalidParams.Add(request.NewErrParamRequired("ImageId")) + } + + if invalidParams.Len() > 0 { + return invalidParams + } + return nil +} + +// SetBucket sets the Bucket field's value. +func (s *CreateStoreImageTaskInput) SetBucket(v string) *CreateStoreImageTaskInput { + s.Bucket = &v + return s +} + +// SetDryRun sets the DryRun field's value. +func (s *CreateStoreImageTaskInput) SetDryRun(v bool) *CreateStoreImageTaskInput { + s.DryRun = &v + return s +} + +// SetImageId sets the ImageId field's value. +func (s *CreateStoreImageTaskInput) SetImageId(v string) *CreateStoreImageTaskInput { + s.ImageId = &v + return s +} + +// SetS3ObjectTags sets the S3ObjectTags field's value. +func (s *CreateStoreImageTaskInput) SetS3ObjectTags(v []*S3ObjectTag) *CreateStoreImageTaskInput { + s.S3ObjectTags = v + return s +} + +type CreateStoreImageTaskOutput struct { + _ struct{} `type:"structure"` + + // The name of the stored AMI object in the S3 bucket. + ObjectKey *string `locationName:"objectKey" type:"string"` +} + +// String returns the string representation +func (s CreateStoreImageTaskOutput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s CreateStoreImageTaskOutput) GoString() string { + return s.String() +} + +// SetObjectKey sets the ObjectKey field's value. +func (s *CreateStoreImageTaskOutput) SetObjectKey(v string) *CreateStoreImageTaskOutput { + s.ObjectKey = &v + return s +} + type CreateSubnetInput struct { _ struct{} `type:"structure"` @@ -74012,6 +74477,124 @@ func (s *DescribeStaleSecurityGroupsOutput) SetStaleSecurityGroupSet(v []*StaleS return s } +type DescribeStoreImageTasksInput struct { + _ struct{} `type:"structure"` + + // Checks whether you have the required permissions for the action, without + // actually making the request, and provides an error response. If you have + // the required permissions, the error response is DryRunOperation. Otherwise, + // it is UnauthorizedOperation. + DryRun *bool `type:"boolean"` + + // 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. + Filters []*Filter `locationName:"Filter" locationNameList:"Filter" type:"list"` + + // The AMI IDs for which to show progress. Up to 20 AMI IDs can be included + // in a request. + ImageIds []*string `locationName:"ImageId" locationNameList:"item" type:"list"` + + // The maximum number of results to return in a single call. To retrieve the + // remaining results, make another call with the returned NextToken value. This + // value can be between 1 and 200. You cannot specify this parameter and the + // ImageIDs parameter in the same call. + MaxResults *int64 `min:"1" type:"integer"` + + // The token for the next page of results. + NextToken *string `type:"string"` +} + +// String returns the string representation +func (s DescribeStoreImageTasksInput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s DescribeStoreImageTasksInput) GoString() string { + return s.String() +} + +// Validate inspects the fields of the type to determine if they are valid. +func (s *DescribeStoreImageTasksInput) Validate() error { + invalidParams := request.ErrInvalidParams{Context: "DescribeStoreImageTasksInput"} + if s.MaxResults != nil && *s.MaxResults < 1 { + invalidParams.Add(request.NewErrParamMinValue("MaxResults", 1)) + } + + if invalidParams.Len() > 0 { + return invalidParams + } + return nil +} + +// SetDryRun sets the DryRun field's value. +func (s *DescribeStoreImageTasksInput) SetDryRun(v bool) *DescribeStoreImageTasksInput { + s.DryRun = &v + return s +} + +// SetFilters sets the Filters field's value. +func (s *DescribeStoreImageTasksInput) SetFilters(v []*Filter) *DescribeStoreImageTasksInput { + s.Filters = v + return s +} + +// SetImageIds sets the ImageIds field's value. +func (s *DescribeStoreImageTasksInput) SetImageIds(v []*string) *DescribeStoreImageTasksInput { + s.ImageIds = v + return s +} + +// SetMaxResults sets the MaxResults field's value. +func (s *DescribeStoreImageTasksInput) SetMaxResults(v int64) *DescribeStoreImageTasksInput { + s.MaxResults = &v + return s +} + +// SetNextToken sets the NextToken field's value. +func (s *DescribeStoreImageTasksInput) SetNextToken(v string) *DescribeStoreImageTasksInput { + s.NextToken = &v + return s +} + +type DescribeStoreImageTasksOutput struct { + _ struct{} `type:"structure"` + + // The token to use to retrieve the next page of results. This value is null + // when there are no more results to return. + NextToken *string `locationName:"nextToken" type:"string"` + + // The information about the AMI store tasks. + StoreImageTaskResults []*StoreImageTaskResult `locationName:"storeImageTaskResultSet" locationNameList:"item" type:"list"` +} + +// String returns the string representation +func (s DescribeStoreImageTasksOutput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s DescribeStoreImageTasksOutput) GoString() string { + return s.String() +} + +// SetNextToken sets the NextToken field's value. +func (s *DescribeStoreImageTasksOutput) SetNextToken(v string) *DescribeStoreImageTasksOutput { + s.NextToken = &v + return s +} + +// SetStoreImageTaskResults sets the StoreImageTaskResults field's value. +func (s *DescribeStoreImageTasksOutput) SetStoreImageTaskResults(v []*StoreImageTaskResult) *DescribeStoreImageTasksOutput { + s.StoreImageTaskResults = v + return s +} + type DescribeSubnetsInput struct { _ struct{} `type:"structure"` @@ -111445,6 +112028,47 @@ func (s *RunScheduledInstancesOutput) SetInstanceIdSet(v []*string) *RunSchedule return s } +// The tags to apply to the AMI object that will be stored in the S3 bucket. +// For more information, see Categorizing your storage using tags (https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-tagging.html) +// in the Amazon Simple Storage Service User Guide. +type S3ObjectTag struct { + _ struct{} `type:"structure"` + + // The key of the tag. + // + // Constraints: Tag keys are case-sensitive and can be up to 128 Unicode characters + // in length. May not begin with aws:. + Key *string `type:"string"` + + // The value of the tag. + // + // Constraints: Tag values are case-sensitive and can be up to 256 Unicode characters + // in length. + Value *string `type:"string"` +} + +// String returns the string representation +func (s S3ObjectTag) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s S3ObjectTag) GoString() string { + return s.String() +} + +// SetKey sets the Key field's value. +func (s *S3ObjectTag) SetKey(v string) *S3ObjectTag { + s.Key = &v + return s +} + +// SetValue sets the Value field's value. +func (s *S3ObjectTag) SetValue(v string) *S3ObjectTag { + s.Value = &v + return s +} + // Describes the storage parameters for S3 and S3 buckets for an instance store-backed // AMI. type S3Storage struct { @@ -116220,6 +116844,85 @@ func (s *StorageLocation) SetKey(v string) *StorageLocation { return s } +// The information about the AMI store task, including the progress of the task. +type StoreImageTaskResult struct { + _ struct{} `type:"structure"` + + // The ID of the AMI that is being stored. + AmiId *string `locationName:"amiId" type:"string"` + + // The name of the S3 bucket that contains the stored AMI object. + Bucket *string `locationName:"bucket" type:"string"` + + // The progress of the task as a percentage. + ProgressPercentage *int64 `locationName:"progressPercentage" type:"integer"` + + // The name of the stored AMI object in the bucket. + S3objectKey *string `locationName:"s3objectKey" type:"string"` + + // If the tasks fails, the reason for the failure is returned. If the task succeeds, + // null is returned. + StoreTaskFailureReason *string `locationName:"storeTaskFailureReason" type:"string"` + + // The state of the store task (InProgress, Completed, or Failed). + StoreTaskState *string `locationName:"storeTaskState" type:"string"` + + // The time the task started. + TaskStartTime *time.Time `locationName:"taskStartTime" type:"timestamp"` +} + +// String returns the string representation +func (s StoreImageTaskResult) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s StoreImageTaskResult) GoString() string { + return s.String() +} + +// SetAmiId sets the AmiId field's value. +func (s *StoreImageTaskResult) SetAmiId(v string) *StoreImageTaskResult { + s.AmiId = &v + return s +} + +// SetBucket sets the Bucket field's value. +func (s *StoreImageTaskResult) SetBucket(v string) *StoreImageTaskResult { + s.Bucket = &v + return s +} + +// SetProgressPercentage sets the ProgressPercentage field's value. +func (s *StoreImageTaskResult) SetProgressPercentage(v int64) *StoreImageTaskResult { + s.ProgressPercentage = &v + return s +} + +// SetS3objectKey sets the S3objectKey field's value. +func (s *StoreImageTaskResult) SetS3objectKey(v string) *StoreImageTaskResult { + s.S3objectKey = &v + return s +} + +// SetStoreTaskFailureReason sets the StoreTaskFailureReason field's value. +func (s *StoreImageTaskResult) SetStoreTaskFailureReason(v string) *StoreImageTaskResult { + s.StoreTaskFailureReason = &v + return s +} + +// SetStoreTaskState sets the StoreTaskState field's value. +func (s *StoreImageTaskResult) SetStoreTaskState(v string) *StoreImageTaskResult { + s.StoreTaskState = &v + return s +} + +// SetTaskStartTime sets the TaskStartTime field's value. +func (s *StoreImageTaskResult) SetTaskStartTime(v time.Time) *StoreImageTaskResult { + s.TaskStartTime = &v + return s +} + // Describes a subnet. type Subnet struct { _ struct{} `type:"structure"` diff --git a/service/ec2/ec2iface/interface.go b/service/ec2/ec2iface/interface.go index 01ce13692f..6277df8f4a 100644 --- a/service/ec2/ec2iface/interface.go +++ b/service/ec2/ec2iface/interface.go @@ -352,6 +352,10 @@ type EC2API interface { CreateReservedInstancesListingWithContext(aws.Context, *ec2.CreateReservedInstancesListingInput, ...request.Option) (*ec2.CreateReservedInstancesListingOutput, error) CreateReservedInstancesListingRequest(*ec2.CreateReservedInstancesListingInput) (*request.Request, *ec2.CreateReservedInstancesListingOutput) + CreateRestoreImageTask(*ec2.CreateRestoreImageTaskInput) (*ec2.CreateRestoreImageTaskOutput, error) + CreateRestoreImageTaskWithContext(aws.Context, *ec2.CreateRestoreImageTaskInput, ...request.Option) (*ec2.CreateRestoreImageTaskOutput, error) + CreateRestoreImageTaskRequest(*ec2.CreateRestoreImageTaskInput) (*request.Request, *ec2.CreateRestoreImageTaskOutput) + CreateRoute(*ec2.CreateRouteInput) (*ec2.CreateRouteOutput, error) CreateRouteWithContext(aws.Context, *ec2.CreateRouteInput, ...request.Option) (*ec2.CreateRouteOutput, error) CreateRouteRequest(*ec2.CreateRouteInput) (*request.Request, *ec2.CreateRouteOutput) @@ -376,6 +380,10 @@ type EC2API interface { CreateSpotDatafeedSubscriptionWithContext(aws.Context, *ec2.CreateSpotDatafeedSubscriptionInput, ...request.Option) (*ec2.CreateSpotDatafeedSubscriptionOutput, error) CreateSpotDatafeedSubscriptionRequest(*ec2.CreateSpotDatafeedSubscriptionInput) (*request.Request, *ec2.CreateSpotDatafeedSubscriptionOutput) + CreateStoreImageTask(*ec2.CreateStoreImageTaskInput) (*ec2.CreateStoreImageTaskOutput, error) + CreateStoreImageTaskWithContext(aws.Context, *ec2.CreateStoreImageTaskInput, ...request.Option) (*ec2.CreateStoreImageTaskOutput, error) + CreateStoreImageTaskRequest(*ec2.CreateStoreImageTaskInput) (*request.Request, *ec2.CreateStoreImageTaskOutput) + CreateSubnet(*ec2.CreateSubnetInput) (*ec2.CreateSubnetOutput, error) CreateSubnetWithContext(aws.Context, *ec2.CreateSubnetInput, ...request.Option) (*ec2.CreateSubnetOutput, error) CreateSubnetRequest(*ec2.CreateSubnetInput) (*request.Request, *ec2.CreateSubnetOutput) @@ -1258,6 +1266,10 @@ type EC2API interface { DescribeStaleSecurityGroupsPages(*ec2.DescribeStaleSecurityGroupsInput, func(*ec2.DescribeStaleSecurityGroupsOutput, bool) bool) error DescribeStaleSecurityGroupsPagesWithContext(aws.Context, *ec2.DescribeStaleSecurityGroupsInput, func(*ec2.DescribeStaleSecurityGroupsOutput, bool) bool, ...request.Option) error + DescribeStoreImageTasks(*ec2.DescribeStoreImageTasksInput) (*ec2.DescribeStoreImageTasksOutput, error) + DescribeStoreImageTasksWithContext(aws.Context, *ec2.DescribeStoreImageTasksInput, ...request.Option) (*ec2.DescribeStoreImageTasksOutput, error) + DescribeStoreImageTasksRequest(*ec2.DescribeStoreImageTasksInput) (*request.Request, *ec2.DescribeStoreImageTasksOutput) + DescribeSubnets(*ec2.DescribeSubnetsInput) (*ec2.DescribeSubnetsOutput, error) DescribeSubnetsWithContext(aws.Context, *ec2.DescribeSubnetsInput, ...request.Option) (*ec2.DescribeSubnetsOutput, error) DescribeSubnetsRequest(*ec2.DescribeSubnetsInput) (*request.Request, *ec2.DescribeSubnetsOutput) diff --git a/service/medialive/api.go b/service/medialive/api.go index 882b1e0907..6ab4f26fc9 100644 --- a/service/medialive/api.go +++ b/service/medialive/api.go @@ -8947,7 +8947,7 @@ type Channel struct { Tags map[string]*string `locationName:"tags" type:"map"` // Settings for VPC output - Vpc *VpcOutputSettings `locationName:"vpc" type:"structure"` + Vpc *VpcOutputSettingsDescription `locationName:"vpc" type:"structure"` } // String returns the string representation @@ -9057,7 +9057,7 @@ func (s *Channel) SetTags(v map[string]*string) *Channel { } // SetVpc sets the Vpc field's value. -func (s *Channel) SetVpc(v *VpcOutputSettings) *Channel { +func (s *Channel) SetVpc(v *VpcOutputSettingsDescription) *Channel { s.Vpc = v return s } @@ -9133,7 +9133,7 @@ type ChannelSummary struct { Tags map[string]*string `locationName:"tags" type:"map"` // Settings for VPC output - Vpc *VpcOutputSettings `locationName:"vpc" type:"structure"` + Vpc *VpcOutputSettingsDescription `locationName:"vpc" type:"structure"` } // String returns the string representation @@ -9231,7 +9231,7 @@ func (s *ChannelSummary) SetTags(v map[string]*string) *ChannelSummary { } // SetVpc sets the Vpc field's value. -func (s *ChannelSummary) SetVpc(v *VpcOutputSettings) *ChannelSummary { +func (s *ChannelSummary) SetVpc(v *VpcOutputSettingsDescription) *ChannelSummary { s.Vpc = v return s } @@ -10111,9 +10111,8 @@ type DeleteChannelOutput struct { Tags map[string]*string `locationName:"tags" type:"map"` - // The properties for a private VPC OutputWhen this property is specified, the - // output egress addresses will be created in a user specified VPC - Vpc *VpcOutputSettings `locationName:"vpc" type:"structure"` + // The properties for a private VPC Output + Vpc *VpcOutputSettingsDescription `locationName:"vpc" type:"structure"` } // String returns the string representation @@ -10223,7 +10222,7 @@ func (s *DeleteChannelOutput) SetTags(v map[string]*string) *DeleteChannelOutput } // SetVpc sets the Vpc field's value. -func (s *DeleteChannelOutput) SetVpc(v *VpcOutputSettings) *DeleteChannelOutput { +func (s *DeleteChannelOutput) SetVpc(v *VpcOutputSettingsDescription) *DeleteChannelOutput { s.Vpc = v return s } @@ -10976,9 +10975,8 @@ type DescribeChannelOutput struct { Tags map[string]*string `locationName:"tags" type:"map"` - // The properties for a private VPC OutputWhen this property is specified, the - // output egress addresses will be created in a user specified VPC - Vpc *VpcOutputSettings `locationName:"vpc" type:"structure"` + // The properties for a private VPC Output + Vpc *VpcOutputSettingsDescription `locationName:"vpc" type:"structure"` } // String returns the string representation @@ -11088,7 +11086,7 @@ func (s *DescribeChannelOutput) SetTags(v map[string]*string) *DescribeChannelOu } // SetVpc sets the Vpc field's value. -func (s *DescribeChannelOutput) SetVpc(v *VpcOutputSettings) *DescribeChannelOutput { +func (s *DescribeChannelOutput) SetVpc(v *VpcOutputSettingsDescription) *DescribeChannelOutput { s.Vpc = v return s } @@ -24437,9 +24435,8 @@ type StartChannelOutput struct { Tags map[string]*string `locationName:"tags" type:"map"` - // The properties for a private VPC OutputWhen this property is specified, the - // output egress addresses will be created in a user specified VPC - Vpc *VpcOutputSettings `locationName:"vpc" type:"structure"` + // The properties for a private VPC Output + Vpc *VpcOutputSettingsDescription `locationName:"vpc" type:"structure"` } // String returns the string representation @@ -24549,7 +24546,7 @@ func (s *StartChannelOutput) SetTags(v map[string]*string) *StartChannelOutput { } // SetVpc sets the Vpc field's value. -func (s *StartChannelOutput) SetVpc(v *VpcOutputSettings) *StartChannelOutput { +func (s *StartChannelOutput) SetVpc(v *VpcOutputSettingsDescription) *StartChannelOutput { s.Vpc = v return s } @@ -25034,9 +25031,8 @@ type StopChannelOutput struct { Tags map[string]*string `locationName:"tags" type:"map"` - // The properties for a private VPC OutputWhen this property is specified, the - // output egress addresses will be created in a user specified VPC - Vpc *VpcOutputSettings `locationName:"vpc" type:"structure"` + // The properties for a private VPC Output + Vpc *VpcOutputSettingsDescription `locationName:"vpc" type:"structure"` } // String returns the string representation @@ -25146,7 +25142,7 @@ func (s *StopChannelOutput) SetTags(v map[string]*string) *StopChannelOutput { } // SetVpc sets the Vpc field's value. -func (s *StopChannelOutput) SetVpc(v *VpcOutputSettings) *StopChannelOutput { +func (s *StopChannelOutput) SetVpc(v *VpcOutputSettingsDescription) *StopChannelOutput { s.Vpc = v return s } @@ -25629,6 +25625,8 @@ type TransferringInputDeviceSummary struct { // The AWS account ID for the recipient of the input device transfer. TargetCustomerId *string `locationName:"targetCustomerId" type:"string"` + TargetRegion *string `locationName:"targetRegion" type:"string"` + // The type (direction) of the input device transfer. TransferType *string `locationName:"transferType" type:"string" enum:"InputDeviceTransferType"` } @@ -25661,6 +25659,12 @@ func (s *TransferringInputDeviceSummary) SetTargetCustomerId(v string) *Transfer return s } +// SetTargetRegion sets the TargetRegion field's value. +func (s *TransferringInputDeviceSummary) SetTargetRegion(v string) *TransferringInputDeviceSummary { + s.TargetRegion = &v + return s +} + // SetTransferType sets the TransferType field's value. func (s *TransferringInputDeviceSummary) SetTransferType(v string) *TransferringInputDeviceSummary { s.TransferType = &v @@ -27315,6 +27319,62 @@ func (s *VpcOutputSettings) SetSubnetIds(v []*string) *VpcOutputSettings { return s } +// The properties for a private VPC Output +type VpcOutputSettingsDescription struct { + _ struct{} `type:"structure"` + + // The Availability Zones where the vpc subnets are located.The first Availability + // Zone applies to the first subnet in the list of subnets.The second Availability + // Zone applies to the second subnet. + AvailabilityZones []*string `locationName:"availabilityZones" type:"list"` + + // A list of Elastic Network Interfaces created by MediaLive in the customer's + // VPC + NetworkInterfaceIds []*string `locationName:"networkInterfaceIds" type:"list"` + + // A list of up EC2 VPC security group IDs attached to the Output VPC network + // interfaces. + SecurityGroupIds []*string `locationName:"securityGroupIds" type:"list"` + + // A list of VPC subnet IDs from the same VPC.If STANDARD channel, subnet IDs + // must be mapped to two unique availability zones (AZ). + SubnetIds []*string `locationName:"subnetIds" type:"list"` +} + +// String returns the string representation +func (s VpcOutputSettingsDescription) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s VpcOutputSettingsDescription) GoString() string { + return s.String() +} + +// SetAvailabilityZones sets the AvailabilityZones field's value. +func (s *VpcOutputSettingsDescription) SetAvailabilityZones(v []*string) *VpcOutputSettingsDescription { + s.AvailabilityZones = v + return s +} + +// SetNetworkInterfaceIds sets the NetworkInterfaceIds field's value. +func (s *VpcOutputSettingsDescription) SetNetworkInterfaceIds(v []*string) *VpcOutputSettingsDescription { + s.NetworkInterfaceIds = v + return s +} + +// SetSecurityGroupIds sets the SecurityGroupIds field's value. +func (s *VpcOutputSettingsDescription) SetSecurityGroupIds(v []*string) *VpcOutputSettingsDescription { + s.SecurityGroupIds = v + return s +} + +// SetSubnetIds sets the SubnetIds field's value. +func (s *VpcOutputSettingsDescription) SetSubnetIds(v []*string) *VpcOutputSettingsDescription { + s.SubnetIds = v + return s +} + // Wav Settings type WavSettings struct { _ struct{} `type:"structure"` diff --git a/service/ssm/api.go b/service/ssm/api.go index 82781d88c8..e2023a2ec4 100644 --- a/service/ssm/api.go +++ b/service/ssm/api.go @@ -7248,6 +7248,10 @@ func (c *SSM) GetCommandInvocationRequest(input *GetCommandInvocationInput) (req // Returns detailed information about command execution for an invocation or // plugin. // +// GetCommandInvocation only gives the execution status of a plugin in a document. +// To get the command execution status on a specific instance, use ListCommandInvocations. +// To get the command execution status across instances, use ListCommands. +// // 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. @@ -9524,8 +9528,8 @@ func (c *SSM) LabelParameterVersionRequest(input *LabelParameterVersionInput) (r // * You can't create a label when you create a new parameter. You must attach // a label to a specific version of a parameter. // -// * You can't delete a parameter label. If you no longer want to use a parameter -// label, then you must move it to a different version of a parameter. +// * If you no longer want to use a parameter label, then you can either +// delete it or move it to a different version of a parameter. // // * A label can have a maximum of 100 characters. // @@ -13627,6 +13631,96 @@ func (c *SSM) TerminateSessionWithContext(ctx aws.Context, input *TerminateSessi return out, req.Send() } +const opUnlabelParameterVersion = "UnlabelParameterVersion" + +// UnlabelParameterVersionRequest generates a "aws/request.Request" representing the +// client's request for the UnlabelParameterVersion 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 UnlabelParameterVersion for more information on using the UnlabelParameterVersion +// 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 UnlabelParameterVersionRequest method. +// req, resp := client.UnlabelParameterVersionRequest(params) +// +// err := req.Send() +// if err == nil { // resp is now filled +// fmt.Println(resp) +// } +// +// See also, https://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/UnlabelParameterVersion +func (c *SSM) UnlabelParameterVersionRequest(input *UnlabelParameterVersionInput) (req *request.Request, output *UnlabelParameterVersionOutput) { + op := &request.Operation{ + Name: opUnlabelParameterVersion, + HTTPMethod: "POST", + HTTPPath: "/", + } + + if input == nil { + input = &UnlabelParameterVersionInput{} + } + + output = &UnlabelParameterVersionOutput{} + req = c.newRequest(op, input, output) + return +} + +// UnlabelParameterVersion API operation for Amazon Simple Systems Manager (SSM). +// +// Remove a label or labels from a parameter. +// +// 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 Simple Systems Manager (SSM)'s +// API operation UnlabelParameterVersion for usage and error information. +// +// Returned Error Types: +// * InternalServerError +// An error occurred on the server side. +// +// * TooManyUpdates +// There are concurrent updates for a resource that supports one update at a +// time. +// +// * ParameterNotFound +// The parameter could not be found. Verify the name and try again. +// +// * ParameterVersionNotFound +// The specified parameter version was not found. Verify the parameter name +// and version, and try again. +// +// See also, https://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/UnlabelParameterVersion +func (c *SSM) UnlabelParameterVersion(input *UnlabelParameterVersionInput) (*UnlabelParameterVersionOutput, error) { + req, out := c.UnlabelParameterVersionRequest(input) + return out, req.Send() +} + +// UnlabelParameterVersionWithContext is the same as UnlabelParameterVersion with the addition of +// the ability to pass a context and additional request options. +// +// See UnlabelParameterVersion 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 *SSM) UnlabelParameterVersionWithContext(ctx aws.Context, input *UnlabelParameterVersionInput, opts ...request.Option) (*UnlabelParameterVersionOutput, error) { + req, out := c.UnlabelParameterVersionRequest(input) + req.SetContext(ctx) + req.ApplyOptions(opts...) + return out, req.Send() +} + const opUpdateAssociation = "UpdateAssociation" // UpdateAssociationRequest generates a "aws/request.Request" representing the @@ -15233,9 +15327,7 @@ type AddTagsToResourceInput struct { // ResourceType is a required field ResourceType *string `type:"string" required:"true" enum:"ResourceTypeForTagging"` - // One or more tags. The value parameter is required, but if you don't want - // the tag to have a value, specify the parameter with no value, and we set - // the value to an empty string. + // One or more tags. The value parameter is required. // // Do not enter personally identifiable information in this field. // @@ -15457,7 +15549,8 @@ type Association struct { // Information about the association. Overview *AssociationOverview `type:"structure"` - // A cron expression that specifies a schedule when the association runs. + // A cron expression that specifies a schedule when the association runs. The + // schedule runs in Coordinated Universal Time (UTC). ScheduleExpression *string `min:"1" type:"string"` // The instances targeted by the request to create an association. @@ -23126,7 +23219,7 @@ type DescribeAutomationStepExecutionsInput struct { NextToken *string `type:"string"` // A boolean that indicates whether to list step executions in reverse order - // by start time. The default value is false. + // by start time. The default value is 'false'. ReverseOrder *bool `type:"boolean"` } @@ -25758,6 +25851,13 @@ type DescribePatchGroupStateOutput struct { // The number of instances in the patch group. Instances *int64 `type:"integer"` + // The number of instances where patches that are specified as "Critical" for + // compliance reporting in the patch baseline are not installed. These patches + // might be missing, have failed installation, were rejected, or were installed + // but awaiting a required instance reboot. The status of these instances is + // NON_COMPLIANT. + InstancesWithCriticalNonCompliantPatches *int64 `type:"integer"` + // The number of instances with patches from the patch baseline that failed // to install. InstancesWithFailedPatches *int64 `type:"integer"` @@ -25788,6 +25888,17 @@ type DescribePatchGroupStateOutput struct { // The number of instances with patches that aren't applicable. InstancesWithNotApplicablePatches *int64 `type:"integer"` + // The number of instances with patches installed that are specified as other + // than "Critical" or "Security" but are not compliant with the patch baseline. + // The status of these instances is NON_COMPLIANT. + InstancesWithOtherNonCompliantPatches *int64 `type:"integer"` + + // The number of instances where patches that are specified as "Security" in + // a patch advisory are not installed. These patches might be missing, have + // failed installation, were rejected, or were installed but awaiting a required + // instance reboot. The status of these instances is NON_COMPLIANT. + InstancesWithSecurityNonCompliantPatches *int64 `type:"integer"` + // The number of instances with NotApplicable patches beyond the supported limit, // which are not reported by name to Systems Manager Inventory. InstancesWithUnreportedNotApplicablePatches *int64 `type:"integer"` @@ -25809,6 +25920,12 @@ func (s *DescribePatchGroupStateOutput) SetInstances(v int64) *DescribePatchGrou return s } +// SetInstancesWithCriticalNonCompliantPatches sets the InstancesWithCriticalNonCompliantPatches field's value. +func (s *DescribePatchGroupStateOutput) SetInstancesWithCriticalNonCompliantPatches(v int64) *DescribePatchGroupStateOutput { + s.InstancesWithCriticalNonCompliantPatches = &v + return s +} + // SetInstancesWithFailedPatches sets the InstancesWithFailedPatches field's value. func (s *DescribePatchGroupStateOutput) SetInstancesWithFailedPatches(v int64) *DescribePatchGroupStateOutput { s.InstancesWithFailedPatches = &v @@ -25851,6 +25968,18 @@ func (s *DescribePatchGroupStateOutput) SetInstancesWithNotApplicablePatches(v i return s } +// SetInstancesWithOtherNonCompliantPatches sets the InstancesWithOtherNonCompliantPatches field's value. +func (s *DescribePatchGroupStateOutput) SetInstancesWithOtherNonCompliantPatches(v int64) *DescribePatchGroupStateOutput { + s.InstancesWithOtherNonCompliantPatches = &v + return s +} + +// SetInstancesWithSecurityNonCompliantPatches sets the InstancesWithSecurityNonCompliantPatches field's value. +func (s *DescribePatchGroupStateOutput) SetInstancesWithSecurityNonCompliantPatches(v int64) *DescribePatchGroupStateOutput { + s.InstancesWithSecurityNonCompliantPatches = &v + return s +} + // SetInstancesWithUnreportedNotApplicablePatches sets the InstancesWithUnreportedNotApplicablePatches field's value. func (s *DescribePatchGroupStateOutput) SetInstancesWithUnreportedNotApplicablePatches(v int64) *DescribePatchGroupStateOutput { s.InstancesWithUnreportedNotApplicablePatches = &v @@ -28044,19 +28173,25 @@ type GetCommandInvocationInput struct { CommandId *string `min:"36" type:"string" required:"true"` // (Required) The ID of the managed instance targeted by the command. A managed - // instance can be an EC2 instance or an instance in your hybrid environment - // that is configured for Systems Manager. + // instance can be an Amazon Elastic Compute Cloud (Amazon EC2) instance or + // an instance in your hybrid environment that is configured for AWS Systems + // Manager. // // InstanceId is a required field InstanceId *string `type:"string" required:"true"` // The name of the plugin for which you want detailed results. If the document - // contains only one plugin, you can omit the name and details for that plugin - // are returned. If the document contains more than one plugin, you must specify - // the name of the plugin for which you want to view details. + // contains only one plugin, you can omit the name and details for that plugin. + // If the document contains more than one plugin, you must specify the name + // of the plugin for which you want to view details. // // Plugin names are also referred to as step names in Systems Manager documents. // For example, aws:RunShellScript is a plugin. + // + // To find the PluginName, check the document content and find the name of the + // plugin. Alternatively, use ListCommandInvocations with the CommandId and + // Details parameters. The PluginName is the Name attribute of the CommandPlugin + // object in the CommandPlugins list. PluginName *string `min:"4" type:"string"` } @@ -28131,7 +28266,7 @@ type GetCommandInvocationOutput struct { // Duration since ExecutionStartDateTime. ExecutionElapsedTime *string `type:"string"` - // The date and time the plugin was finished running. Date and time are written + // The date and time the plugin finished running. Date and time are written // in ISO 8601 format. For example, June 7, 2017 is represented as 2017-06-7. // The following sample AWS CLI command uses the InvokedAfter filter. // @@ -28176,8 +28311,9 @@ type GetCommandInvocationOutput struct { // then this string is empty. StandardOutputContent *string `type:"string"` - // The URL for the complete text written by the plugin to stdout in Amazon S3. - // If an S3 bucket was not specified, then this string is empty. + // The URL for the complete text written by the plugin to stdout in Amazon Simple + // Storage Service (Amazon S3). If an S3 bucket was not specified, then this + // string is empty. StandardOutputUrl *string `type:"string"` // The status of this invocation plugin. This status can be different than StatusDetails. @@ -31946,6 +32082,13 @@ type InstancePatchState struct { // BaselineId is a required field BaselineId *string `min:"20" type:"string" required:"true"` + // The number of instances where patches that are specified as "Critical" for + // compliance reporting in the patch baseline are not installed. These patches + // might be missing, have failed installation, were rejected, or were installed + // but awaiting a required instance reboot. The status of these instances is + // NON_COMPLIANT. + CriticalNonCompliantCount *int64 `type:"integer"` + // The number of patches from the patch baseline that were attempted to be installed // during the last patching operation, but failed to install. FailedCount *int64 `type:"integer"` @@ -32015,6 +32158,11 @@ type InstancePatchState struct { // OperationStartTime is a required field OperationStartTime *time.Time `type:"timestamp" required:"true"` + // The number of instances with patches installed that are specified as other + // than "Critical" or "Security" but are not compliant with the patch baseline. + // The status of these instances is NON_COMPLIANT. + OtherNonCompliantCount *int64 `type:"integer"` + // Placeholder information. This field will always be empty in the current release // of the service. OwnerInformation *string `min:"1" type:"string" sensitive:"true"` @@ -32038,6 +32186,12 @@ type InstancePatchState struct { // until a reboot is performed. RebootOption *string `type:"string" enum:"RebootOption"` + // The number of instances where patches that are specified as "Security" in + // a patch advisory are not installed. These patches might be missing, have + // failed installation, were rejected, or were installed but awaiting a required + // instance reboot. The status of these instances is NON_COMPLIANT. + SecurityNonCompliantCount *int64 `type:"integer"` + // The ID of the patch baseline snapshot used during the patching operation // when this compliance data was collected. SnapshotId *string `min:"36" type:"string"` @@ -32063,6 +32217,12 @@ func (s *InstancePatchState) SetBaselineId(v string) *InstancePatchState { return s } +// SetCriticalNonCompliantCount sets the CriticalNonCompliantCount field's value. +func (s *InstancePatchState) SetCriticalNonCompliantCount(v int64) *InstancePatchState { + s.CriticalNonCompliantCount = &v + return s +} + // SetFailedCount sets the FailedCount field's value. func (s *InstancePatchState) SetFailedCount(v int64) *InstancePatchState { s.FailedCount = &v @@ -32141,6 +32301,12 @@ func (s *InstancePatchState) SetOperationStartTime(v time.Time) *InstancePatchSt return s } +// SetOtherNonCompliantCount sets the OtherNonCompliantCount field's value. +func (s *InstancePatchState) SetOtherNonCompliantCount(v int64) *InstancePatchState { + s.OtherNonCompliantCount = &v + return s +} + // SetOwnerInformation sets the OwnerInformation field's value. func (s *InstancePatchState) SetOwnerInformation(v string) *InstancePatchState { s.OwnerInformation = &v @@ -32159,6 +32325,12 @@ func (s *InstancePatchState) SetRebootOption(v string) *InstancePatchState { return s } +// SetSecurityNonCompliantCount sets the SecurityNonCompliantCount field's value. +func (s *InstancePatchState) SetSecurityNonCompliantCount(v int64) *InstancePatchState { + s.SecurityNonCompliantCount = &v + return s +} + // SetSnapshotId sets the SnapshotId field's value. func (s *InstancePatchState) SetSnapshotId(v string) *InstancePatchState { s.SnapshotId = &v @@ -36172,7 +36344,7 @@ type ListCommandInvocationsInput struct { CommandId *string `min:"36" type:"string"` // (Optional) If set this returns the response of the command executions and - // any command output. By default this is set to False. + // any command output. The default value is 'false'. Details *bool `type:"boolean"` // (Optional) One or more filters. Use a filter to return a more specific list @@ -43265,7 +43437,7 @@ type PutParameterInput struct { // Name is a required field Name *string `min:"1" type:"string" required:"true"` - // Overwrite an existing parameter. If not specified, will default to "false". + // Overwrite an existing parameter. The default value is 'false'. Overwrite *bool `type:"boolean"` // One or more policies to apply to a parameter. This action takes a JSON array. @@ -47056,6 +47228,11 @@ func (s *StartAutomationExecutionOutput) SetAutomationExecutionId(v string) *Sta type StartChangeRequestExecutionInput struct { _ struct{} `type:"structure"` + // User-provided details about the change. If no details are provided, content + // specified in the Template information section of the associated change template + // is added. + ChangeDetails *string `min:"1" type:"string"` + // The name of the change request associated with the runbook workflow to be // run. ChangeRequestName *string `min:"1" type:"string"` @@ -47085,6 +47262,11 @@ type StartChangeRequestExecutionInput struct { // Runbooks is a required field Runbooks []*Runbook `min:"1" type:"list" required:"true"` + // The time that the requester expects the runbook workflow related to the change + // request to complete. The time is an estimate only that the requester provides + // for reviewers. + ScheduledEndTime *time.Time `type:"timestamp"` + // The date and time specified in the change request to run the Automation runbooks. // // The Automation runbooks specified for the runbook workflow can't run until @@ -47116,6 +47298,9 @@ func (s StartChangeRequestExecutionInput) GoString() string { // Validate inspects the fields of the type to determine if they are valid. func (s *StartChangeRequestExecutionInput) Validate() error { invalidParams := request.ErrInvalidParams{Context: "StartChangeRequestExecutionInput"} + if s.ChangeDetails != nil && len(*s.ChangeDetails) < 1 { + invalidParams.Add(request.NewErrParamMinLen("ChangeDetails", 1)) + } if s.ChangeRequestName != nil && len(*s.ChangeRequestName) < 1 { invalidParams.Add(request.NewErrParamMinLen("ChangeRequestName", 1)) } @@ -47161,6 +47346,12 @@ func (s *StartChangeRequestExecutionInput) Validate() error { return nil } +// SetChangeDetails sets the ChangeDetails field's value. +func (s *StartChangeRequestExecutionInput) SetChangeDetails(v string) *StartChangeRequestExecutionInput { + s.ChangeDetails = &v + return s +} + // SetChangeRequestName sets the ChangeRequestName field's value. func (s *StartChangeRequestExecutionInput) SetChangeRequestName(v string) *StartChangeRequestExecutionInput { s.ChangeRequestName = &v @@ -47197,6 +47388,12 @@ func (s *StartChangeRequestExecutionInput) SetRunbooks(v []*Runbook) *StartChang return s } +// SetScheduledEndTime sets the ScheduledEndTime field's value. +func (s *StartChangeRequestExecutionInput) SetScheduledEndTime(v time.Time) *StartChangeRequestExecutionInput { + s.ScheduledEndTime = &v + return s +} + // SetScheduledTime sets the ScheduledTime field's value. func (s *StartChangeRequestExecutionInput) SetScheduledTime(v time.Time) *StartChangeRequestExecutionInput { s.ScheduledTime = &v @@ -48410,6 +48607,111 @@ func (s *TotalSizeLimitExceededException) RequestID() string { return s.RespMetadata.RequestID } +type UnlabelParameterVersionInput struct { + _ struct{} `type:"structure"` + + // One or more labels to delete from the specified parameter version. + // + // Labels is a required field + Labels []*string `min:"1" type:"list" required:"true"` + + // The parameter name of which you want to delete one or more labels. + // + // Name is a required field + Name *string `min:"1" type:"string" required:"true"` + + // The specific version of the parameter which you want to delete one or more + // labels from. If it is not present, the call will fail. + // + // ParameterVersion is a required field + ParameterVersion *int64 `type:"long" required:"true"` +} + +// String returns the string representation +func (s UnlabelParameterVersionInput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s UnlabelParameterVersionInput) GoString() string { + return s.String() +} + +// Validate inspects the fields of the type to determine if they are valid. +func (s *UnlabelParameterVersionInput) Validate() error { + invalidParams := request.ErrInvalidParams{Context: "UnlabelParameterVersionInput"} + if s.Labels == nil { + invalidParams.Add(request.NewErrParamRequired("Labels")) + } + if s.Labels != nil && len(s.Labels) < 1 { + invalidParams.Add(request.NewErrParamMinLen("Labels", 1)) + } + if s.Name == nil { + invalidParams.Add(request.NewErrParamRequired("Name")) + } + if s.Name != nil && len(*s.Name) < 1 { + invalidParams.Add(request.NewErrParamMinLen("Name", 1)) + } + if s.ParameterVersion == nil { + invalidParams.Add(request.NewErrParamRequired("ParameterVersion")) + } + + if invalidParams.Len() > 0 { + return invalidParams + } + return nil +} + +// SetLabels sets the Labels field's value. +func (s *UnlabelParameterVersionInput) SetLabels(v []*string) *UnlabelParameterVersionInput { + s.Labels = v + return s +} + +// SetName sets the Name field's value. +func (s *UnlabelParameterVersionInput) SetName(v string) *UnlabelParameterVersionInput { + s.Name = &v + return s +} + +// SetParameterVersion sets the ParameterVersion field's value. +func (s *UnlabelParameterVersionInput) SetParameterVersion(v int64) *UnlabelParameterVersionInput { + s.ParameterVersion = &v + return s +} + +type UnlabelParameterVersionOutput struct { + _ struct{} `type:"structure"` + + // The labels that are not attached to the given parameter version. + InvalidLabels []*string `min:"1" type:"list"` + + // A list of all labels deleted from the parameter. + RemovedLabels []*string `min:"1" type:"list"` +} + +// String returns the string representation +func (s UnlabelParameterVersionOutput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s UnlabelParameterVersionOutput) GoString() string { + return s.String() +} + +// SetInvalidLabels sets the InvalidLabels field's value. +func (s *UnlabelParameterVersionOutput) SetInvalidLabels(v []*string) *UnlabelParameterVersionOutput { + s.InvalidLabels = v + return s +} + +// SetRemovedLabels sets the RemovedLabels field's value. +func (s *UnlabelParameterVersionOutput) SetRemovedLabels(v []*string) *UnlabelParameterVersionOutput { + s.RemovedLabels = v + return s +} + // The calendar entry contained in the specified Systems Manager document is // not supported. type UnsupportedCalendarException struct { @@ -49300,9 +49602,9 @@ type UpdateDocumentInput struct { // supports JSON and YAML documents. JSON is the default format. DocumentFormat *string `type:"string" enum:"DocumentFormat"` - // (Required) The latest version of the document that you want to update. The - // latest document version can be specified using the $LATEST variable or by - // the version number. Updating a previous version of a document is not supported. + // The version of the document that you want to update. Currently, Systems Manager + // supports updating only the latest version of the document. You can specify + // the version number of the latest version or use the $LATEST variable. DocumentVersion *string `type:"string"` // The name of the document that you want to update. diff --git a/service/ssm/ssmiface/interface.go b/service/ssm/ssmiface/interface.go index 2a03444a37..d96b1465c7 100644 --- a/service/ssm/ssmiface/interface.go +++ b/service/ssm/ssmiface/interface.go @@ -663,6 +663,10 @@ type SSMAPI interface { TerminateSessionWithContext(aws.Context, *ssm.TerminateSessionInput, ...request.Option) (*ssm.TerminateSessionOutput, error) TerminateSessionRequest(*ssm.TerminateSessionInput) (*request.Request, *ssm.TerminateSessionOutput) + UnlabelParameterVersion(*ssm.UnlabelParameterVersionInput) (*ssm.UnlabelParameterVersionOutput, error) + UnlabelParameterVersionWithContext(aws.Context, *ssm.UnlabelParameterVersionInput, ...request.Option) (*ssm.UnlabelParameterVersionOutput, error) + UnlabelParameterVersionRequest(*ssm.UnlabelParameterVersionInput) (*request.Request, *ssm.UnlabelParameterVersionOutput) + UpdateAssociation(*ssm.UpdateAssociationInput) (*ssm.UpdateAssociationOutput, error) UpdateAssociationWithContext(aws.Context, *ssm.UpdateAssociationInput, ...request.Option) (*ssm.UpdateAssociationOutput, error) UpdateAssociationRequest(*ssm.UpdateAssociationInput) (*request.Request, *ssm.UpdateAssociationOutput)