diff --git a/.changes/2.1339.0.json b/.changes/2.1339.0.json new file mode 100644 index 0000000000..a0cbd20cf3 --- /dev/null +++ b/.changes/2.1339.0.json @@ -0,0 +1,22 @@ +[ + { + "type": "feature", + "category": "ApplicationAutoScaling", + "description": "With this release customers can now tag their Application Auto Scaling registered targets with key-value pairs and manage IAM permissions for all the tagged resources centrally." + }, + { + "type": "feature", + "category": "Neptune", + "description": "This release makes following few changes. db-cluster-identifier is now a required parameter of create-db-instance. describe-db-cluster will now return PendingModifiedValues and GlobalClusterIdentifier fields in the response." + }, + { + "type": "feature", + "category": "S3Outposts", + "description": "S3 On Outposts added support for endpoint status, and a failed endpoint reason, if any" + }, + { + "type": "feature", + "category": "WorkDocs", + "description": "This release adds a new API, SearchResources, which enable users to search through metadata and content of folders, documents, document versions and comments in a WorkDocs site." + } +] \ No newline at end of file diff --git a/CHANGELOG.md b/CHANGELOG.md index 8eb2fa69cd..4960b4d674 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,7 +1,13 @@ # Changelog for AWS SDK for JavaScript - + +## 2.1339.0 +* feature: ApplicationAutoScaling: With this release customers can now tag their Application Auto Scaling registered targets with key-value pairs and manage IAM permissions for all the tagged resources centrally. +* feature: Neptune: This release makes following few changes. db-cluster-identifier is now a required parameter of create-db-instance. describe-db-cluster will now return PendingModifiedValues and GlobalClusterIdentifier fields in the response. +* feature: S3Outposts: S3 On Outposts added support for endpoint status, and a failed endpoint reason, if any +* feature: WorkDocs: This release adds a new API, SearchResources, which enable users to search through metadata and content of folders, documents, document versions and comments in a WorkDocs site. + ## 2.1338.0 * feature: Billingconductor: This release adds a new filter to ListAccountAssociations API and a new filter to ListBillingGroups API. * feature: ConfigService: This release adds resourceType enums for types released from October 2022 through February 2023. diff --git a/README.md b/README.md index d92999c7ec..ecfb81cf38 100644 --- a/README.md +++ b/README.md @@ -70,7 +70,7 @@ require('aws-sdk/lib/maintenance_mode_message').suppress = true; To use the SDK in the browser, simply add the following script tag to your HTML pages: - + You can also build a custom browser SDK with your specified set of AWS services. This can allow you to reduce the SDK's size, specify different API versions of diff --git a/apis/application-autoscaling-2016-02-06.examples.json b/apis/application-autoscaling-2016-02-06.examples.json index 5abcd5544a..86eca052d8 100644 --- a/apis/application-autoscaling-2016-02-06.examples.json +++ b/apis/application-autoscaling-2016-02-06.examples.json @@ -22,6 +22,27 @@ "title": "To delete a scaling policy" } ], + "DeleteScheduledAction": [ + { + "input": { + "ResourceId": "fleet/sample-fleet", + "ScalableDimension": "appstream:fleet:DesiredCapacity", + "ScheduledActionName": "my-recurring-action", + "ServiceNamespace": "appstream" + }, + "output": { + }, + "comments": { + "input": { + }, + "output": { + } + }, + "description": "This example deletes a scheduled action for the AppStream 2.0 fleet called sample-fleet.", + "id": "to-delete-a-scheduled-action-1677963329606", + "title": "To delete a scheduled action" + } + ], "DeregisterScalableTarget": [ { "input": { @@ -156,6 +177,73 @@ "title": "To describe scaling policies" } ], + "DescribeScheduledActions": [ + { + "input": { + "ServiceNamespace": "dynamodb" + }, + "output": { + "ScheduledActions": [ + { + "CreationTime": 1561571888.361, + "ResourceId": "table/my-table", + "ScalableDimension": "dynamodb:table:WriteCapacityUnits", + "ScalableTargetAction": { + "MaxCapacity": 20, + "MinCapacity": 15 + }, + "Schedule": "at(2019-05-20T18:35:00)", + "ScheduledActionARN": "arn:aws:autoscaling:us-west-2:123456789012:scheduledAction:2d36aa3b-cdf9-4565-b290-81db519b227d:resource/dynamodb/table/my-table:scheduledActionName/my-first-scheduled-action", + "ScheduledActionName": "my-first-scheduled-action", + "ServiceNamespace": "dynamodb" + }, + { + "CreationTime": 1561571946.021, + "ResourceId": "table/my-table", + "ScalableDimension": "dynamodb:table:WriteCapacityUnits", + "ScalableTargetAction": { + "MaxCapacity": 10, + "MinCapacity": 5 + }, + "Schedule": "at(2019-05-20T18:40:00)", + "ScheduledActionARN": "arn:aws:autoscaling:us-west-2:123456789012:scheduledAction:2d36aa3b-cdf9-4565-b290-81db519b227d:resource/dynamodb/table/my-table:scheduledActionName/my-second-scheduled-action", + "ScheduledActionName": "my-second-scheduled-action", + "ServiceNamespace": "dynamodb" + } + ] + }, + "comments": { + "input": { + }, + "output": { + } + }, + "description": "This example describes the scheduled actions for the dynamodb service namespace.", + "id": "to-describe-scheduled-actions-1677965249349", + "title": "To describe scheduled actions" + } + ], + "ListTagsForResource": [ + { + "input": { + "ResourceARN": "arn:aws:application-autoscaling:us-west-2:123456789012:scalable-target/1234abcd56ab78cd901ef1234567890ab123" + }, + "output": { + "Tags": { + "environment": "production" + } + }, + "comments": { + "input": { + }, + "output": { + } + }, + "description": "This example lists the tag key names and values that are attached to the scalable target specified by its ARN.", + "id": "to-list-tags-for-a-scalable-target-1677971474903", + "title": "To list tags for a scalable target" + } + ], "PutScalingPolicy": [ { "input": { @@ -197,6 +285,31 @@ "title": "To apply a target tracking scaling policy with a predefined metric specification" } ], + "PutScheduledAction": [ + { + "input": { + "ResourceId": "table/TestTable", + "ScalableDimension": "dynamodb:table:WriteCapacityUnits", + "ScalableTargetAction": { + "MinCapacity": 6 + }, + "Schedule": "cron(15 12 * * ? *)", + "ScheduledActionName": "my-recurring-action", + "ServiceNamespace": "dynamodb" + }, + "output": { + }, + "comments": { + "input": { + }, + "output": { + } + }, + "description": "This example adds a scheduled action to a DynamoDB table called TestTable to scale out on a recurring schedule. On the specified schedule (every day at 12:15pm UTC), if the current capacity is below the value specified for MinCapacity, Application Auto Scaling scales out to the value specified by MinCapacity.", + "id": "to-create-a-recurring-scheduled-action-1677970068621", + "title": "To create a recurring scheduled action" + } + ], "RegisterScalableTarget": [ { "input": { @@ -216,6 +329,48 @@ "id": "to-register-a-new-scalable-target-1470864910380", "title": "To register an ECS service as a scalable target" } + ], + "TagResource": [ + { + "input": { + "ResourceARN": "arn:aws:application-autoscaling:us-west-2:123456789012:scalable-target/1234abcd56ab78cd901ef1234567890ab123", + "Tags": { + "environment": "production" + } + }, + "output": { + }, + "comments": { + "input": { + }, + "output": { + } + }, + "description": "This example adds a tag with the key name \"environment\" and the value \"production\" to the scalable target specified by its ARN.", + "id": "to-add-a-tag-to-a-scalable-target-1677970764620", + "title": "To add a tag to a scalable target" + } + ], + "UntagResource": [ + { + "input": { + "ResourceARN": "arn:aws:application-autoscaling:us-west-2:123456789012:scalable-target/1234abcd56ab78cd901ef1234567890ab123", + "TagKeys": [ + "environment" + ] + }, + "output": { + }, + "comments": { + "input": { + }, + "output": { + } + }, + "description": "This example removes the tag pair with the key name \"environment\" from the scalable target specified by its ARN.", + "id": "to-remove-a-tag-from-a-scalable-target-1677971117168", + "title": "To remove a tag from a scalable target" + } ] } } diff --git a/apis/application-autoscaling-2016-02-06.min.json b/apis/application-autoscaling-2016-02-06.min.json index e999181e1e..239d091a9e 100644 --- a/apis/application-autoscaling-2016-02-06.min.json +++ b/apis/application-autoscaling-2016-02-06.min.json @@ -124,7 +124,8 @@ }, "SuspendedState": { "shape": "Sj" - } + }, + "ScalableTargetARN": {} } } }, @@ -334,6 +335,25 @@ } } }, + "ListTagsForResource": { + "input": { + "type": "structure", + "required": [ + "ResourceARN" + ], + "members": { + "ResourceARN": {} + } + }, + "output": { + "type": "structure", + "members": { + "Tags": { + "shape": "S2c" + } + } + } + }, "PutScalingPolicy": { "input": { "type": "structure", @@ -423,6 +443,50 @@ "RoleARN": {}, "SuspendedState": { "shape": "Sj" + }, + "Tags": { + "shape": "S2c" + } + } + }, + "output": { + "type": "structure", + "members": { + "ScalableTargetARN": {} + } + } + }, + "TagResource": { + "input": { + "type": "structure", + "required": [ + "ResourceARN", + "Tags" + ], + "members": { + "ResourceARN": {}, + "Tags": { + "shape": "S2c" + } + } + }, + "output": { + "type": "structure", + "members": {} + } + }, + "UntagResource": { + "input": { + "type": "structure", + "required": [ + "ResourceARN", + "TagKeys" + ], + "members": { + "ResourceARN": {}, + "TagKeys": { + "type": "list", + "member": {} } } }, @@ -610,6 +674,11 @@ "type": "integer" } } + }, + "S2c": { + "type": "map", + "key": {}, + "value": {} } } } \ No newline at end of file diff --git a/apis/application-autoscaling-2016-02-06.normal.json b/apis/application-autoscaling-2016-02-06.normal.json index 17ee59d16d..1ca2c928f7 100644 --- a/apis/application-autoscaling-2016-02-06.normal.json +++ b/apis/application-autoscaling-2016-02-06.normal.json @@ -212,6 +212,25 @@ ], "documentation": "
Describes the Application Auto Scaling scheduled actions for the specified service namespace.
You can filter the results using the ResourceId
, ScalableDimension
, and ScheduledActionNames
parameters.
For more information, see Scheduled scaling and Managing scheduled scaling in the Application Auto Scaling User Guide.
" }, + "ListTagsForResource": { + "name": "ListTagsForResource", + "http": { + "method": "POST", + "requestUri": "/" + }, + "input": { + "shape": "ListTagsForResourceRequest" + }, + "output": { + "shape": "ListTagsForResourceResponse" + }, + "errors": [ + { + "shape": "ResourceNotFoundException" + } + ], + "documentation": "Returns all the tags on the specified Application Auto Scaling scalable target.
For general information about tags, including the format and syntax, see Tagging Amazon Web Services resources in the Amazon Web Services General Reference.
" + }, "PutScalingPolicy": { "name": "PutScalingPolicy", "http": { @@ -244,7 +263,7 @@ "shape": "InternalServiceException" } ], - "documentation": "Creates or updates a scaling policy for an Application Auto Scaling scalable target.
Each scalable target is identified by a service namespace, resource ID, and scalable dimension. A scaling policy applies to the scalable target identified by those three attributes. You cannot create a scaling policy until you have registered the resource as a scalable target.
Multiple scaling policies can be in force at the same time for the same scalable target. You can have one or more target tracking scaling policies, one or more step scaling policies, or both. However, there is a chance that multiple policies could conflict, instructing the scalable target to scale out or in at the same time. Application Auto Scaling gives precedence to the policy that provides the largest capacity for both scale out and scale in. For example, if one policy increases capacity by 3, another policy increases capacity by 200 percent, and the current capacity is 10, Application Auto Scaling uses the policy with the highest calculated capacity (200% of 10 = 20) and scales out to 30.
We recommend caution, however, when using target tracking scaling policies with step scaling policies because conflicts between these policies can cause undesirable behavior. For example, if the step scaling policy initiates a scale-in activity before the target tracking policy is ready to scale in, the scale-in activity will not be blocked. After the scale-in activity completes, the target tracking policy could instruct the scalable target to scale out again.
For more information, see Target tracking scaling policies and Step scaling policies in the Application Auto Scaling User Guide.
If a scalable target is deregistered, the scalable target is no longer available to execute scaling policies. Any scaling policies that were specified for the scalable target are deleted.
Creates or updates a scaling policy for an Application Auto Scaling scalable target.
Each scalable target is identified by a service namespace, resource ID, and scalable dimension. A scaling policy applies to the scalable target identified by those three attributes. You cannot create a scaling policy until you have registered the resource as a scalable target.
Multiple scaling policies can be in force at the same time for the same scalable target. You can have one or more target tracking scaling policies, one or more step scaling policies, or both. However, there is a chance that multiple policies could conflict, instructing the scalable target to scale out or in at the same time. Application Auto Scaling gives precedence to the policy that provides the largest capacity for both scale out and scale in. For example, if one policy increases capacity by 3, another policy increases capacity by 200 percent, and the current capacity is 10, Application Auto Scaling uses the policy with the highest calculated capacity (200% of 10 = 20) and scales out to 30.
We recommend caution, however, when using target tracking scaling policies with step scaling policies because conflicts between these policies can cause undesirable behavior. For example, if the step scaling policy initiates a scale-in activity before the target tracking policy is ready to scale in, the scale-in activity will not be blocked. After the scale-in activity completes, the target tracking policy could instruct the scalable target to scale out again.
For more information, see Target tracking scaling policies and Step scaling policies in the Application Auto Scaling User Guide.
If a scalable target is deregistered, the scalable target is no longer available to use scaling policies. Any scaling policies that were specified for the scalable target are deleted.
Creates or updates a scheduled action for an Application Auto Scaling scalable target.
Each scalable target is identified by a service namespace, resource ID, and scalable dimension. A scheduled action applies to the scalable target identified by those three attributes. You cannot create a scheduled action until you have registered the resource as a scalable target.
When start and end times are specified with a recurring schedule using a cron expression or rates, they form the boundaries for when the recurring action starts and stops.
To update a scheduled action, specify the parameters that you want to change. If you don't specify start and end times, the old values are deleted.
For more information, see Scheduled scaling in the Application Auto Scaling User Guide.
If a scalable target is deregistered, the scalable target is no longer available to run scheduled actions. Any scheduled actions that were specified for the scalable target are deleted.
Creates or updates a scheduled action for an Application Auto Scaling scalable target.
Each scalable target is identified by a service namespace, resource ID, and scalable dimension. A scheduled action applies to the scalable target identified by those three attributes. You cannot create a scheduled action until you have registered the resource as a scalable target.
When you specify start and end times with a recurring schedule using a cron expression or rates, they form the boundaries for when the recurring action starts and stops.
To update a scheduled action, specify the parameters that you want to change. If you don't specify start and end times, the old values are deleted.
For more information, see Scheduled scaling in the Application Auto Scaling User Guide.
If a scalable target is deregistered, the scalable target is no longer available to run scheduled actions. Any scheduled actions that were specified for the scalable target are deleted.
Registers or updates a scalable target, the resource that you want to scale.
Scalable targets are uniquely identified by the combination of resource ID, scalable dimension, and namespace, which represents some capacity dimension of the underlying service.
When you register a new scalable target, you must specify values for the minimum and maximum capacity. If the specified resource is not active in the target service, this operation does not change the resource's current capacity. Otherwise, it changes the resource's current capacity to a value that is inside of this range.
If you choose to add a scaling policy, current capacity is adjustable within the specified range when scaling starts. Application Auto Scaling scaling policies will not scale capacity to values that are outside of the minimum and maximum range.
After you register a scalable target, you do not need to register it again to use other Application Auto Scaling operations. To see which resources have been registered, use DescribeScalableTargets. You can also view the scaling policies for a service namespace by using DescribeScalableTargets. If you no longer need a scalable target, you can deregister it by using DeregisterScalableTarget.
To update a scalable target, specify the parameters that you want to change. Include the parameters that identify the scalable target: resource ID, scalable dimension, and namespace. Any parameters that you don't specify are not changed by this update request.
If you call the RegisterScalableTarget
API to update an existing scalable target, Application Auto Scaling retrieves the current capacity of the resource. If it is below the minimum capacity or above the maximum capacity, Application Auto Scaling adjusts the capacity of the scalable target to place it within these bounds, even if you don't include the MinCapacity
or MaxCapacity
request parameters.
Registers or updates a scalable target, which is the resource that you want to scale.
Scalable targets are uniquely identified by the combination of resource ID, scalable dimension, and namespace, which represents some capacity dimension of the underlying service.
When you register a new scalable target, you must specify values for the minimum and maximum capacity. If the specified resource is not active in the target service, this operation does not change the resource's current capacity. Otherwise, it changes the resource's current capacity to a value that is inside of this range.
If you add a scaling policy, current capacity is adjustable within the specified range when scaling starts. Application Auto Scaling scaling policies will not scale capacity to values that are outside of the minimum and maximum range.
After you register a scalable target, you do not need to register it again to use other Application Auto Scaling operations. To see which resources have been registered, use DescribeScalableTargets. You can also view the scaling policies for a service namespace by using DescribeScalableTargets. If you no longer need a scalable target, you can deregister it by using DeregisterScalableTarget.
To update a scalable target, specify the parameters that you want to change. Include the parameters that identify the scalable target: resource ID, scalable dimension, and namespace. Any parameters that you don't specify are not changed by this update request.
If you call the RegisterScalableTarget
API operation to create a scalable target, there might be a brief delay until the operation achieves eventual consistency. You might become aware of this brief delay if you get unexpected errors when performing sequential operations. The typical strategy is to retry the request, and some Amazon Web Services SDKs include automatic backoff and retry logic.
If you call the RegisterScalableTarget
API operation to update an existing scalable target, Application Auto Scaling retrieves the current capacity of the resource. If it's below the minimum capacity or above the maximum capacity, Application Auto Scaling adjusts the capacity of the scalable target to place it within these bounds, even if you don't include the MinCapacity
or MaxCapacity
request parameters.
Adds or edits tags on an Application Auto Scaling scalable target.
Each tag consists of a tag key and a tag value, which are both case-sensitive strings. To add a tag, specify a new tag key and a tag value. To edit a tag, specify an existing tag key and a new tag value.
You can use this operation to tag an Application Auto Scaling scalable target, but you cannot tag a scaling policy or scheduled action.
You can also add tags to an Application Auto Scaling scalable target while creating it (RegisterScalableTarget
).
For general information about tags, including the format and syntax, see Tagging Amazon Web Services resources in the Amazon Web Services General Reference.
Use tags to control access to a scalable target. For more information, see Tagging support for Application Auto Scaling in the Application Auto Scaling User Guide.
" + }, + "UntagResource": { + "name": "UntagResource", + "http": { + "method": "POST", + "requestUri": "/" + }, + "input": { + "shape": "UntagResourceRequest" + }, + "output": { + "shape": "UntagResourceResponse" + }, + "errors": [ + { + "shape": "ResourceNotFoundException" + }, + { + "shape": "ValidationException" + } + ], + "documentation": "Deletes tags from an Application Auto Scaling scalable target. To delete a tag, specify the tag key and the Application Auto Scaling scalable target.
" } }, "shapes": { @@ -339,6 +405,12 @@ "shape": "Alarm" } }, + "AmazonResourceName": { + "type": "string", + "max": 1011, + "min": 1, + "pattern": "^arn:.+:application-autoscaling:.+:[0-9]+:scalable-target\\/[a-zA-Z0-9-]+$" + }, "Cooldown": { "type": "integer" }, @@ -347,7 +419,7 @@ "members": { "MetricName": { "shape": "MetricName", - "documentation": "The name of the metric. To get the exact metric name, namespace, and dimensions, inspect the Metric object that is returned by a call to ListMetrics.
" + "documentation": "The name of the metric. To get the exact metric name, namespace, and dimensions, inspect the Metric object that's returned by a call to ListMetrics.
" }, "Namespace": { "shape": "MetricNamespace", @@ -654,6 +726,27 @@ "IncludeNotScaledActivities": { "type": "boolean" }, + "ListTagsForResourceRequest": { + "type": "structure", + "required": [ + "ResourceARN" + ], + "members": { + "ResourceARN": { + "shape": "AmazonResourceName", + "documentation": "Specify the ARN of the scalable target.
For example: arn:aws:application-autoscaling:us-east-1:123456789012:scalable-target/1234abcd56ab78cd901ef1234567890ab123
To get the ARN for a scalable target, use DescribeScalableTargets.
" + } + } + }, + "ListTagsForResourceResponse": { + "type": "structure", + "members": { + "Tags": { + "shape": "TagMap", + "documentation": "A list of tags. Each tag consists of a tag key and a tag value.
" + } + } + }, "MaxResults": { "type": "integer" }, @@ -939,7 +1032,7 @@ }, "MaxCapacity": { "shape": "ResourceCapacity", - "documentation": "The maximum value that you plan to scale out to. When a scaling policy is in effect, Application Auto Scaling can scale out (expand) as needed to the maximum capacity limit in response to changing demand. This property is required when registering a new scalable target.
Although you can specify a large maximum capacity, note that service quotas may impose lower limits. Each service has its own default quotas for the maximum capacity of the resource. If you want to specify a higher limit, you can request an increase. For more information, consult the documentation for that service. For information about the default quotas for each service, see Service endpoints and quotas in the Amazon Web Services General Reference.
" + "documentation": "The maximum value that you plan to scale out to. When a scaling policy is in effect, Application Auto Scaling can scale out (expand) as needed to the maximum capacity limit in response to changing demand. This property is required when registering a new scalable target.
Although you can specify a large maximum capacity, note that service quotas might impose lower limits. Each service has its own default quotas for the maximum capacity of the resource. If you want to specify a higher limit, you can request an increase. For more information, consult the documentation for that service. For information about the default quotas for each service, see Service endpoints and quotas in the Amazon Web Services General Reference.
" }, "RoleARN": { "shape": "ResourceIdMaxLen1600", @@ -948,12 +1041,21 @@ "SuspendedState": { "shape": "SuspendedState", "documentation": "An embedded object that contains attributes and attribute values that are used to suspend and resume automatic scaling. Setting the value of an attribute to true
suspends the specified scaling activities. Setting it to false
(default) resumes the specified scaling activities.
Suspension Outcomes
For DynamicScalingInSuspended
, while a suspension is in effect, all scale-in activities that are triggered by a scaling policy are suspended.
For DynamicScalingOutSuspended
, while a suspension is in effect, all scale-out activities that are triggered by a scaling policy are suspended.
For ScheduledScalingSuspended
, while a suspension is in effect, all scaling activities that involve scheduled actions are suspended.
For more information, see Suspending and resuming scaling in the Application Auto Scaling User Guide.
" + }, + "Tags": { + "shape": "TagMap", + "documentation": "Assigns one or more tags to the scalable target. Use this parameter to tag the scalable target when it is created. To tag an existing scalable target, use the TagResource operation.
Each tag consists of a tag key and a tag value. Both the tag key and the tag value are required. You cannot have more than one tag on a scalable target with the same tag key.
Use tags to control access to a scalable target. For more information, see Tagging support for Application Auto Scaling in the Application Auto Scaling User Guide.
" } } }, "RegisterScalableTargetResponse": { "type": "structure", - "members": {} + "members": { + "ScalableTargetARN": { + "shape": "XmlString", + "documentation": "The ARN of the scalable target.
" + } + } }, "ResourceCapacity": { "type": "integer" @@ -1051,6 +1153,10 @@ "SuspendedState": { "shape": "SuspendedState", "documentation": "Specifies whether the scaling activities for a scalable target are in a suspended state.
" + }, + "ScalableTargetARN": { + "shape": "XmlString", + "documentation": "The ARN of the scalable target.
" } }, "documentation": "Represents a scalable target.
" @@ -1320,18 +1426,18 @@ "members": { "MetricIntervalLowerBound": { "shape": "MetricScale", - "documentation": "The lower bound for the difference between the alarm threshold and the CloudWatch metric. If the metric value is above the breach threshold, the lower bound is inclusive (the metric must be greater than or equal to the threshold plus the lower bound). Otherwise, it is exclusive (the metric must be greater than the threshold plus the lower bound). A null value indicates negative infinity.
" + "documentation": "The lower bound for the difference between the alarm threshold and the CloudWatch metric. If the metric value is above the breach threshold, the lower bound is inclusive (the metric must be greater than or equal to the threshold plus the lower bound). Otherwise, it's exclusive (the metric must be greater than the threshold plus the lower bound). A null value indicates negative infinity.
" }, "MetricIntervalUpperBound": { "shape": "MetricScale", - "documentation": "The upper bound for the difference between the alarm threshold and the CloudWatch metric. If the metric value is above the breach threshold, the upper bound is exclusive (the metric must be less than the threshold plus the upper bound). Otherwise, it is inclusive (the metric must be less than or equal to the threshold plus the upper bound). A null value indicates positive infinity.
The upper bound must be greater than the lower bound.
" + "documentation": "The upper bound for the difference between the alarm threshold and the CloudWatch metric. If the metric value is above the breach threshold, the upper bound is exclusive (the metric must be less than the threshold plus the upper bound). Otherwise, it's inclusive (the metric must be less than or equal to the threshold plus the upper bound). A null value indicates positive infinity.
The upper bound must be greater than the lower bound.
" }, "ScalingAdjustment": { "shape": "ScalingAdjustment", "documentation": "The amount by which to scale, based on the specified adjustment type. A positive value adds to the current capacity while a negative number removes from the current capacity. For exact capacity, you must specify a positive value.
" } }, - "documentation": "Represents a step adjustment for a StepScalingPolicyConfiguration. Describes an adjustment based on the difference between the value of the aggregated CloudWatch metric and the breach threshold that you've defined for the alarm.
For the following examples, suppose that you have an alarm with a breach threshold of 50:
To trigger the adjustment when the metric is greater than or equal to 50 and less than 60, specify a lower bound of 0 and an upper bound of 10.
To trigger the adjustment when the metric is greater than 40 and less than or equal to 50, specify a lower bound of -10 and an upper bound of 0.
There are a few rules for the step adjustments for your step policy:
The ranges of your step adjustments can't overlap or have a gap.
At most one step adjustment can have a null lower bound. If one step adjustment has a negative lower bound, then there must be a step adjustment with a null lower bound.
At most one step adjustment can have a null upper bound. If one step adjustment has a positive upper bound, then there must be a step adjustment with a null upper bound.
The upper and lower bound can't be null in the same step adjustment.
Represents a step adjustment for a StepScalingPolicyConfiguration. Describes an adjustment based on the difference between the value of the aggregated CloudWatch metric and the breach threshold that you've defined for the alarm.
For the following examples, suppose that you have an alarm with a breach threshold of 50:
To initiate the adjustment when the metric is greater than or equal to 50 and less than 60, specify a lower bound of 0
and an upper bound of 10
.
To initiate the adjustment when the metric is greater than 40 and less than or equal to 50, specify a lower bound of -10
and an upper bound of 0
.
There are a few rules for the step adjustments for your step policy:
The ranges of your step adjustments can't overlap or have a gap.
At most one step adjustment can have a null lower bound. If one step adjustment has a negative lower bound, then there must be a step adjustment with a null lower bound.
At most one step adjustment can have a null upper bound. If one step adjustment has a positive upper bound, then there must be a step adjustment with a null upper bound.
The upper and lower bound can't be null in the same step adjustment.
Specifies whether the scaling activities for a scalable target are in a suspended state.
" }, + "TagKey": { + "type": "string", + "max": 128, + "min": 1 + }, + "TagKeyList": { + "type": "list", + "member": { + "shape": "TagKey" + }, + "max": 200, + "min": 0 + }, + "TagMap": { + "type": "map", + "key": { + "shape": "TagKey" + }, + "value": { + "shape": "TagValue" + } + }, + "TagResourceRequest": { + "type": "structure", + "required": [ + "ResourceARN", + "Tags" + ], + "members": { + "ResourceARN": { + "shape": "AmazonResourceName", + "documentation": "Identifies the Application Auto Scaling scalable target that you want to apply tags to.
For example: arn:aws:application-autoscaling:us-east-1:123456789012:scalable-target/1234abcd56ab78cd901ef1234567890ab123
To get the ARN for a scalable target, use DescribeScalableTargets.
" + }, + "Tags": { + "shape": "TagMap", + "documentation": "The tags assigned to the resource. A tag is a label that you assign to an AWS resource.
Each tag consists of a tag key and a tag value.
You cannot have more than one tag on an Application Auto Scaling scalable target with the same tag key. If you specify an existing tag key with a different tag value, Application Auto Scaling replaces the current tag value with the specified one.
For information about the rules that apply to tag keys and tag values, see User-defined tag restrictions in the Amazon Web Services Billing and Cost Management User Guide.
" + } + } + }, + "TagResourceResponse": { + "type": "structure", + "members": {} + }, + "TagValue": { + "type": "string", + "max": 256, + "min": 0 + }, "TargetTrackingMetric": { "type": "structure", "members": { @@ -1497,7 +1651,7 @@ }, "Stat": { "shape": "XmlString", - "documentation": "The statistic to return. It can include any CloudWatch statistic or extended statistic. For a list of valid values, see the table in Statistics in the Amazon CloudWatch User Guide.
The most commonly used metrics for scaling is Average
The statistic to return. It can include any CloudWatch statistic or extended statistic. For a list of valid values, see the table in Statistics in the Amazon CloudWatch User Guide.
The most commonly used metric for scaling is Average
.
Identifies the Application Auto Scaling scalable target from which to remove tags.
For example: arn:aws:application-autoscaling:us-east-1:123456789012:scalable-target/1234abcd56ab78cd901ef1234567890ab123
To get the ARN for a scalable target, use DescribeScalableTargets.
" + }, + "TagKeys": { + "shape": "TagKeyList", + "documentation": "One or more tag keys. Specify only the tag keys, not the tag values.
" + } + } + }, + "UntagResourceResponse": { + "type": "structure", + "members": {} + }, "XmlString": { "type": "string", "pattern": "[\\u0020-\\uD7FF\\uE000-\\uFFFD\\uD800\\uDC00-\\uDBFF\\uDFFF\\r\\n\\t]*" diff --git a/apis/neptune-2014-10-31.min.json b/apis/neptune-2014-10-31.min.json index d2fd206826..4778aeb075 100644 --- a/apis/neptune-2014-10-31.min.json +++ b/apis/neptune-2014-10-31.min.json @@ -254,10 +254,10 @@ "DBClusterEndpointIdentifier": {}, "EndpointType": {}, "StaticMembers": { - "shape": "S1e" + "shape": "S1g" }, "ExcludedMembers": { - "shape": "S1e" + "shape": "S1g" }, "Tags": { "shape": "Sa" @@ -276,10 +276,10 @@ "EndpointType": {}, "CustomEndpointType": {}, "StaticMembers": { - "shape": "S1e" + "shape": "S1g" }, "ExcludedMembers": { - "shape": "S1e" + "shape": "S1g" }, "DBClusterEndpointArn": {} } @@ -343,7 +343,8 @@ "required": [ "DBInstanceIdentifier", "DBInstanceClass", - "Engine" + "Engine", + "DBClusterIdentifier" ], "members": { "DBName": {}, @@ -356,7 +357,7 @@ "MasterUsername": {}, "MasterUserPassword": {}, "DBSecurityGroups": { - "shape": "S1l" + "shape": "S1n" }, "VpcSecurityGroupIds": { "shape": "Sw" @@ -433,7 +434,7 @@ "type": "structure", "members": { "DBInstance": { - "shape": "S1n" + "shape": "S1p" } } } @@ -477,7 +478,7 @@ "DBSubnetGroupName": {}, "DBSubnetGroupDescription": {}, "SubnetIds": { - "shape": "S2a" + "shape": "S2b" }, "Tags": { "shape": "Sa" @@ -489,7 +490,7 @@ "type": "structure", "members": { "DBSubnetGroup": { - "shape": "S1t" + "shape": "S1v" } } } @@ -553,7 +554,7 @@ "type": "structure", "members": { "GlobalCluster": { - "shape": "S2g" + "shape": "S2h" } } } @@ -604,10 +605,10 @@ "EndpointType": {}, "CustomEndpointType": {}, "StaticMembers": { - "shape": "S1e" + "shape": "S1g" }, "ExcludedMembers": { - "shape": "S1e" + "shape": "S1g" }, "DBClusterEndpointArn": {} } @@ -663,7 +664,7 @@ "type": "structure", "members": { "DBInstance": { - "shape": "S1n" + "shape": "S1p" } } } @@ -725,7 +726,7 @@ "type": "structure", "members": { "GlobalCluster": { - "shape": "S2g" + "shape": "S2h" } } } @@ -737,7 +738,7 @@ "DBClusterIdentifier": {}, "DBClusterEndpointIdentifier": {}, "Filters": { - "shape": "S30" + "shape": "S31" }, "MaxRecords": { "type": "integer" @@ -764,10 +765,10 @@ "EndpointType": {}, "CustomEndpointType": {}, "StaticMembers": { - "shape": "S1e" + "shape": "S1g" }, "ExcludedMembers": { - "shape": "S1e" + "shape": "S1g" }, "DBClusterEndpointArn": {} } @@ -782,7 +783,7 @@ "members": { "DBClusterParameterGroupName": {}, "Filters": { - "shape": "S30" + "shape": "S31" }, "MaxRecords": { "type": "integer" @@ -815,7 +816,7 @@ "DBClusterParameterGroupName": {}, "Source": {}, "Filters": { - "shape": "S30" + "shape": "S31" }, "MaxRecords": { "type": "integer" @@ -828,7 +829,7 @@ "type": "structure", "members": { "Parameters": { - "shape": "S3b" + "shape": "S3c" }, "Marker": {} } @@ -849,7 +850,7 @@ "type": "structure", "members": { "DBClusterSnapshotAttributesResult": { - "shape": "S3g" + "shape": "S3h" } } } @@ -862,7 +863,7 @@ "DBClusterSnapshotIdentifier": {}, "SnapshotType": {}, "Filters": { - "shape": "S30" + "shape": "S31" }, "MaxRecords": { "type": "integer" @@ -897,7 +898,7 @@ "members": { "DBClusterIdentifier": {}, "Filters": { - "shape": "S30" + "shape": "S31" }, "MaxRecords": { "type": "integer" @@ -928,7 +929,7 @@ "EngineVersion": {}, "DBParameterGroupFamily": {}, "Filters": { - "shape": "S30" + "shape": "S31" }, "MaxRecords": { "type": "integer" @@ -962,12 +963,12 @@ "DBEngineDescription": {}, "DBEngineVersionDescription": {}, "DefaultCharacterSet": { - "shape": "S3u" + "shape": "S3v" }, "SupportedCharacterSets": { "type": "list", "member": { - "shape": "S3u", + "shape": "S3v", "locationName": "CharacterSet" } }, @@ -1026,7 +1027,7 @@ "members": { "DBInstanceIdentifier": {}, "Filters": { - "shape": "S30" + "shape": "S31" }, "MaxRecords": { "type": "integer" @@ -1042,7 +1043,7 @@ "DBInstances": { "type": "list", "member": { - "shape": "S1n", + "shape": "S1p", "locationName": "DBInstance" } } @@ -1055,7 +1056,7 @@ "members": { "DBParameterGroupName": {}, "Filters": { - "shape": "S30" + "shape": "S31" }, "MaxRecords": { "type": "integer" @@ -1088,7 +1089,7 @@ "DBParameterGroupName": {}, "Source": {}, "Filters": { - "shape": "S30" + "shape": "S31" }, "MaxRecords": { "type": "integer" @@ -1101,7 +1102,7 @@ "type": "structure", "members": { "Parameters": { - "shape": "S3b" + "shape": "S3c" }, "Marker": {} } @@ -1113,7 +1114,7 @@ "members": { "DBSubnetGroupName": {}, "Filters": { - "shape": "S30" + "shape": "S31" }, "MaxRecords": { "type": "integer" @@ -1129,7 +1130,7 @@ "DBSubnetGroups": { "type": "list", "member": { - "shape": "S1t", + "shape": "S1v", "locationName": "DBSubnetGroup" } } @@ -1145,7 +1146,7 @@ "members": { "DBParameterGroupFamily": {}, "Filters": { - "shape": "S30" + "shape": "S31" }, "MaxRecords": { "type": "integer" @@ -1158,7 +1159,7 @@ "type": "structure", "members": { "EngineDefaults": { - "shape": "S4d" + "shape": "S4e" } } } @@ -1172,7 +1173,7 @@ "members": { "DBParameterGroupFamily": {}, "Filters": { - "shape": "S30" + "shape": "S31" }, "MaxRecords": { "type": "integer" @@ -1185,7 +1186,7 @@ "type": "structure", "members": { "EngineDefaults": { - "shape": "S4d" + "shape": "S4e" } } } @@ -1196,7 +1197,7 @@ "members": { "SourceType": {}, "Filters": { - "shape": "S30" + "shape": "S31" } } }, @@ -1227,7 +1228,7 @@ "members": { "SubscriptionName": {}, "Filters": { - "shape": "S30" + "shape": "S31" }, "MaxRecords": { "type": "integer" @@ -1269,7 +1270,7 @@ "shape": "S7" }, "Filters": { - "shape": "S30" + "shape": "S31" }, "MaxRecords": { "type": "integer" @@ -1323,7 +1324,7 @@ "GlobalClusters": { "type": "list", "member": { - "shape": "S2g", + "shape": "S2h", "locationName": "GlobalClusterMember" } } @@ -1345,7 +1346,7 @@ "type": "boolean" }, "Filters": { - "shape": "S30" + "shape": "S31" }, "MaxRecords": { "type": "integer" @@ -1370,7 +1371,7 @@ "AvailabilityZones": { "type": "list", "member": { - "shape": "S1w", + "shape": "S1y", "locationName": "AvailabilityZone" } }, @@ -1434,7 +1435,7 @@ "members": { "ResourceIdentifier": {}, "Filters": { - "shape": "S30" + "shape": "S31" }, "Marker": {}, "MaxRecords": { @@ -1482,10 +1483,10 @@ "members": { "StorageType": {}, "StorageSize": { - "shape": "S58" + "shape": "S59" }, "ProvisionedIops": { - "shape": "S58" + "shape": "S59" }, "IopsToStorageRatio": { "type": "list", @@ -1546,7 +1547,7 @@ "type": "structure", "members": { "GlobalCluster": { - "shape": "S2g" + "shape": "S2h" } } } @@ -1560,7 +1561,7 @@ "members": { "ResourceName": {}, "Filters": { - "shape": "S30" + "shape": "S31" } } }, @@ -1604,7 +1605,7 @@ "type": "boolean" }, "CloudwatchLogsExportConfiguration": { - "shape": "S5k" + "shape": "S5l" }, "EngineVersion": {}, "AllowMajorVersionUpgrade": { @@ -1642,10 +1643,10 @@ "DBClusterEndpointIdentifier": {}, "EndpointType": {}, "StaticMembers": { - "shape": "S1e" + "shape": "S1g" }, "ExcludedMembers": { - "shape": "S1e" + "shape": "S1g" } } }, @@ -1661,10 +1662,10 @@ "EndpointType": {}, "CustomEndpointType": {}, "StaticMembers": { - "shape": "S1e" + "shape": "S1g" }, "ExcludedMembers": { - "shape": "S1e" + "shape": "S1g" }, "DBClusterEndpointArn": {} } @@ -1680,12 +1681,12 @@ "members": { "DBClusterParameterGroupName": {}, "Parameters": { - "shape": "S3b" + "shape": "S3c" } } }, "output": { - "shape": "S5p", + "shape": "S5q", "resultWrapper": "ModifyDBClusterParameterGroupResult" } }, @@ -1700,10 +1701,10 @@ "DBClusterSnapshotIdentifier": {}, "AttributeName": {}, "ValuesToAdd": { - "shape": "S3j" + "shape": "S3k" }, "ValuesToRemove": { - "shape": "S3j" + "shape": "S3k" } } }, @@ -1712,7 +1713,7 @@ "type": "structure", "members": { "DBClusterSnapshotAttributesResult": { - "shape": "S3g" + "shape": "S3h" } } } @@ -1731,7 +1732,7 @@ "DBInstanceClass": {}, "DBSubnetGroupName": {}, "DBSecurityGroups": { - "shape": "S1l" + "shape": "S1n" }, "VpcSecurityGroupIds": { "shape": "Sw" @@ -1793,7 +1794,7 @@ }, "PerformanceInsightsKMSKeyId": {}, "CloudwatchLogsExportConfiguration": { - "shape": "S5k" + "shape": "S5l" }, "DeletionProtection": { "type": "boolean" @@ -1805,7 +1806,7 @@ "type": "structure", "members": { "DBInstance": { - "shape": "S1n" + "shape": "S1p" } } } @@ -1820,12 +1821,12 @@ "members": { "DBParameterGroupName": {}, "Parameters": { - "shape": "S3b" + "shape": "S3c" } } }, "output": { - "shape": "S5v", + "shape": "S5w", "resultWrapper": "ModifyDBParameterGroupResult" } }, @@ -1840,7 +1841,7 @@ "DBSubnetGroupName": {}, "DBSubnetGroupDescription": {}, "SubnetIds": { - "shape": "S2a" + "shape": "S2b" } } }, @@ -1849,7 +1850,7 @@ "type": "structure", "members": { "DBSubnetGroup": { - "shape": "S1t" + "shape": "S1v" } } } @@ -1905,7 +1906,7 @@ "type": "structure", "members": { "GlobalCluster": { - "shape": "S2g" + "shape": "S2h" } } } @@ -1948,7 +1949,7 @@ "type": "structure", "members": { "DBInstance": { - "shape": "S1n" + "shape": "S1p" } } } @@ -1970,7 +1971,7 @@ "type": "structure", "members": { "GlobalCluster": { - "shape": "S2g" + "shape": "S2h" } } } @@ -2039,12 +2040,12 @@ "type": "boolean" }, "Parameters": { - "shape": "S3b" + "shape": "S3c" } } }, "output": { - "shape": "S5p", + "shape": "S5q", "resultWrapper": "ResetDBClusterParameterGroupResult" } }, @@ -2060,12 +2061,12 @@ "type": "boolean" }, "Parameters": { - "shape": "S3b" + "shape": "S3c" } } }, "output": { - "shape": "S5v", + "shape": "S5w", "resultWrapper": "ResetDBParameterGroupResult" } }, @@ -2493,6 +2494,28 @@ "EnabledCloudwatchLogsExports": { "shape": "Sx" }, + "PendingModifiedValues": { + "type": "structure", + "members": { + "PendingCloudwatchLogsExports": { + "shape": "S1d" + }, + "DBClusterIdentifier": {}, + "IAMDatabaseAuthenticationEnabled": { + "type": "boolean" + }, + "EngineVersion": {}, + "BackupRetentionPeriod": { + "type": "integer" + }, + "AllocatedStorage": { + "type": "integer" + }, + "Iops": { + "type": "integer" + } + } + }, "DeletionProtection": { "type": "boolean" }, @@ -2512,7 +2535,8 @@ "type": "double" } } - } + }, + "GlobalClusterIdentifier": {} }, "wrapper": true }, @@ -2527,17 +2551,28 @@ } } }, - "S1e": { + "S1d": { + "type": "structure", + "members": { + "LogTypesToEnable": { + "shape": "Sx" + }, + "LogTypesToDisable": { + "shape": "Sx" + } + } + }, + "S1g": { "type": "list", "member": {} }, - "S1l": { + "S1n": { "type": "list", "member": { "locationName": "DBSecurityGroupName" } }, - "S1n": { + "S1p": { "type": "structure", "members": { "DBInstanceIdentifier": {}, @@ -2593,7 +2628,7 @@ }, "AvailabilityZone": {}, "DBSubnetGroup": { - "shape": "S1t" + "shape": "S1v" }, "PreferredMaintenanceWindow": {}, "PendingModifiedValues": { @@ -2623,15 +2658,7 @@ "CACertificateIdentifier": {}, "DBSubnetGroupName": {}, "PendingCloudwatchLogsExports": { - "type": "structure", - "members": { - "LogTypesToEnable": { - "shape": "Sx" - }, - "LogTypesToDisable": { - "shape": "Sx" - } - } + "shape": "S1d" } } }, @@ -2748,7 +2775,7 @@ }, "wrapper": true }, - "S1t": { + "S1v": { "type": "structure", "members": { "DBSubnetGroupName": {}, @@ -2763,7 +2790,7 @@ "members": { "SubnetIdentifier": {}, "SubnetAvailabilityZone": { - "shape": "S1w" + "shape": "S1y" }, "SubnetStatus": {} } @@ -2773,20 +2800,20 @@ }, "wrapper": true }, - "S1w": { + "S1y": { "type": "structure", "members": { "Name": {} }, "wrapper": true }, - "S2a": { + "S2b": { "type": "list", "member": { "locationName": "SubnetIdentifier" } }, - "S2g": { + "S2h": { "type": "structure", "members": { "GlobalClusterIdentifier": {}, @@ -2822,7 +2849,7 @@ }, "wrapper": true }, - "S30": { + "S31": { "type": "list", "member": { "locationName": "Filter", @@ -2842,7 +2869,7 @@ } } }, - "S3b": { + "S3c": { "type": "list", "member": { "locationName": "Parameter", @@ -2863,7 +2890,7 @@ } } }, - "S3g": { + "S3h": { "type": "structure", "members": { "DBClusterSnapshotIdentifier": {}, @@ -2875,7 +2902,7 @@ "members": { "AttributeName": {}, "AttributeValues": { - "shape": "S3j" + "shape": "S3k" } } } @@ -2883,31 +2910,31 @@ }, "wrapper": true }, - "S3j": { + "S3k": { "type": "list", "member": { "locationName": "AttributeValue" } }, - "S3u": { + "S3v": { "type": "structure", "members": { "CharacterSetName": {}, "CharacterSetDescription": {} } }, - "S4d": { + "S4e": { "type": "structure", "members": { "DBParameterGroupFamily": {}, "Marker": {}, "Parameters": { - "shape": "S3b" + "shape": "S3c" } }, "wrapper": true }, - "S58": { + "S59": { "type": "list", "member": { "locationName": "Range", @@ -2925,7 +2952,7 @@ } } }, - "S5k": { + "S5l": { "type": "structure", "members": { "EnableLogTypes": { @@ -2936,13 +2963,13 @@ } } }, - "S5p": { + "S5q": { "type": "structure", "members": { "DBClusterParameterGroupName": {} } }, - "S5v": { + "S5w": { "type": "structure", "members": { "DBParameterGroupName": {} diff --git a/apis/neptune-2014-10-31.normal.json b/apis/neptune-2014-10-31.normal.json index ced1c7d593..4d11771ba8 100644 --- a/apis/neptune-2014-10-31.normal.json +++ b/apis/neptune-2014-10-31.normal.json @@ -2067,6 +2067,40 @@ }, "documentation": "The configuration setting for the log types to be enabled for export to CloudWatch Logs for a specific DB instance or DB cluster.
The EnableLogTypes
and DisableLogTypes
arrays determine which logs will be exported (or not exported) to CloudWatch Logs.
This PendingCloudwatchLogsExports
structure specifies pending changes to which CloudWatch logs are enabled and which are disabled.
The DBClusterIdentifier value for the DB cluster.
" + }, + "IAMDatabaseAuthenticationEnabled": { + "shape": "BooleanOptional", + "documentation": "A value that indicates whether mapping of Amazon Web Services Identity and Access Management (IAM) accounts to database accounts is enabled.
" + }, + "EngineVersion": { + "shape": "String", + "documentation": "The database engine version.
" + }, + "BackupRetentionPeriod": { + "shape": "IntegerOptional", + "documentation": "The number of days for which automatic DB snapshots are retained.
" + }, + "AllocatedStorage": { + "shape": "IntegerOptional", + "documentation": "The allocated storage size in gibibytes (GiB) for database engines. For Neptune, AllocatedStorage
always returns 1, because Neptune DB cluster storage size isn't fixed, but instead automatically adjusts as needed.
The Provisioned IOPS (I/O operations per second) value. This setting is only for non-Aurora Multi-AZ DB clusters.
" + } + }, + "documentation": "This data type is used as a response element in the ModifyDBCluster
operation and contains changes that will be applied during the next maintenance window.
A list of log types that this DB cluster is configured to export to CloudWatch Logs.
" }, + "PendingModifiedValues": { + "shape": "ClusterPendingModifiedValues", + "documentation": "This data type is used as a response element in the ModifyDBCluster
operation and contains changes that will be applied during the next maintenance window.
Indicates whether or not the DB cluster has deletion protection enabled. The database can't be deleted when deletion protection is enabled.
" @@ -2952,6 +2991,10 @@ }, "ServerlessV2ScalingConfiguration": { "shape": "ServerlessV2ScalingConfigurationInfo" + }, + "GlobalClusterIdentifier": { + "shape": "GlobalClusterIdentifier", + "documentation": "Contains a user-supplied global database cluster identifier. This identifier is the unique key that identifies a global database.
" } }, "documentation": "Contains the details of an Amazon Neptune DB cluster.
This data type is used as a response element in the DescribeDBClusters action.
", diff --git a/apis/s3outposts-2017-07-25.min.json b/apis/s3outposts-2017-07-25.min.json index 4af1267940..348eccddc4 100644 --- a/apis/s3outposts-2017-07-25.min.json +++ b/apis/s3outposts-2017-07-25.min.json @@ -194,7 +194,14 @@ "SubnetId": {}, "SecurityGroupId": {}, "AccessType": {}, - "CustomerOwnedIpv4Pool": {} + "CustomerOwnedIpv4Pool": {}, + "FailedReason": { + "type": "structure", + "members": { + "ErrorCode": {}, + "Message": {} + } + } } } } diff --git a/apis/s3outposts-2017-07-25.normal.json b/apis/s3outposts-2017-07-25.normal.json index 5238e80765..6d5739c3a3 100644 --- a/apis/s3outposts-2017-07-25.normal.json +++ b/apis/s3outposts-2017-07-25.normal.json @@ -43,6 +43,9 @@ }, { "shape": "ThrottlingException" + }, + { + "shape": "OutpostOfflineException" } ], "documentation": "Creates an endpoint and associates it with the specified Outpost.
It can take up to 5 minutes for this action to finish.
Related actions include:
" @@ -71,6 +74,9 @@ }, { "shape": "ThrottlingException" + }, + { + "shape": "OutpostOfflineException" } ], "documentation": "Deletes an endpoint.
It can take up to 5 minutes for this action to finish.
Related actions include:
" @@ -290,6 +296,10 @@ "CustomerOwnedIpv4Pool": { "shape": "CustomerOwnedIpv4Pool", "documentation": "The ID of the customer-owned IPv4 address pool used for the endpoint.
" + }, + "FailedReason": { + "shape": "FailedReason", + "documentation": "The failure reason, if any, for a create or delete endpoint operation.
" } }, "documentation": "Amazon S3 on Outposts Access Points simplify managing data access at scale for shared datasets in S3 on Outposts. S3 on Outposts uses endpoints to connect to Outposts buckets so that you can perform actions within your virtual private cloud (VPC). For more information, see Accessing S3 on Outposts using VPC-only access points in the Amazon Simple Storage Service User Guide.
" @@ -314,7 +324,9 @@ "enum": [ "Pending", "Available", - "Deleting" + "Deleting", + "Create_Failed", + "Delete_Failed" ] }, "Endpoints": { @@ -323,6 +335,23 @@ "shape": "Endpoint" } }, + "ErrorCode": { + "type": "string" + }, + "FailedReason": { + "type": "structure", + "members": { + "ErrorCode": { + "shape": "ErrorCode", + "documentation": "The failure code, if any, for a create or delete endpoint operation.
" + }, + "Message": { + "shape": "Message", + "documentation": "Additional error details describing the endpoint failure and recommended action.
" + } + }, + "documentation": "The failure reason, if any, for a create or delete endpoint operation.
" + }, "ListEndpointsRequest": { "type": "structure", "members": { @@ -427,6 +456,9 @@ "max": 100, "min": 0 }, + "Message": { + "type": "string" + }, "NetworkInterface": { "type": "structure", "members": { diff --git a/apis/workdocs-2016-05-01.min.json b/apis/workdocs-2016-05-01.min.json index edcfa1a175..e518569720 100644 --- a/apis/workdocs-2016-05-01.min.json +++ b/apis/workdocs-2016-05-01.min.json @@ -241,7 +241,9 @@ "location": "header", "locationName": "Authentication" }, - "Name": {}, + "Name": { + "shape": "S1b" + }, "ParentFolderId": {} } }, @@ -333,12 +335,18 @@ ], "members": { "OrganizationId": {}, - "Username": {}, + "Username": { + "shape": "S9" + }, "EmailAddress": { "shape": "Sa" }, - "GivenName": {}, - "Surname": {}, + "GivenName": { + "shape": "Sb" + }, + "Surname": { + "shape": "Sb" + }, "Password": { "type": "string", "sensitive": true @@ -753,18 +761,7 @@ "shape": "S2k" }, "CommentMetadata": { - "type": "structure", - "members": { - "CommentId": {}, - "Contributor": { - "shape": "S8" - }, - "CreatedTimestamp": { - "type": "timestamp" - }, - "CommentStatus": {}, - "RecipientId": {} - } + "shape": "S2m" } } } @@ -1503,7 +1500,9 @@ "locationName": "Authentication" }, "Id": {}, - "Name": {}, + "Name": { + "shape": "S1b" + }, "ContentCreatedTimestamp": { "type": "timestamp" }, @@ -1619,6 +1618,141 @@ } } }, + "SearchResources": { + "http": { + "requestUri": "/api/v1/search", + "responseCode": 200 + }, + "input": { + "type": "structure", + "members": { + "AuthenticationToken": { + "shape": "S2", + "location": "header", + "locationName": "Authentication" + }, + "QueryText": { + "shape": "S3d" + }, + "QueryScopes": { + "type": "list", + "member": {} + }, + "OrganizationId": {}, + "AdditionalResponseFields": { + "type": "list", + "member": {} + }, + "Filters": { + "type": "structure", + "members": { + "TextLocales": { + "type": "list", + "member": {} + }, + "ContentCategories": { + "type": "list", + "member": {} + }, + "ResourceTypes": { + "type": "list", + "member": {} + }, + "Labels": { + "type": "list", + "member": {} + }, + "Principals": { + "type": "list", + "member": { + "type": "structure", + "required": [ + "Id" + ], + "members": { + "Id": {}, + "Roles": { + "type": "list", + "member": {} + } + } + } + }, + "AncestorIds": { + "type": "list", + "member": {} + }, + "SearchCollectionTypes": { + "type": "list", + "member": {} + }, + "SizeRange": { + "type": "structure", + "members": { + "StartValue": { + "type": "long" + }, + "EndValue": { + "type": "long" + } + } + }, + "CreatedRange": { + "shape": "S5d" + }, + "ModifiedRange": { + "shape": "S5d" + } + } + }, + "OrderBy": { + "type": "list", + "member": { + "type": "structure", + "members": { + "Field": {}, + "Order": {} + } + } + }, + "Limit": { + "type": "integer" + }, + "Marker": {} + } + }, + "output": { + "type": "structure", + "members": { + "Items": { + "type": "list", + "member": { + "type": "structure", + "members": { + "ResourceType": {}, + "WebUrl": { + "type": "string", + "sensitive": true + }, + "DocumentMetadata": { + "shape": "S3b" + }, + "FolderMetadata": { + "shape": "S1d" + }, + "CommentMetadata": { + "shape": "S2m" + }, + "DocumentVersionMetadata": { + "shape": "S2w" + } + } + } + }, + "Marker": {} + } + } + }, "UpdateDocument": { "http": { "method": "PATCH", @@ -1640,7 +1774,9 @@ "location": "uri", "locationName": "DocumentId" }, - "Name": {}, + "Name": { + "shape": "S1b" + }, "ParentFolderId": {}, "ResourceState": {} } @@ -1697,7 +1833,9 @@ "location": "uri", "locationName": "FolderId" }, - "Name": {}, + "Name": { + "shape": "S1b" + }, "ParentFolderId": {}, "ResourceState": {} } @@ -1724,8 +1862,12 @@ "location": "uri", "locationName": "UserId" }, - "GivenName": {}, - "Surname": {}, + "GivenName": { + "shape": "Sb" + }, + "Surname": { + "shape": "Sb" + }, "Type": {}, "StorageRule": { "shape": "Sj" @@ -1754,12 +1896,18 @@ "type": "structure", "members": { "Id": {}, - "Username": {}, + "Username": { + "shape": "S9" + }, "EmailAddress": { "shape": "Sa" }, - "GivenName": {}, - "Surname": {}, + "GivenName": { + "shape": "Sb" + }, + "Surname": { + "shape": "Sb" + }, "OrganizationId": {}, "RootFolderId": {}, "RecycleBinFolderId": {}, @@ -1786,10 +1934,18 @@ } } }, + "S9": { + "type": "string", + "sensitive": true + }, "Sa": { "type": "string", "sensitive": true }, + "Sb": { + "type": "string", + "sensitive": true + }, "Sj": { "type": "structure", "members": { @@ -1835,11 +1991,17 @@ "key": {}, "value": {} }, + "S1b": { + "type": "string", + "sensitive": true + }, "S1d": { "type": "structure", "members": { "Id": {}, - "Name": {}, + "Name": { + "shape": "S1b" + }, "CreatorId": {}, "ParentFolderId": {}, "CreatedTimestamp": { @@ -1877,9 +2039,15 @@ "type": "structure", "members": { "Id": {}, - "Username": {}, - "GivenName": {}, - "Surname": {}, + "Username": { + "shape": "S9" + }, + "GivenName": { + "shape": "Sb" + }, + "Surname": { + "shape": "Sb" + }, "EmailAddress": { "shape": "Sa" } @@ -1899,8 +2067,12 @@ "type": "structure", "members": { "Type": {}, - "Name": {}, - "OriginalName": {}, + "Name": { + "shape": "S1b" + }, + "OriginalName": { + "shape": "S1b" + }, "Id": {}, "VersionId": {}, "Owner": { @@ -1909,11 +2081,28 @@ "ParentId": {} } }, + "S2m": { + "type": "structure", + "members": { + "CommentId": {}, + "Contributor": { + "shape": "S8" + }, + "CreatedTimestamp": { + "type": "timestamp" + }, + "CommentStatus": {}, + "RecipientId": {}, + "ContributorId": {} + } + }, "S2w": { "type": "structure", "members": { "Id": {}, - "Name": {}, + "Name": { + "shape": "S1b" + }, "ContentType": {}, "Size": { "type": "long" @@ -1999,11 +2188,24 @@ "type": "structure", "members": { "Id": {}, - "Name": {} + "Name": { + "shape": "S1b" + } } } } } + }, + "S5d": { + "type": "structure", + "members": { + "StartValue": { + "type": "timestamp" + }, + "EndValue": { + "type": "timestamp" + } + } } } } \ No newline at end of file diff --git a/apis/workdocs-2016-05-01.normal.json b/apis/workdocs-2016-05-01.normal.json index a0ffcff7ff..87d0429454 100644 --- a/apis/workdocs-2016-05-01.normal.json +++ b/apis/workdocs-2016-05-01.normal.json @@ -1270,6 +1270,9 @@ }, { "shape": "InvalidPasswordException" + }, + { + "shape": "InvalidArgumentException" } ], "documentation": "Creates a new document object and version object.
The client specifies the parent folder ID and name of the document to upload. The ID is optionally specified when creating a new version of an existing document. This is the first step to upload a document. Next, upload the document to the URL returned from the call, and then call UpdateDocumentVersion.
To cancel the document upload, call AbortDocumentVersionUpload.
" @@ -1364,6 +1367,35 @@ ], "documentation": "Recovers a deleted version of an Amazon WorkDocs document.
" }, + "SearchResources": { + "name": "SearchResources", + "http": { + "method": "POST", + "requestUri": "/api/v1/search", + "responseCode": 200 + }, + "input": { + "shape": "SearchResourcesRequest" + }, + "output": { + "shape": "SearchResourcesResponse" + }, + "errors": [ + { + "shape": "InvalidArgumentException" + }, + { + "shape": "UnauthorizedResourceAccessException" + }, + { + "shape": "UnauthorizedOperationException" + }, + { + "shape": "ServiceUnavailableException" + } + ], + "documentation": "Searches metadata and the content of folders, documents, document versions, and comments.
" + }, "UpdateDocument": { "name": "UpdateDocument", "http": { @@ -1716,6 +1748,18 @@ } } }, + "AdditionalResponseFieldType": { + "type": "string", + "enum": [ + "WEBURL" + ] + }, + "AdditionalResponseFieldsList": { + "type": "list", + "member": { + "shape": "AdditionalResponseFieldType" + } + }, "AuthenticationHeaderType": { "type": "string", "max": 8199, @@ -1811,6 +1855,10 @@ "RecipientId": { "shape": "IdType", "documentation": "The ID of the user being replied to.
" + }, + "ContributorId": { + "shape": "IdType", + "documentation": "The ID of the user who made the comment.
" } }, "documentation": "Describes the metadata of a comment.
" @@ -1836,6 +1884,20 @@ "PRIVATE" ] }, + "ContentCategoryType": { + "type": "string", + "enum": [ + "IMAGE", + "DOCUMENT", + "PDF", + "SPREADSHEET", + "PRESENTATION", + "AUDIO", + "VIDEO", + "SOURCE_CODE", + "OTHER" + ] + }, "CreateCommentRequest": { "type": "structure", "required": [ @@ -2114,6 +2176,20 @@ "min": 1, "pattern": "[a-zA-Z0-9._+-/=][a-zA-Z0-9 ._+-/=]*" }, + "DateRangeType": { + "type": "structure", + "members": { + "StartValue": { + "shape": "TimestampType", + "documentation": "Timestamp range start value (in epochs)
" + }, + "EndValue": { + "shape": "TimestampType", + "documentation": "Timestamp range end value (in epochs).
" + } + }, + "documentation": "Filters results based on timestamp range (in epochs).
" + }, "DeactivateUserRequest": { "type": "structure", "required": [ @@ -3082,6 +3158,52 @@ "min": 1, "pattern": "[\\w,]+" }, + "Filters": { + "type": "structure", + "members": { + "TextLocales": { + "shape": "TextLocaleTypeList", + "documentation": "Filters by the locale of the content or comment.
" + }, + "ContentCategories": { + "shape": "SearchContentCategoryTypeList", + "documentation": "Filters by content category.
" + }, + "ResourceTypes": { + "shape": "SearchResourceTypeList", + "documentation": "Filters based on entity type.
" + }, + "Labels": { + "shape": "SearchLabelList", + "documentation": "Filter by labels using exact match.
" + }, + "Principals": { + "shape": "SearchPrincipalTypeList", + "documentation": "Filter based on UserIds or GroupIds.
" + }, + "AncestorIds": { + "shape": "SearchAncestorIdList", + "documentation": "Filter based on resource’s path.
" + }, + "SearchCollectionTypes": { + "shape": "SearchCollectionTypeList", + "documentation": "Filter based on file groupings.
" + }, + "SizeRange": { + "shape": "LongRangeType", + "documentation": "Filter based on size (in bytes).
" + }, + "CreatedRange": { + "shape": "DateRangeType", + "documentation": "Filter based on resource’s creation timestamp.
" + }, + "ModifiedRange": { + "shape": "DateRangeType", + "documentation": "Filter based on resource’s modified timestamp.
" + } + }, + "documentation": "Filters results based on entity metadata.
" + }, "FolderContentType": { "type": "string", "enum": [ @@ -3543,6 +3665,42 @@ } } }, + "LanguageCodeType": { + "type": "string", + "enum": [ + "AR", + "BG", + "BN", + "DA", + "DE", + "CS", + "EL", + "EN", + "ES", + "FA", + "FI", + "FR", + "HI", + "HU", + "ID", + "IT", + "JA", + "KO", + "LT", + "LV", + "NL", + "NO", + "PT", + "RO", + "RU", + "SV", + "SW", + "TH", + "TR", + "ZH", + "DEFAULT" + ] + }, "LimitType": { "type": "integer", "max": 999, @@ -3564,6 +3722,23 @@ "default" ] }, + "LongRangeType": { + "type": "structure", + "members": { + "StartValue": { + "shape": "LongType", + "documentation": "The size start range (in bytes).
" + }, + "EndValue": { + "shape": "LongType", + "documentation": "The size end range (in bytes).
" + } + }, + "documentation": "Filter based on size (in bytes).
" + }, + "LongType": { + "type": "long" + }, "MarkerType": { "type": "string", "max": 2048, @@ -3576,6 +3751,12 @@ "min": 0, "sensitive": true }, + "NextMarkerType": { + "type": "string", + "max": 2048, + "min": 1, + "pattern": "[\\d]+" + }, "NotificationOptions": { "type": "structure", "members": { @@ -3590,6 +3771,16 @@ }, "documentation": "Set of options which defines notification preferences of given action.
" }, + "OrderByFieldType": { + "type": "string", + "enum": [ + "RELEVANCE", + "NAME", + "SIZE", + "CREATED_TIMESTAMP", + "MODIFIED_TIMESTAMP" + ] + }, "OrderType": { "type": "string", "enum": [ @@ -3681,6 +3872,15 @@ "shape": "Principal" } }, + "PrincipalRoleType": { + "type": "string", + "enum": [ + "VIEWER", + "CONTRIBUTOR", + "OWNER", + "COOWNER" + ] + }, "PrincipalType": { "type": "string", "enum": [ @@ -3794,7 +3994,8 @@ "type": "string", "max": 255, "min": 1, - "pattern": "[\\u0020-\\u202D\\u202F-\\uFFFF]+" + "pattern": "[\\u0020-\\u202D\\u202F-\\uFFFF]+", + "sensitive": true }, "ResourcePath": { "type": "structure", @@ -3849,6 +4050,59 @@ "DOCUMENT" ] }, + "ResponseItem": { + "type": "structure", + "members": { + "ResourceType": { + "shape": "ResponseItemType", + "documentation": "The type of item being returned.
" + }, + "WebUrl": { + "shape": "ResponseItemWebUrl", + "documentation": "The webUrl of the item being returned.
" + }, + "DocumentMetadata": { + "shape": "DocumentMetadata", + "documentation": "The document that matches the query.
" + }, + "FolderMetadata": { + "shape": "FolderMetadata", + "documentation": "The folder that matches the query.
" + }, + "CommentMetadata": { + "shape": "CommentMetadata", + "documentation": "The comment that matches the query.
" + }, + "DocumentVersionMetadata": { + "shape": "DocumentVersionMetadata", + "documentation": "The document version that matches the metadata.
" + } + }, + "documentation": "List of Documents, Folders, Comments, and Document Versions matching the query.
" + }, + "ResponseItemType": { + "type": "string", + "enum": [ + "DOCUMENT", + "FOLDER", + "COMMENT", + "DOCUMENT_VERSION" + ] + }, + "ResponseItemWebUrl": { + "type": "string", + "max": 512, + "min": 1, + "pattern": "[\\u0020-\\uFFFF]+", + "sensitive": true + }, + "ResponseItemsList": { + "type": "list", + "member": { + "shape": "ResponseItem" + }, + "max": 100 + }, "RestoreDocumentVersionsRequest": { "type": "structure", "required": [ @@ -3885,12 +4139,102 @@ "COOWNER" ] }, + "SearchAncestorId": { + "type": "string", + "max": 128, + "min": 1 + }, + "SearchAncestorIdList": { + "type": "list", + "member": { + "shape": "SearchAncestorId" + }, + "max": 10 + }, + "SearchCollectionType": { + "type": "string", + "enum": [ + "OWNED", + "SHARED_WITH_ME" + ] + }, + "SearchCollectionTypeList": { + "type": "list", + "member": { + "shape": "SearchCollectionType" + }, + "max": 2 + }, + "SearchContentCategoryTypeList": { + "type": "list", + "member": { + "shape": "ContentCategoryType" + }, + "max": 9 + }, + "SearchLabel": { + "type": "string", + "max": 128, + "min": 1 + }, + "SearchLabelList": { + "type": "list", + "member": { + "shape": "SearchLabel" + }, + "max": 10 + }, "SearchMarkerType": { "type": "string", "max": 12288, "min": 1, "pattern": "[\\u0000-\\u00FF]+" }, + "SearchPrincipalRoleList": { + "type": "list", + "member": { + "shape": "PrincipalRoleType" + }, + "max": 4 + }, + "SearchPrincipalType": { + "type": "structure", + "required": [ + "Id" + ], + "members": { + "Id": { + "shape": "IdType", + "documentation": "UserIds or GroupIds.
" + }, + "Roles": { + "shape": "SearchPrincipalRoleList", + "documentation": "The Role of a User or Group.
" + } + }, + "documentation": "Filter based on UserIds or GroupIds.
" + }, + "SearchPrincipalTypeList": { + "type": "list", + "member": { + "shape": "SearchPrincipalType" + }, + "max": 10 + }, + "SearchQueryScopeType": { + "type": "string", + "enum": [ + "NAME", + "CONTENT" + ] + }, + "SearchQueryScopeTypeList": { + "type": "list", + "member": { + "shape": "SearchQueryScopeType" + }, + "max": 2 + }, "SearchQueryType": { "type": "string", "max": 512, @@ -3898,6 +4242,104 @@ "pattern": "[\\u0020-\\uFFFF]+", "sensitive": true }, + "SearchResourceType": { + "type": "string", + "enum": [ + "FOLDER", + "DOCUMENT", + "COMMENT", + "DOCUMENT_VERSION" + ] + }, + "SearchResourceTypeList": { + "type": "list", + "member": { + "shape": "SearchResourceType" + }, + "max": 4 + }, + "SearchResourcesRequest": { + "type": "structure", + "members": { + "AuthenticationToken": { + "shape": "AuthenticationHeaderType", + "documentation": "Amazon WorkDocs authentication token. Not required when using Amazon Web Services administrator credentials to access the API.
", + "location": "header", + "locationName": "Authentication" + }, + "QueryText": { + "shape": "SearchQueryType", + "documentation": "The String to search for. Searches across different text fields based on request parameters. Use double quotes around the query string for exact phrase matches.
" + }, + "QueryScopes": { + "shape": "SearchQueryScopeTypeList", + "documentation": "Filter based on the text field type. A Folder has only a name and no content. A Comment has only content and no name. A Document or Document Version has a name and content
" + }, + "OrganizationId": { + "shape": "IdType", + "documentation": "Filters based on the resource owner OrgId. This is a mandatory parameter when using Admin SigV4 credentials.
" + }, + "AdditionalResponseFields": { + "shape": "AdditionalResponseFieldsList", + "documentation": "A list of attributes to include in the response. Used to request fields that are not normally returned in a standard response.
" + }, + "Filters": { + "shape": "Filters", + "documentation": "Filters results based on entity metadata.
" + }, + "OrderBy": { + "shape": "SearchResultSortList", + "documentation": "Order by results in one or more categories.
" + }, + "Limit": { + "shape": "SearchResultsLimitType", + "documentation": "Max results count per page.
" + }, + "Marker": { + "shape": "NextMarkerType", + "documentation": "The marker for the next set of results.
" + } + } + }, + "SearchResourcesResponse": { + "type": "structure", + "members": { + "Items": { + "shape": "ResponseItemsList", + "documentation": "List of Documents, Folders, Comments, and Document Versions matching the query.
" + }, + "Marker": { + "shape": "NextMarkerType", + "documentation": "The marker to use when requesting the next set of results. If there are no additional results, the string is empty.
" + } + } + }, + "SearchResultSortList": { + "type": "list", + "member": { + "shape": "SearchSortResult" + }, + "max": 1 + }, + "SearchResultsLimitType": { + "type": "integer", + "max": 100, + "min": 1 + }, + "SearchSortResult": { + "type": "structure", + "members": { + "Field": { + "shape": "OrderByFieldType", + "documentation": "Sort search results based on this field name.
" + }, + "Order": { + "shape": "SortOrder", + "documentation": "Sort direction.
" + } + }, + "documentation": "The result of the sort operation.
" + }, "SharePrincipal": { "type": "structure", "required": [ @@ -3995,6 +4437,13 @@ "SizeType": { "type": "long" }, + "SortOrder": { + "type": "string", + "enum": [ + "ASC", + "DESC" + ] + }, "StorageRuleType": { "type": "structure", "members": { @@ -4059,6 +4508,13 @@ "ALL" ] }, + "TextLocaleTypeList": { + "type": "list", + "member": { + "shape": "LanguageCodeType" + }, + "max": 1 + }, "TimeZoneIdType": { "type": "string", "max": 256, @@ -4314,7 +4770,8 @@ "UserAttributeValueType": { "type": "string", "max": 64, - "min": 1 + "min": 1, + "sensitive": true }, "UserFilterType": { "type": "string", @@ -4407,7 +4864,8 @@ "type": "string", "max": 256, "min": 1, - "pattern": "[\\w\\-+.]+(@[a-zA-Z0-9.\\-]+\\.[a-zA-Z]+)?" + "pattern": "[\\w\\-+.]+(@[a-zA-Z0-9.\\-]+\\.[a-zA-Z]+)?", + "sensitive": true } }, "documentation": "The Amazon WorkDocs API is designed for the following use cases:
File Migration: File migration applications are supported for users who want to migrate their files from an on-premises or off-premises file system or service. Users can insert files into a user directory structure, as well as allow for basic metadata changes, such as modifications to the permissions of files.
Security: Support security applications are supported for users who have additional security needs, such as antivirus or data loss prevention. The API actions, along with CloudTrail, allow these applications to detect when changes occur in Amazon WorkDocs. Then, the application can take the necessary actions and replace the target file. If the target file violates the policy, the application can also choose to email the user.
eDiscovery/Analytics: General administrative applications are supported, such as eDiscovery and analytics. These applications can choose to mimic or record the actions in an Amazon WorkDocs site, along with CloudTrail, to replicate data for eDiscovery, backup, or analytical applications.
All Amazon WorkDocs API actions are Amazon authenticated and certificate-signed. They not only require the use of the Amazon Web Services SDK, but also allow for the exclusive use of IAM users and roles to help facilitate access, trust, and permission policies. By creating a role and allowing an IAM user to access the Amazon WorkDocs site, the IAM user gains full administrative visibility into the entire Amazon WorkDocs site (or as set in the IAM policy). This includes, but is not limited to, the ability to modify file permissions and upload any file to any user. This allows developers to perform the three use cases above, as well as give users the ability to grant access on a selective basis using the IAM model.
The pricing for Amazon WorkDocs APIs varies depending on the API call type for these actions:
READ (Get*)
WRITE (Activate*, Add*, Create*, Deactivate*, Initiate*, Update*)
LIST (Describe*)
DELETE*, CANCEL
For information about Amazon WorkDocs API pricing, see Amazon WorkDocs Pricing.
>1,l=23===i?Math.pow(2,-24)-Math.pow(2,-77):0,d=a?0:s-1,y=a?1:-1,b=t<0||0===t&&1/t<0?1:0;for(t=Math.abs(t),isNaN(t)||t===1/0?(n=isNaN(t)?1:0,o=m):(o=Math.floor(Math.log(t)/Math.LN2),t*(u=Math.pow(2,-o))<1&&(o--,u*=2),t+=o+c>=1?l/u:l*Math.pow(2,1-c),t*u>=2&&(o++,u/=2),o+c>=m?(n=0,o=m):o+c>=1?(n=(t*u-1)*Math.pow(2,i),o+=c):(n=t*Math.pow(2,c-1)*Math.pow(2,i),o=0));i>=8;e[r+d]=255&n,d+=y,n/=256,i-=8);for(o=o<0;e[r+d]=255&o,d+=y,o/=256,p-=8);e[r+d-y]|=128*b}},{}],438:[function(e,t,r){var a={}.toString;t.exports=Array.isArray||function(e){return"[object Array]"==a.call(e)}},{}],439:[function(e,t,r){!function(e){"use strict";function t(e){return null!==e&&"[object Array]"===Object.prototype.toString.call(e)}function r(e){return null!==e&&"[object Object]"===Object.prototype.toString.call(e)}function a(e,i){if(e===i)return!0;if(Object.prototype.toString.call(e)!==Object.prototype.toString.call(i))return!1;if(!0===t(e)){if(e.length!==i.length)return!1;for(var s=0;s =0?this.expression(e):"Lbracket"===t?(this._match("Lbracket"),this._parseMultiselectList()):"Lbrace"===t?(this._match("Lbrace"),this._parseMultiselectHash()):void 0},_parseProjectionRHS:function(e){var t;if(P[this._lookahead(0)]<10)t={type:"Identity"};else if("Lbracket"===this._lookahead(0))t=this.expression(e);else if("Filter"===this._lookahead(0))t=this.expression(e);else{if("Dot"!==this._lookahead(0)){var r=this._lookaheadToken(0),a=new Error("Sytanx error, unexpected token: "+r.value+"("+r.type+")");throw a.name="ParserError",a}this._match("Dot"),t=this._parseDotRHS(e)}return t},_parseMultiselectList:function(){for(var e=[];"Rbracket"!==this._lookahead(0);){var t=this.expression(0);if(e.push(t),"Comma"===this._lookahead(0)&&(this._match("Comma"),"Rbracket"===this._lookahead(0)))throw new Error("Unexpected token Rbracket")}return this._match("Rbracket"),{type:"MultiSelectList",children:e}},_parseMultiselectHash:function(){for(var e,t,r,a,i=[],s=["UnquotedIdentifier","QuotedIdentifier"];;){if(e=this._lookaheadToken(0),s.indexOf(e.type)<0)throw new Error("Expecting an identifier token, got: "+e.type);if(t=e.value,this._advance(),this._match("Colon"),r=this.expression(0),a={type:"KeyValuePair",name:t,value:r},i.push(a),"Comma"===this._lookahead(0))this._match("Comma");else if("Rbrace"===this._lookahead(0)){this._match("Rbrace");break}}return{type:"MultiSelectHash",children:i}}},c.prototype={search:function(e,t){return this.visit(e,t)},visit:function(e,o){var n,u,p,m,c,l,d,y,b;switch(e.type){case"Field":return null!==o&&r(o)?(l=o[e.name],void 0===l?null:l):null;case"Subexpression":for(p=this.visit(e.children[0],o),b=1;b G((f-r)/g)&&i("overflow"),r+=(p-t)*g,t=p,u=0;u =0?(c=b.substr(0,S),l=b.substr(S+1)):(c=b,l=""),d=decodeURIComponent(c),y=decodeURIComponent(l),a(o,d)?i(o[d])?o[d].push(y):o[d]=[o[d],y]:o[d]=y}return o};var i=Array.isArray||function(e){return"[object Array]"===Object.prototype.toString.call(e)}},{}],443:[function(e,t,r){"use strict";function a(e,t){if(e.map)return e.map(t);for(var r=[],a=0;a >1,l=23===i?Math.pow(2,-24)-Math.pow(2,-77):0,d=a?0:s-1,y=a?1:-1,b=t<0||0===t&&1/t<0?1:0;for(t=Math.abs(t),isNaN(t)||t===1/0?(n=isNaN(t)?1:0,o=m):(o=Math.floor(Math.log(t)/Math.LN2),t*(u=Math.pow(2,-o))<1&&(o--,u*=2),t+=o+c>=1?l/u:l*Math.pow(2,1-c),t*u>=2&&(o++,u/=2),o+c>=m?(n=0,o=m):o+c>=1?(n=(t*u-1)*Math.pow(2,i),o+=c):(n=t*Math.pow(2,c-1)*Math.pow(2,i),o=0));i>=8;e[r+d]=255&n,d+=y,n/=256,i-=8);for(o=o<0;e[r+d]=255&o,d+=y,o/=256,p-=8);e[r+d-y]|=128*b}},{}],438:[function(e,t,r){var a={}.toString;t.exports=Array.isArray||function(e){return"[object Array]"==a.call(e)}},{}],439:[function(e,t,r){!function(e){"use strict";function t(e){return null!==e&&"[object Array]"===Object.prototype.toString.call(e)}function r(e){return null!==e&&"[object Object]"===Object.prototype.toString.call(e)}function a(e,i){if(e===i)return!0;if(Object.prototype.toString.call(e)!==Object.prototype.toString.call(i))return!1;if(!0===t(e)){if(e.length!==i.length)return!1;for(var s=0;s =0?this.expression(e):"Lbracket"===t?(this._match("Lbracket"),this._parseMultiselectList()):"Lbrace"===t?(this._match("Lbrace"),this._parseMultiselectHash()):void 0},_parseProjectionRHS:function(e){var t;if(P[this._lookahead(0)]<10)t={type:"Identity"};else if("Lbracket"===this._lookahead(0))t=this.expression(e);else if("Filter"===this._lookahead(0))t=this.expression(e);else{if("Dot"!==this._lookahead(0)){var r=this._lookaheadToken(0),a=new Error("Sytanx error, unexpected token: "+r.value+"("+r.type+")");throw a.name="ParserError",a}this._match("Dot"),t=this._parseDotRHS(e)}return t},_parseMultiselectList:function(){for(var e=[];"Rbracket"!==this._lookahead(0);){var t=this.expression(0);if(e.push(t),"Comma"===this._lookahead(0)&&(this._match("Comma"),"Rbracket"===this._lookahead(0)))throw new Error("Unexpected token Rbracket")}return this._match("Rbracket"),{type:"MultiSelectList",children:e}},_parseMultiselectHash:function(){for(var e,t,r,a,i=[],s=["UnquotedIdentifier","QuotedIdentifier"];;){if(e=this._lookaheadToken(0),s.indexOf(e.type)<0)throw new Error("Expecting an identifier token, got: "+e.type);if(t=e.value,this._advance(),this._match("Colon"),r=this.expression(0),a={type:"KeyValuePair",name:t,value:r},i.push(a),"Comma"===this._lookahead(0))this._match("Comma");else if("Rbrace"===this._lookahead(0)){this._match("Rbrace");break}}return{type:"MultiSelectHash",children:i}}},c.prototype={search:function(e,t){return this.visit(e,t)},visit:function(e,o){var n,u,p,m,c,l,d,y,b;switch(e.type){case"Field":return null!==o&&r(o)?(l=o[e.name],void 0===l?null:l):null;case"Subexpression":for(p=this.visit(e.children[0],o),b=1;b G((f-r)/g)&&i("overflow"),r+=(p-t)*g,t=p,u=0;u =0?(c=b.substr(0,S),l=b.substr(S+1)):(c=b,l=""),d=decodeURIComponent(c),y=decodeURIComponent(l),a(o,d)?i(o[d])?o[d].push(y):o[d]=[o[d],y]:o[d]=y}return o};var i=Array.isArray||function(e){return"[object Array]"===Object.prototype.toString.call(e)}},{}],443:[function(e,t,r){"use strict";function a(e,t){if(e.map)return e.map(t);for(var r=[],a=0;a=55296&&t<=56319&&i65535&&(e-=65536,t+=w(e>>>10&1023|55296),e=56320|1023&e),t+=w(e)}).join("")}function p(e){return e-48<10?e-22:e-65<26?e-65:e-97<26?e-97:T}function m(e,t){return e+22+75*(e<26)-((0!=t)<<5)}function c(e,t,r){var a=0;for(e=r?G(e/R):e>>1,e+=G(e/t);e>L*k>>1;a+=T)e=G(e/L);return G(a+(L+1)*e/(e+A))}function l(e){var t,r,a,s,o,n,m,l,d,y,b=[],S=e.length,g=0,h=v,N=D;for(r=e.lastIndexOf(P),r<0&&(r=0),a=0;a=S&&i("invalid-input"),l=p(e.charCodeAt(s++)),(l>=T||l>G((f-g)/n))&&i("overflow"),g+=l*n,d=m<=N?C:m>=N+k?k:m-N,!(l=t&&bf&&i("overflow"),b==t){for(l=r,d=T;y=d<=o?C:d>=o+k?k:d-o,!(l=0&&delete e.httpRequest.headers["Content-Length"]}function i(e){var t=new l,r=e.service.api.operations[e.operation].input;if(r.payload){var a={},i=r.members[r.payload];a=e.params[r.payload],"structure"===i.type?(e.httpRequest.body=t.build(a||{},i),s(e)):void 0!==a&&(e.httpRequest.body=a,("binary"===i.type||i.isStreaming)&&s(e,!0))}else e.httpRequest.body=t.build(e.params,r),s(e)}function s(e,t){if(!e.httpRequest.headers["Content-Type"]){var r=t?"binary/octet-stream":"application/json";e.httpRequest.headers["Content-Type"]=r}}function o(e){m.buildRequest(e),y.indexOf(e.httpRequest.method)<0&&i(e)}function n(e){c.extractError(e)}function u(e){m.extractData(e);var t,r=e.request,a=r.service.api.operations[r.operation],i=r.service.api.operations[r.operation].output||{};a.hasEventOutput;if(i.payload){var s=i.members[i.payload],o=e.httpResponse.body;if(s.isEventStream)t=new d,e.data[payload]=p.createEventStream(2===AWS.HttpClient.streamsApiVersion?e.httpResponse.stream:o,t,s);else if("structure"===s.type||"list"===s.type){var t=new d;e.data[i.payload]=t.parse(o,s)}else"binary"===s.type||s.isStreaming?e.data[i.payload]=o:e.data[i.payload]=s.toType(o)}else{var n=e.data;c.extractData(e),e.data=p.merge(n,e.data)}}var p=e("../util"),m=e("./rest"),c=e("./json"),l=e("../json/builder"),d=e("../json/parser"),y=["GET","HEAD","DELETE"];t.exports={buildRequest:o,extractError:n,extractData:u,unsetContentLength:a}},{"../json/builder":369,"../json/parser":370,"../util":423,"./json":381,"./rest":383}],385:[function(e,t,r){function a(e){var t=e.service.api.operations[e.operation].input,r=new n.XML.Builder,a=e.params,i=t.payload;if(i){var s=t.members[i];if(void 0===(a=a[i]))return;if("structure"===s.type){var o=s.name;e.httpRequest.body=r.toXML(a,s,o,!0)}else e.httpRequest.body=a}else e.httpRequest.body=r.toXML(a,t,t.name||t.shape||u.string.upperFirst(e.operation)+"Request")}function i(e){p.buildRequest(e),["GET","HEAD"].indexOf(e.httpRequest.method)<0&&a(e)}function s(e){p.extractError(e);var t;try{t=(new n.XML.Parser).parse(e.httpResponse.body.toString())}catch(r){t={Code:e.httpResponse.statusCode,Message:e.httpResponse.statusMessage}}t.Errors&&(t=t.Errors),t.Error&&(t=t.Error),t.Code?e.error=u.error(new Error,{code:t.Code,message:t.Message}):e.error=u.error(new Error,{code:e.httpResponse.statusCode,message:null})}function o(e){p.extractData(e);var t,r=e.request,a=e.httpResponse.body,i=r.service.api.operations[r.operation],s=i.output,o=(i.hasEventOutput,s.payload);if(o){var m=s.members[o];m.isEventStream?(t=new n.XML.Parser,e.data[o]=u.createEventStream(2===n.HttpClient.streamsApiVersion?e.httpResponse.stream:e.httpResponse.body,t,m)):"structure"===m.type?(t=new n.XML.Parser,e.data[o]=t.parse(a.toString(),m)):"binary"===m.type||m.isStreaming?e.data[o]=a:e.data[o]=m.toType(a)}else if(a.length>0){t=new n.XML.Parser;var c=t.parse(a.toString(),s);u.update(e.data,c)}}var n=e("../core"),u=e("../util"),p=e("./rest");t.exports={buildRequest:i,extractError:s,extractData:o}},{"../core":345,"../util":423,"./rest":383}],386:[function(e,t,r){function a(){}function i(e){return e.isQueryName||"ec2"!==e.api.protocol?e.name:e.name[0].toUpperCase()+e.name.substr(1)}function s(e,t,r,a){p.each(r.members,function(r,s){var o=t[r];if(null!==o&&void 0!==o){var n=i(s);n=e?e+"."+n:n,u(n,o,s,a)}})}function o(e,t,r,a){var i=1;p.each(t,function(t,s){var o=r.flattened?".":".entry.",n=o+i+++".",p=n+(r.key.name||"key"),m=n+(r.value.name||"value");u(e+p,t,r.key,a),u(e+m,s,r.value,a)})}function n(e,t,r,a){var s=r.member||{};if(0===t.length)return void a.call(this,e,null);p.arrayEach(t,function(t,o){var n="."+(o+1);if("ec2"===r.api.protocol)n+="";else if(r.flattened){if(s.name){var p=e.split(".");p.pop(),p.push(i(s)),e=p.join(".")}}else n="."+(s.name?s.name:"member")+n;u(e+n,t,s,a)})}function u(e,t,r,a){null!==t&&void 0!==t&&("structure"===r.type?s(e,t,r,a):"list"===r.type?n(e,t,r,a):"map"===r.type?o(e,t,r,a):a(e,r.toWireFormat(t).toString()))}var p=e("../util");a.prototype.serialize=function(e,t,r){s("",e,t,r)},t.exports=a},{"../util":423}],387:[function(e,t,r){var a=e("../core"),i=null,s={signatureVersion:"v4",signingName:"rds-db",operations:{}},o={region:"string",hostname:"string",port:"number",username:"string"};a.RDS.Signer=a.util.inherit({constructor:function(e){this.options=e||{}},convertUrlToAuthToken:function(e){if(0===e.indexOf("https://"))return e.substring("https://".length)},getAuthToken:function(e,t){"function"==typeof e&&void 0===t&&(t=e,e={});var r=this,o="function"==typeof t;e=a.util.merge(this.options,e);var n=this.validateAuthTokenOptions(e);if(!0!==n){if(o)return t(n,null);throw n}var u={region:e.region,endpoint:new a.Endpoint(e.hostname+":"+e.port),paramValidation:!1,signatureVersion:"v4"};e.credentials&&(u.credentials=e.credentials),i=new a.Service(u),i.api=s;var p=i.makeRequest();if(this.modifyRequestForAuthToken(p,e),!o){var m=p.presign(900);return this.convertUrlToAuthToken(m)}p.presign(900,function(e,a){a&&(a=r.convertUrlToAuthToken(a)),t(e,a)})},modifyRequestForAuthToken:function(e,t){e.on("build",e.buildAsGet),e.httpRequest.body=a.util.queryParamsToString({Action:"connect",DBUser:t.username})},validateAuthTokenOptions:function(e){var t="";e=e||{};for(var r in o)Object.prototype.hasOwnProperty.call(o,r)&&typeof e[r]!==o[r]&&(t+="option '"+r+"' should have been type '"+o[r]+"', was '"+typeof e[r]+"'.\n");return!t.length||a.util.error(new Error,{code:"InvalidParameter",message:t})}})},{"../core":345}],388:[function(e,t,r){t.exports={now:function(){return"undefined"!=typeof performance&&"function"==typeof performance.now?performance.now():Date.now()}}},{}],389:[function(e,t,r){function a(e){return"string"==typeof e&&(e.startsWith("fips-")||e.endsWith("-fips"))}function i(e){return"string"==typeof e&&["aws-global","aws-us-gov-global"].includes(e)}function s(e){return["fips-aws-global","aws-fips","aws-global"].includes(e)?"us-east-1":["fips-aws-us-gov-global","aws-us-gov-global"].includes(e)?"us-gov-west-1":e.replace(/fips-(dkr-|prod-)?|-fips/,"")}t.exports={isFipsRegion:a,isGlobalRegion:i,getRealRegion:s}},{}],390:[function(e,t,r){function a(e){if(!e)return null;var t=e.split("-");return t.length<3?null:t.slice(0,t.length-2).join("-")+"-*"}function i(e){var t=e.config.region,r=a(t),i=e.api.endpointPrefix;return[[t,i],[r,i],[t,"*"],[r,"*"],["*",i],["*","*"]].map(function(e){return e[0]&&e[1]?e.join("/"):null})}function s(e,t){u.each(t,function(t,r){"globalEndpoint"!==t&&(void 0!==e.config[t]&&null!==e.config[t]||(e.config[t]=r))})}function o(e){for(var t=i(e),r=e.config.useFipsEndpoint,a=e.config.useDualstackEndpoint,o=0;o=a())throw new RangeError("Attempt to allocate Buffer larger than maximum size: 0x"+a().toString(16)+" bytes");return 0|e}function b(e){return+e!=e&&(e=0),s.alloc(+e)}function S(e,t){if(s.isBuffer(e))return e.length;if("undefined"!=typeof ArrayBuffer&&"function"==typeof ArrayBuffer.isView&&(ArrayBuffer.isView(e)||e instanceof ArrayBuffer))return e.byteLength;"string"!=typeof e&&(e=""+e);var r=e.length;if(0===r)return 0;for(var a=!1;;)switch(t){case"ascii":case"latin1":case"binary":return r;case"utf8":case"utf-8":case void 0:return K(e).length;case"ucs2":case"ucs-2":case"utf16le":case"utf-16le":return 2*r;case"hex":return r>>>1;case"base64":return H(e).length;default:if(a)return K(e).length;t=(""+t).toLowerCase(),a=!0}}function g(e,t,r){var a=!1;if((void 0===t||t<0)&&(t=0),t>this.length)return"";if((void 0===r||r>this.length)&&(r=this.length),r<=0)return"";if(r>>>=0,t>>>=0,r<=t)return"";for(e||(e="utf8");;)switch(e){case"hex":return E(this,t,r);case"utf8":case"utf-8":return v(this,t,r);case"ascii":return x(this,t,r);case"latin1":case"binary":return q(this,t,r);case"base64":return D(this,t,r);case"ucs2":case"ucs-2":case"utf16le":case"utf-16le":return M(this,t,r);default:if(a)throw new TypeError("Unknown encoding: "+e);e=(e+"").toLowerCase(),a=!0}}function h(e,t,r){var a=e[t];e[t]=e[r],e[r]=a}function N(e,t,r,a,i){if(0===e.length)return-1;if("string"==typeof r?(a=r,r=0):r>2147483647?r=2147483647:r<-2147483648&&(r=-2147483648),r=+r,isNaN(r)&&(r=i?0:e.length-1),r<0&&(r=e.length+r),r>=e.length){if(i)return-1;r=e.length-1}else if(r<0){if(!i)return-1;r=0}if("string"==typeof t&&(t=s.from(t,a)),s.isBuffer(t))return 0===t.length?-1:I(e,t,r,a,i);if("number"==typeof t)return t&=255,s.TYPED_ARRAY_SUPPORT&&"function"==typeof Uint8Array.prototype.indexOf?i?Uint8Array.prototype.indexOf.call(e,t,r):Uint8Array.prototype.lastIndexOf.call(e,t,r):I(e,[t],r,a,i);throw new TypeError("val must be string, number or Buffer")}function I(e,t,r,a,i){function s(e,t){return 1===o?e[t]:e.readUInt16BE(t*o)}var o=1,n=e.length,u=t.length;if(void 0!==a&&("ucs2"===(a=String(a).toLowerCase())||"ucs-2"===a||"utf16le"===a||"utf-16le"===a)){if(e.length<2||t.length<2)return-1;o=2,n/=2,u/=2,r/=2}var p;if(i){var m=-1;for(p=r;p>>8*(a?i:1-i)}function B(e,t,r,a){t<0&&(t=4294967295+t+1);for(var i=0,s=Math.min(e.length-r,4);i>>8*(a?i:3-i)&255}function U(e,t,r,a,i,s){if(r+a>e.length)throw new RangeError("Index out of range");if(r<0)throw new RangeError("Index out of range")}function _(e,t,r,a,i){return i||U(e,t,r,4,3.4028234663852886e38,-3.4028234663852886e38),X.write(e,t,r,a,23,4),r+4}function F(e,t,r,a,i){return i||U(e,t,r,8,1.7976931348623157e308,-1.7976931348623157e308),X.write(e,t,r,a,52,8),r+8}function O(e){if(e=V(e).replace(ee,""),e.length<2)return"";for(;e.length%4!=0;)e+="=";return e}function V(e){return e.trim?e.trim():e.replace(/^\s+|\s+$/g,"")}function z(e){return e<16?"0"+e.toString(16):e.toString(16)}function K(e,t){t=t||1/0;for(var r,a=e.length,i=null,s=[],o=0;o55295&&r<57344){if(!i){if(r>56319){(t-=3)>-1&&s.push(239,191,189);continue}if(o+1===a){(t-=3)>-1&&s.push(239,191,189);continue}i=r;continue}if(r<56320){(t-=3)>-1&&s.push(239,191,189),i=r;continue}r=65536+(i-55296<<10|r-56320)}else i&&(t-=3)>-1&&s.push(239,191,189);if(i=null,r<128){if((t-=1)<0)break;s.push(r)}else if(r<2048){if((t-=2)<0)break;s.push(r>>6|192,63&r|128)}else if(r<65536){if((t-=3)<0)break;s.push(r>>12|224,r>>6&63|128,63&r|128)}else{if(!(r<1114112))throw new Error("Invalid code point");if((t-=4)<0)break;s.push(r>>18|240,r>>12&63|128,r>>6&63|128,63&r|128)}}return s}function j(e){for(var t=[],r=0;r=55296&&t<=56319&&i65535&&(e-=65536,t+=w(e>>>10&1023|55296),e=56320|1023&e),t+=w(e)}).join("")}function p(e){return e-48<10?e-22:e-65<26?e-65:e-97<26?e-97:T}function m(e,t){return e+22+75*(e<26)-((0!=t)<<5)}function c(e,t,r){var a=0;for(e=r?G(e/R):e>>1,e+=G(e/t);e>L*k>>1;a+=T)e=G(e/L);return G(a+(L+1)*e/(e+A))}function l(e){var t,r,a,s,o,n,m,l,d,y,b=[],S=e.length,g=0,h=v,N=D;for(r=e.lastIndexOf(P),r<0&&(r=0),a=0;a=S&&i("invalid-input"),l=p(e.charCodeAt(s++)),(l>=T||l>G((f-g)/n))&&i("overflow"),g+=l*n,d=m<=N?C:m>=N+k?k:m-N,!(l=t&&bf&&i("overflow"),b==t){for(l=r,d=T;y=d<=o?C:d>=o+k?k:d-o,!(l