Skip to content

Commit

Permalink
Merge branch 'release-1.29.44'
Browse files Browse the repository at this point in the history
* release-1.29.44:
  Bumping version to 1.29.44
  Update changelog based on model updates
  CLI examples configservice, ec2, pinpoint, payment-cryptography, payment-cryptography-data
  • Loading branch information
aws-sdk-python-automation committed Sep 8, 2023
2 parents 3bb6bcc + d070363 commit f5a2fbf
Show file tree
Hide file tree
Showing 50 changed files with 1,329 additions and 426 deletions.
22 changes: 22 additions & 0 deletions .changes/1.29.44.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,22 @@
[
{
"category": "``fsx``",
"description": "Amazon FSx documentation fixes",
"type": "api-change"
},
{
"category": "``sagemaker``",
"description": "Autopilot APIs will now support holiday featurization for Timeseries models. The models will now hold holiday metadata and should be able to accommodate holiday effect during inference.",
"type": "api-change"
},
{
"category": "``sso-admin``",
"description": "Content updates to IAM Identity Center API for China Regions.",
"type": "api-change"
},
{
"category": "``workspaces``",
"description": "A new field \"ErrorDetails\" will be added to the output of \"DescribeWorkspaceImages\" API call. This field provides in-depth details about the error occurred during image import process. These details include the possible causes of the errors and troubleshooting information.",
"type": "api-change"
}
]
9 changes: 9 additions & 0 deletions CHANGELOG.rst
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,15 @@
CHANGELOG
=========

1.29.44
=======

* api-change:``fsx``: Amazon FSx documentation fixes
* api-change:``sagemaker``: Autopilot APIs will now support holiday featurization for Timeseries models. The models will now hold holiday metadata and should be able to accommodate holiday effect during inference.
* api-change:``sso-admin``: Content updates to IAM Identity Center API for China Regions.
* api-change:``workspaces``: A new field "ErrorDetails" will be added to the output of "DescribeWorkspaceImages" API call. This field provides in-depth details about the error occurred during image import process. These details include the possible causes of the errors and troubleshooting information.


1.29.43
=======

Expand Down
2 changes: 1 addition & 1 deletion awscli/__init__.py
Original file line number Diff line number Diff line change
Expand Up @@ -17,7 +17,7 @@
"""
import os

__version__ = '1.29.43'
__version__ = '1.29.44'

#
# Get our data path to be added to botocore's search path
Expand Down
73 changes: 56 additions & 17 deletions awscli/examples/configservice/put-configuration-recorder.rst
Original file line number Diff line number Diff line change
@@ -1,35 +1,74 @@
**To record all supported resources**
**Example 1: To record all supported resources**

The following command creates a configuration recorder that tracks changes to all supported resource types, including global resource types::

aws configservice put-configuration-recorder --configuration-recorder name=default,roleARN=arn:aws:iam::123456789012:role/config-role --recording-group allSupported=true,includeGlobalResourceTypes=true
aws configservice put-configuration-recorder \
--configuration-recorder name=default,roleARN=arn:aws:iam::123456789012:role/config-role \
--recording-group allSupported=true,includeGlobalResourceTypes=true

**To record specific types of resources**
If the command succeeds, AWS Config returns no output. To verify the settings of your configuration recorder, run the `describe-configuration-recorders`__ command.

.. __: http://docs.aws.amazon.com/cli/latest/reference/configservice/describe-configuration-recorders.html

**Example 2: To record specific types of resources**

The following command creates a configuration recorder that tracks changes to only those types of resources that are specified in the JSON file for the `--recording-group` option::

aws configservice put-configuration-recorder --configuration-recorder name=default,roleARN=arn:aws:iam::123456789012:role/config-role --recording-group file://recordingGroup.json
aws configservice put-configuration-recorder \
--configuration-recorder name=default,roleARN=arn:aws:iam::123456789012:role/config-role \
--recording-group file://recordingGroup.json

`recordingGroup.json` is a JSON file that specifies the types of resources that AWS Config will record::

{
"allSupported": false,
"includeGlobalResourceTypes": false,
"resourceTypes": [
"AWS::EC2::EIP",
"AWS::EC2::Instance",
"AWS::EC2::NetworkAcl",
"AWS::EC2::SecurityGroup",
"AWS::CloudTrail::Trail",
"AWS::EC2::Volume",
"AWS::EC2::VPC",
"AWS::IAM::User",
"AWS::IAM::Policy"
]
"allSupported": false,
"includeGlobalResourceTypes": false,
"resourceTypes": [
"AWS::EC2::EIP",
"AWS::EC2::Instance",
"AWS::EC2::NetworkAcl",
"AWS::EC2::SecurityGroup",
"AWS::CloudTrail::Trail",
"AWS::EC2::Volume",
"AWS::EC2::VPC",
"AWS::IAM::User",
"AWS::IAM::Policy"
]
}

Before you can specify resource types for the `resourceTypes` key, you must set the `allSupported` and `includeGlobalResourceTypes` options to false or omit them.

If the command succeeds, AWS Config returns no output. To verify the settings of your configuration recorder, run the `describe-configuration-recorders`__ command.

.. __: http://docs.aws.amazon.com/cli/latest/reference/configservice/describe-configuration-recorders.html

**Example 3: To select all supported resources excluding specific types of resources**

The following command creates a configuration recorder that tracks changes to all current and future supported resource types excluding those types of resources that are specified in the JSON file for the `--recording-group` option::

aws configservice put-configuration-recorder \
--configuration-recorder name=default,roleARN=arn:aws:iam::123456789012:role/config-role \
--recording-group file://recordingGroup.json

`recordingGroup.json` is a JSON file that specifies the types of resources that AWS Config will record::

{
"allSupported": false,
"exclusionByResourceTypes": {
"resourceTypes": [
"AWS::Redshift::ClusterSnapshot",
"AWS::RDS::DBClusterSnapshot",
"AWS::CloudFront::StreamingDistribution"
]
},
"includeGlobalResourceTypes": false,
"recordingStrategy": {
"useOnly": "EXCLUSION_BY_RESOURCE_TYPES"
},
}

Before you can specify resource types to excluding from recording: 1) You must set the allSupported and includeGlobalResourceTypes options to false or omit them, and 2) You must set the useOnly field of RecordingStrategy to EXCLUSION_BY_RESOURCE_TYPES.

If the command succeeds, AWS Config returns no output. To verify the settings of your configuration recorder, run the `describe-configuration-recorders`__ command.

.. __: http://docs.aws.amazon.com/cli/latest/reference/configservice/describe-configuration-recorders.html
152 changes: 76 additions & 76 deletions awscli/examples/ec2/describe-capacity-reservations.rst
Original file line number Diff line number Diff line change
@@ -1,76 +1,76 @@
**Example 1: To describe one or more of your capacity reservations**

The following ``describe-capacity-reservations`` example displays details about all of your capacity reservations in the current AWS Region. ::

aws ec2 describe-capacity-reservations

Output::

{
"CapacityReservations": [
{
"CapacityReservationId": "cr-1234abcd56EXAMPLE ",
"EndDateType": "unlimited",
"AvailabilityZone": "eu-west-1a",
"InstanceMatchCriteria": "open",
"Tags": [],
"EphemeralStorage": false,
"CreateDate": "2019-08-16T09:03:18.000Z",
"AvailableInstanceCount": 1,
"InstancePlatform": "Linux/UNIX",
"TotalInstanceCount": 1,
"State": "active",
"Tenancy": "default",
"EbsOptimized": true,
"InstanceType": "a1.medium"
},
{
"CapacityReservationId": "cr-abcdEXAMPLE9876ef ",
"EndDateType": "unlimited",
"AvailabilityZone": "eu-west-1a",
"InstanceMatchCriteria": "open",
"Tags": [],
"EphemeralStorage": false,
"CreateDate": "2019-08-07T11:34:19.000Z",
"AvailableInstanceCount": 3,
"InstancePlatform": "Linux/UNIX",
"TotalInstanceCount": 3,
"State": "cancelled",
"Tenancy": "default",
"EbsOptimized": true,
"InstanceType": "m5.large"
}
]
}

**Example 2: To describe one or more of your capacity reservations**

The following ``describe-capacity-reservations`` example displays details about the specified capacity reservation. ::

aws ec2 describe-capacity-reservations \
--capacity-reservation-id cr-1234abcd56EXAMPLE

Output::

{
"CapacityReservations": [
{
"CapacityReservationId": "cr-1234abcd56EXAMPLE",
"EndDateType": "unlimited",
"AvailabilityZone": "eu-west-1a",
"InstanceMatchCriteria": "open",
"Tags": [],
"EphemeralStorage": false,
"CreateDate": "2019-08-16T09:03:18.000Z",
"AvailableInstanceCount": 1,
"InstancePlatform": "Linux/UNIX",
"TotalInstanceCount": 1,
"State": "active",
"Tenancy": "default",
"EbsOptimized": true,
"InstanceType": "a1.medium"
}
]
}

For more information, see `Viewing a Capacity Reservation <https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/capacity-reservations-using.html#capacity-reservations-view>`__ in the *Amazon Elastic Compute Cloud User Guide for Linux Instances*.
**Example 1: To describe one or more of your capacity reservations**

The following ``describe-capacity-reservations`` example displays details about all of your capacity reservations in the current AWS Region. ::

aws ec2 describe-capacity-reservations

Output::

{
"CapacityReservations": [
{
"CapacityReservationId": "cr-1234abcd56EXAMPLE ",
"EndDateType": "unlimited",
"AvailabilityZone": "eu-west-1a",
"InstanceMatchCriteria": "open",
"Tags": [],
"EphemeralStorage": false,
"CreateDate": "2019-08-16T09:03:18.000Z",
"AvailableInstanceCount": 1,
"InstancePlatform": "Linux/UNIX",
"TotalInstanceCount": 1,
"State": "active",
"Tenancy": "default",
"EbsOptimized": true,
"InstanceType": "a1.medium"
},
{
"CapacityReservationId": "cr-abcdEXAMPLE9876ef ",
"EndDateType": "unlimited",
"AvailabilityZone": "eu-west-1a",
"InstanceMatchCriteria": "open",
"Tags": [],
"EphemeralStorage": false,
"CreateDate": "2019-08-07T11:34:19.000Z",
"AvailableInstanceCount": 3,
"InstancePlatform": "Linux/UNIX",
"TotalInstanceCount": 3,
"State": "cancelled",
"Tenancy": "default",
"EbsOptimized": true,
"InstanceType": "m5.large"
}
]
}

**Example 2: To describe one or more of your capacity reservations**

The following ``describe-capacity-reservations`` example displays details about the specified capacity reservation. ::

aws ec2 describe-capacity-reservations \
--capacity-reservation-ids cr-1234abcd56EXAMPLE

Output::

{
"CapacityReservations": [
{
"CapacityReservationId": "cr-1234abcd56EXAMPLE",
"EndDateType": "unlimited",
"AvailabilityZone": "eu-west-1a",
"InstanceMatchCriteria": "open",
"Tags": [],
"EphemeralStorage": false,
"CreateDate": "2019-08-16T09:03:18.000Z",
"AvailableInstanceCount": 1,
"InstancePlatform": "Linux/UNIX",
"TotalInstanceCount": 1,
"State": "active",
"Tenancy": "default",
"EbsOptimized": true,
"InstanceType": "a1.medium"
}
]
}

For more information, see `Viewing a Capacity Reservation <https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/capacity-reservations-using.html#capacity-reservations-view>`__ in the *Amazon Elastic Compute Cloud User Guide for Linux Instances*.
10 changes: 6 additions & 4 deletions awscli/examples/ec2/describe-export-image-tasks.rst
Original file line number Diff line number Diff line change
@@ -1,11 +1,11 @@
**To monitor an export image task**

The following ``describe-export-image-tasks`` example checks the status of the specified export image task. ::
The following ``describe-export-image-tasks`` example checks the status of the specified export image task. The resulting image file in Amazon S3 is ``my-export-bucket/exports/export-ami-1234567890abcdef0.vmdk``. ::

aws ec2 describe-export-image-tasks \
--export-image-task-id export-ami-1234567890abcdef0
--export-image-task-ids export-ami-1234567890abcdef0

Output for an export image task that is in progress::
Output for an export image task that is in progress. ::

{
"ExportImageTasks": [
Expand All @@ -22,7 +22,7 @@ Output for an export image task that is in progress::
]
}

Output for an export image task that is completed. The resulting image file in Amazon S3 is ``my-export-bucket/exports/export-ami-1234567890abcdef0.vmdk``. ::
Output for an export image task that is completed. ::

{
"ExportImageTasks": [
Expand All @@ -36,3 +36,5 @@ Output for an export image task that is completed. The resulting image file in A
}
]
}

For more information, see `Export a VM from an AMI <https://docs.aws.amazon.com/vm-import/latest/userguide/vmexport_image.html>`__ in the *VM Import/Export User Guide*.
2 changes: 1 addition & 1 deletion awscli/examples/ec2/describe-fleet-history.rst
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@
The following ``describe-fleet-history`` example returns the history for the specified EC2 Fleet starting at the specified time. The output is for an EC2 Fleet with two running instances. ::

aws ec2 describe-fleet-history \
--fleet-ids fleet-12a34b55-67cd-8ef9-ba9b-9208dEXAMPLE \
--fleet-id fleet-12a34b55-67cd-8ef9-ba9b-9208dEXAMPLE \
--start-time 2020-09-01T00:00:00Z

Output::
Expand Down
37 changes: 19 additions & 18 deletions awscli/examples/ec2/describe-instance-credit-specifications.rst
Original file line number Diff line number Diff line change
@@ -1,18 +1,19 @@
**To describe the credit option for CPU usage of one or more instances**

This example describes the current credit option for CPU usage of the specified instance.

Command::

aws ec2 describe-instance-credit-specifications --instance-id i-1234567890abcdef0

Output::

{
"InstanceCreditSpecifications": [
{
"InstanceId": "i-1234567890abcdef0",
"CpuCredits": "unlimited"
}
]
}
**To describe the credit option for CPU usage of one or more instances**

The following ``describe-instance-credit-specifications`` example describes the CPU credit option for the specified instance. ::

aws ec2 describe-instance-credit-specifications \
--instance-ids i-1234567890abcdef0

Output::

{
"InstanceCreditSpecifications": [
{
"InstanceId": "i-1234567890abcdef0",
"CpuCredits": "unlimited"
}
]
}

For more information, see `Work with burstable performance instances <https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/burstable-performance-instances-how-to.html>`__ in the *Amazon EC2 User Guide*.
Loading

0 comments on commit f5a2fbf

Please sign in to comment.