1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293 294 295 296 297 298 299 300 301 302 303 304 305 306 307 308 309 310 311 312 313 314 315 316 317 318 319 320 321 322 323 324 325 326 327 328 329 330 331 332 333 334 335 336 337 338 339 340 341 342 343 344 345 346 347 348 349 350 351 352 353 354 355 356 357 358 359 360 361 362 363 364 365 366 367 368 369 370 371 372 373 374 375 376 377 378 379 380 381 382 383 384 385 386 387 388 389 390 391 392 393 394 395 396 397 398 399 400 401 402 403 404 405 406 407 408 409 410 411 412 413 414 415 416 417 418 419 420 421 422 423
|
// Code generated by smithy-go-codegen DO NOT EDIT.
package applicationautoscaling
import (
"context"
"fmt"
awsmiddleware "github.com/aws/aws-sdk-go-v2/aws/middleware"
"github.com/aws/aws-sdk-go-v2/service/applicationautoscaling/types"
"github.com/aws/smithy-go/middleware"
smithyhttp "github.com/aws/smithy-go/transport/http"
)
// Describes the Application Auto Scaling scaling policies for the specified
// service namespace.
//
// You can filter the results using ResourceId , ScalableDimension , and
// PolicyNames .
//
// For more information, see [Target tracking scaling policies] and [Step scaling policies] in the Application Auto Scaling User Guide.
//
// [Step scaling policies]: https://docs.aws.amazon.com/autoscaling/application/userguide/application-auto-scaling-step-scaling-policies.html
// [Target tracking scaling policies]: https://docs.aws.amazon.com/autoscaling/application/userguide/application-auto-scaling-target-tracking.html
func (c *Client) DescribeScalingPolicies(ctx context.Context, params *DescribeScalingPoliciesInput, optFns ...func(*Options)) (*DescribeScalingPoliciesOutput, error) {
if params == nil {
params = &DescribeScalingPoliciesInput{}
}
result, metadata, err := c.invokeOperation(ctx, "DescribeScalingPolicies", params, optFns, c.addOperationDescribeScalingPoliciesMiddlewares)
if err != nil {
return nil, err
}
out := result.(*DescribeScalingPoliciesOutput)
out.ResultMetadata = metadata
return out, nil
}
type DescribeScalingPoliciesInput struct {
// The namespace of the Amazon Web Services service that provides the resource.
// For a resource provided by your own application or service, use custom-resource
// instead.
//
// This member is required.
ServiceNamespace types.ServiceNamespace
// The maximum number of scalable targets. This value can be between 1 and 10. The
// default value is 10.
//
// If this parameter is used, the operation returns up to MaxResults results at a
// time, along with a NextToken value. To get the next set of results, include the
// NextToken value in a subsequent call. If this parameter is not used, the
// operation returns up to 10 results and a NextToken value, if applicable.
MaxResults *int32
// The token for the next set of results.
NextToken *string
// The names of the scaling policies to describe.
PolicyNames []string
// The identifier of the resource associated with the scaling policy. This string
// consists of the resource type and unique identifier.
//
// - ECS service - The resource type is service and the unique identifier is the
// cluster name and service name. Example: service/my-cluster/my-service .
//
// - Spot Fleet - The resource type is spot-fleet-request and the unique
// identifier is the Spot Fleet request ID. Example:
// spot-fleet-request/sfr-73fbd2ce-aa30-494c-8788-1cee4EXAMPLE .
//
// - EMR cluster - The resource type is instancegroup and the unique identifier
// is the cluster ID and instance group ID. Example:
// instancegroup/j-2EEZNYKUA1NTV/ig-1791Y4E1L8YI0 .
//
// - AppStream 2.0 fleet - The resource type is fleet and the unique identifier
// is the fleet name. Example: fleet/sample-fleet .
//
// - DynamoDB table - The resource type is table and the unique identifier is the
// table name. Example: table/my-table .
//
// - DynamoDB global secondary index - The resource type is index and the unique
// identifier is the index name. Example: table/my-table/index/my-table-index .
//
// - Aurora DB cluster - The resource type is cluster and the unique identifier
// is the cluster name. Example: cluster:my-db-cluster .
//
// - SageMaker endpoint variant - The resource type is variant and the unique
// identifier is the resource ID. Example:
// endpoint/my-end-point/variant/KMeansClustering .
//
// - Custom resources are not supported with a resource type. This parameter
// must specify the OutputValue from the CloudFormation template stack used to
// access the resources. The unique identifier is defined by the service provider.
// More information is available in our [GitHub repository].
//
// - Amazon Comprehend document classification endpoint - The resource type and
// unique identifier are specified using the endpoint ARN. Example:
// arn:aws:comprehend:us-west-2:123456789012:document-classifier-endpoint/EXAMPLE
// .
//
// - Amazon Comprehend entity recognizer endpoint - The resource type and unique
// identifier are specified using the endpoint ARN. Example:
// arn:aws:comprehend:us-west-2:123456789012:entity-recognizer-endpoint/EXAMPLE .
//
// - Lambda provisioned concurrency - The resource type is function and the
// unique identifier is the function name with a function version or alias name
// suffix that is not $LATEST . Example: function:my-function:prod or
// function:my-function:1 .
//
// - Amazon Keyspaces table - The resource type is table and the unique
// identifier is the table name. Example: keyspace/mykeyspace/table/mytable .
//
// - Amazon MSK cluster - The resource type and unique identifier are specified
// using the cluster ARN. Example:
// arn:aws:kafka:us-east-1:123456789012:cluster/demo-cluster-1/6357e0b2-0e6a-4b86-a0b4-70df934c2e31-5
// .
//
// - Amazon ElastiCache replication group - The resource type is
// replication-group and the unique identifier is the replication group name.
// Example: replication-group/mycluster .
//
// - Neptune cluster - The resource type is cluster and the unique identifier is
// the cluster name. Example: cluster:mycluster .
//
// - SageMaker serverless endpoint - The resource type is variant and the unique
// identifier is the resource ID. Example:
// endpoint/my-end-point/variant/KMeansClustering .
//
// - SageMaker inference component - The resource type is inference-component and
// the unique identifier is the resource ID. Example:
// inference-component/my-inference-component .
//
// - Pool of WorkSpaces - The resource type is workspacespool and the unique
// identifier is the pool ID. Example: workspacespool/wspool-123456 .
//
// [GitHub repository]: https://github.com/aws/aws-auto-scaling-custom-resource
ResourceId *string
// The scalable dimension. This string consists of the service namespace, resource
// type, and scaling property. If you specify a scalable dimension, you must also
// specify a resource ID.
//
// - ecs:service:DesiredCount - The task count of an ECS service.
//
// - elasticmapreduce:instancegroup:InstanceCount - The instance count of an EMR
// Instance Group.
//
// - ec2:spot-fleet-request:TargetCapacity - The target capacity of a Spot Fleet.
//
// - appstream:fleet:DesiredCapacity - The capacity of an AppStream 2.0 fleet.
//
// - dynamodb:table:ReadCapacityUnits - The provisioned read capacity for a
// DynamoDB table.
//
// - dynamodb:table:WriteCapacityUnits - The provisioned write capacity for a
// DynamoDB table.
//
// - dynamodb:index:ReadCapacityUnits - The provisioned read capacity for a
// DynamoDB global secondary index.
//
// - dynamodb:index:WriteCapacityUnits - The provisioned write capacity for a
// DynamoDB global secondary index.
//
// - rds:cluster:ReadReplicaCount - The count of Aurora Replicas in an Aurora DB
// cluster. Available for Aurora MySQL-compatible edition and Aurora
// PostgreSQL-compatible edition.
//
// - sagemaker:variant:DesiredInstanceCount - The number of EC2 instances for a
// SageMaker model endpoint variant.
//
// - custom-resource:ResourceType:Property - The scalable dimension for a custom
// resource provided by your own application or service.
//
// - comprehend:document-classifier-endpoint:DesiredInferenceUnits - The number
// of inference units for an Amazon Comprehend document classification endpoint.
//
// - comprehend:entity-recognizer-endpoint:DesiredInferenceUnits - The number of
// inference units for an Amazon Comprehend entity recognizer endpoint.
//
// - lambda:function:ProvisionedConcurrency - The provisioned concurrency for a
// Lambda function.
//
// - cassandra:table:ReadCapacityUnits - The provisioned read capacity for an
// Amazon Keyspaces table.
//
// - cassandra:table:WriteCapacityUnits - The provisioned write capacity for an
// Amazon Keyspaces table.
//
// - kafka:broker-storage:VolumeSize - The provisioned volume size (in GiB) for
// brokers in an Amazon MSK cluster.
//
// - elasticache:replication-group:NodeGroups - The number of node groups for an
// Amazon ElastiCache replication group.
//
// - elasticache:replication-group:Replicas - The number of replicas per node
// group for an Amazon ElastiCache replication group.
//
// - neptune:cluster:ReadReplicaCount - The count of read replicas in an Amazon
// Neptune DB cluster.
//
// - sagemaker:variant:DesiredProvisionedConcurrency - The provisioned
// concurrency for a SageMaker serverless endpoint.
//
// - sagemaker:inference-component:DesiredCopyCount - The number of copies across
// an endpoint for a SageMaker inference component.
//
// - workspaces:workspacespool:DesiredUserSessions - The number of user sessions
// for the WorkSpaces in the pool.
ScalableDimension types.ScalableDimension
noSmithyDocumentSerde
}
type DescribeScalingPoliciesOutput struct {
// The token required to get the next set of results. This value is null if there
// are no more results to return.
NextToken *string
// Information about the scaling policies.
ScalingPolicies []types.ScalingPolicy
// Metadata pertaining to the operation's result.
ResultMetadata middleware.Metadata
noSmithyDocumentSerde
}
func (c *Client) addOperationDescribeScalingPoliciesMiddlewares(stack *middleware.Stack, options Options) (err error) {
if err := stack.Serialize.Add(&setOperationInputMiddleware{}, middleware.After); err != nil {
return err
}
err = stack.Serialize.Add(&awsAwsjson11_serializeOpDescribeScalingPolicies{}, middleware.After)
if err != nil {
return err
}
err = stack.Deserialize.Add(&awsAwsjson11_deserializeOpDescribeScalingPolicies{}, middleware.After)
if err != nil {
return err
}
if err := addProtocolFinalizerMiddlewares(stack, options, "DescribeScalingPolicies"); err != nil {
return fmt.Errorf("add protocol finalizers: %v", err)
}
if err = addlegacyEndpointContextSetter(stack, options); err != nil {
return err
}
if err = addSetLoggerMiddleware(stack, options); err != nil {
return err
}
if err = addClientRequestID(stack); err != nil {
return err
}
if err = addComputeContentLength(stack); err != nil {
return err
}
if err = addResolveEndpointMiddleware(stack, options); err != nil {
return err
}
if err = addComputePayloadSHA256(stack); err != nil {
return err
}
if err = addRetry(stack, options); err != nil {
return err
}
if err = addRawResponseToMetadata(stack); err != nil {
return err
}
if err = addRecordResponseTiming(stack); err != nil {
return err
}
if err = addClientUserAgent(stack, options); err != nil {
return err
}
if err = smithyhttp.AddErrorCloseResponseBodyMiddleware(stack); err != nil {
return err
}
if err = smithyhttp.AddCloseResponseBodyMiddleware(stack); err != nil {
return err
}
if err = addSetLegacyContextSigningOptionsMiddleware(stack); err != nil {
return err
}
if err = addTimeOffsetBuild(stack, c); err != nil {
return err
}
if err = addUserAgentRetryMode(stack, options); err != nil {
return err
}
if err = addOpDescribeScalingPoliciesValidationMiddleware(stack); err != nil {
return err
}
if err = stack.Initialize.Add(newServiceMetadataMiddleware_opDescribeScalingPolicies(options.Region), middleware.Before); err != nil {
return err
}
if err = addRecursionDetection(stack); err != nil {
return err
}
if err = addRequestIDRetrieverMiddleware(stack); err != nil {
return err
}
if err = addResponseErrorMiddleware(stack); err != nil {
return err
}
if err = addRequestResponseLogging(stack, options); err != nil {
return err
}
if err = addDisableHTTPSMiddleware(stack, options); err != nil {
return err
}
return nil
}
// DescribeScalingPoliciesPaginatorOptions is the paginator options for
// DescribeScalingPolicies
type DescribeScalingPoliciesPaginatorOptions struct {
// The maximum number of scalable targets. This value can be between 1 and 10. The
// default value is 10.
//
// If this parameter is used, the operation returns up to MaxResults results at a
// time, along with a NextToken value. To get the next set of results, include the
// NextToken value in a subsequent call. If this parameter is not used, the
// operation returns up to 10 results and a NextToken value, if applicable.
Limit int32
// Set to true if pagination should stop if the service returns a pagination token
// that matches the most recent token provided to the service.
StopOnDuplicateToken bool
}
// DescribeScalingPoliciesPaginator is a paginator for DescribeScalingPolicies
type DescribeScalingPoliciesPaginator struct {
options DescribeScalingPoliciesPaginatorOptions
client DescribeScalingPoliciesAPIClient
params *DescribeScalingPoliciesInput
nextToken *string
firstPage bool
}
// NewDescribeScalingPoliciesPaginator returns a new
// DescribeScalingPoliciesPaginator
func NewDescribeScalingPoliciesPaginator(client DescribeScalingPoliciesAPIClient, params *DescribeScalingPoliciesInput, optFns ...func(*DescribeScalingPoliciesPaginatorOptions)) *DescribeScalingPoliciesPaginator {
if params == nil {
params = &DescribeScalingPoliciesInput{}
}
options := DescribeScalingPoliciesPaginatorOptions{}
if params.MaxResults != nil {
options.Limit = *params.MaxResults
}
for _, fn := range optFns {
fn(&options)
}
return &DescribeScalingPoliciesPaginator{
options: options,
client: client,
params: params,
firstPage: true,
nextToken: params.NextToken,
}
}
// HasMorePages returns a boolean indicating whether more pages are available
func (p *DescribeScalingPoliciesPaginator) HasMorePages() bool {
return p.firstPage || (p.nextToken != nil && len(*p.nextToken) != 0)
}
// NextPage retrieves the next DescribeScalingPolicies page.
func (p *DescribeScalingPoliciesPaginator) NextPage(ctx context.Context, optFns ...func(*Options)) (*DescribeScalingPoliciesOutput, error) {
if !p.HasMorePages() {
return nil, fmt.Errorf("no more pages available")
}
params := *p.params
params.NextToken = p.nextToken
var limit *int32
if p.options.Limit > 0 {
limit = &p.options.Limit
}
params.MaxResults = limit
optFns = append([]func(*Options){
addIsPaginatorUserAgent,
}, optFns...)
result, err := p.client.DescribeScalingPolicies(ctx, ¶ms, optFns...)
if err != nil {
return nil, err
}
p.firstPage = false
prevToken := p.nextToken
p.nextToken = result.NextToken
if p.options.StopOnDuplicateToken &&
prevToken != nil &&
p.nextToken != nil &&
*prevToken == *p.nextToken {
p.nextToken = nil
}
return result, nil
}
// DescribeScalingPoliciesAPIClient is a client that implements the
// DescribeScalingPolicies operation.
type DescribeScalingPoliciesAPIClient interface {
DescribeScalingPolicies(context.Context, *DescribeScalingPoliciesInput, ...func(*Options)) (*DescribeScalingPoliciesOutput, error)
}
var _ DescribeScalingPoliciesAPIClient = (*Client)(nil)
func newServiceMetadataMiddleware_opDescribeScalingPolicies(region string) *awsmiddleware.RegisterServiceMetadata {
return &awsmiddleware.RegisterServiceMetadata{
Region: region,
ServiceID: ServiceID,
OperationName: "DescribeScalingPolicies",
}
}
|