1// Code generated by smithy-go-codegen DO NOT EDIT.
2
3package pi
4
5import (
6	"context"
7	awsmiddleware "github.com/aws/aws-sdk-go-v2/aws/middleware"
8	"github.com/aws/aws-sdk-go-v2/aws/signer/v4"
9	"github.com/aws/aws-sdk-go-v2/service/pi/types"
10	"github.com/aws/smithy-go/middleware"
11	smithyhttp "github.com/aws/smithy-go/transport/http"
12)
13
14// Get the attributes of the specified dimension group for a DB instance or data
15// source. For example, if you specify a SQL ID, GetDimensionKeyDetails retrieves
16// the full text of the dimension db.sql.statement associated with this ID. This
17// operation is useful because GetResourceMetrics and DescribeDimensionKeys don't
18// support retrieval of large SQL statement text.
19func (c *Client) GetDimensionKeyDetails(ctx context.Context, params *GetDimensionKeyDetailsInput, optFns ...func(*Options)) (*GetDimensionKeyDetailsOutput, error) {
20	if params == nil {
21		params = &GetDimensionKeyDetailsInput{}
22	}
23
24	result, metadata, err := c.invokeOperation(ctx, "GetDimensionKeyDetails", params, optFns, c.addOperationGetDimensionKeyDetailsMiddlewares)
25	if err != nil {
26		return nil, err
27	}
28
29	out := result.(*GetDimensionKeyDetailsOutput)
30	out.ResultMetadata = metadata
31	return out, nil
32}
33
34type GetDimensionKeyDetailsInput struct {
35
36	// The name of the dimension group. The only valid value is db.sql. Performance
37	// Insights searches the specified group for the dimension group ID.
38	//
39	// This member is required.
40	Group *string
41
42	// The ID of the dimension group from which to retrieve dimension details. For
43	// dimension group db.sql, the group ID is db.sql.id.
44	//
45	// This member is required.
46	GroupIdentifier *string
47
48	// The ID for a data source from which to gather dimension data. This ID must be
49	// immutable and unique within an AWS Region. When a DB instance is the data
50	// source, specify its DbiResourceId value. For example, specify
51	// db-ABCDEFGHIJKLMNOPQRSTU1VW2X.
52	//
53	// This member is required.
54	Identifier *string
55
56	// The AWS service for which Performance Insights returns data. The only valid
57	// value is RDS.
58	//
59	// This member is required.
60	ServiceType types.ServiceType
61
62	// A list of dimensions to retrieve the detail data for within the given dimension
63	// group. For the dimension group db.sql, specify either the full dimension name
64	// db.sql.statement or the short dimension name statement. If you don't specify
65	// this parameter, Performance Insights returns all dimension data within the
66	// specified dimension group.
67	RequestedDimensions []string
68
69	noSmithyDocumentSerde
70}
71
72type GetDimensionKeyDetailsOutput struct {
73
74	// The details for the requested dimensions.
75	Dimensions []types.DimensionKeyDetail
76
77	// Metadata pertaining to the operation's result.
78	ResultMetadata middleware.Metadata
79
80	noSmithyDocumentSerde
81}
82
83func (c *Client) addOperationGetDimensionKeyDetailsMiddlewares(stack *middleware.Stack, options Options) (err error) {
84	err = stack.Serialize.Add(&awsAwsjson11_serializeOpGetDimensionKeyDetails{}, middleware.After)
85	if err != nil {
86		return err
87	}
88	err = stack.Deserialize.Add(&awsAwsjson11_deserializeOpGetDimensionKeyDetails{}, middleware.After)
89	if err != nil {
90		return err
91	}
92	if err = addSetLoggerMiddleware(stack, options); err != nil {
93		return err
94	}
95	if err = awsmiddleware.AddClientRequestIDMiddleware(stack); err != nil {
96		return err
97	}
98	if err = smithyhttp.AddComputeContentLengthMiddleware(stack); err != nil {
99		return err
100	}
101	if err = addResolveEndpointMiddleware(stack, options); err != nil {
102		return err
103	}
104	if err = v4.AddComputePayloadSHA256Middleware(stack); err != nil {
105		return err
106	}
107	if err = addRetryMiddlewares(stack, options); err != nil {
108		return err
109	}
110	if err = addHTTPSignerV4Middleware(stack, options); err != nil {
111		return err
112	}
113	if err = awsmiddleware.AddRawResponseToMetadata(stack); err != nil {
114		return err
115	}
116	if err = awsmiddleware.AddRecordResponseTiming(stack); err != nil {
117		return err
118	}
119	if err = addClientUserAgent(stack); err != nil {
120		return err
121	}
122	if err = smithyhttp.AddErrorCloseResponseBodyMiddleware(stack); err != nil {
123		return err
124	}
125	if err = smithyhttp.AddCloseResponseBodyMiddleware(stack); err != nil {
126		return err
127	}
128	if err = addOpGetDimensionKeyDetailsValidationMiddleware(stack); err != nil {
129		return err
130	}
131	if err = stack.Initialize.Add(newServiceMetadataMiddleware_opGetDimensionKeyDetails(options.Region), middleware.Before); err != nil {
132		return err
133	}
134	if err = addRequestIDRetrieverMiddleware(stack); err != nil {
135		return err
136	}
137	if err = addResponseErrorMiddleware(stack); err != nil {
138		return err
139	}
140	if err = addRequestResponseLogging(stack, options); err != nil {
141		return err
142	}
143	return nil
144}
145
146func newServiceMetadataMiddleware_opGetDimensionKeyDetails(region string) *awsmiddleware.RegisterServiceMetadata {
147	return &awsmiddleware.RegisterServiceMetadata{
148		Region:        region,
149		ServiceID:     ServiceID,
150		SigningName:   "pi",
151		OperationName: "GetDimensionKeyDetails",
152	}
153}
154