2022-10-06 16:46:51 -04:00
// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
// SPDX-License-Identifier: Apache-2.0
2021-11-15 13:15:43 +00:00
/**
2022-10-06 16:46:51 -04:00
* Before running this C++ code example, set up your development environment, including your credentials.
*
* For more information, see the following documentation topic:
2022-10-14 09:27:14 -04:00
* https://docs.aws.amazon.com/sdk-for-cpp/v1/developer-guide/getting-started.html.
2022-10-06 16:46:51 -04:00
*
2022-10-12 14:52:10 -04:00
* For information on the structure of the code examples and how to build and run the examples, see
* https://docs.aws.amazon.com/sdk-for-cpp/v1/developer-guide/getting-started-code-examples.html.
*
2022-10-06 16:46:51 -04:00
* Purpose
*
* Demonstrates getting an IAM policy's information.
*
*/
2022-10-07 15:58:01 -04:00
// snippet-start:[iam.cpp.get_policy.inc]
# include <aws/core/Aws.h>
# include <aws/iam/IAMClient.h>
# include <aws/iam/model/GetPolicyRequest.h>
# include <aws/iam/model/GetPolicyResult.h>
# include <iostream>
# include "iam_samples.h"
// snippet-end:[iam.cpp.get_policy.inc]
2022-10-06 16:46:51 -04:00
//! Gets an IAM policy's information.
/*!
\sa getPolicy()
2022-10-14 09:27:14 -04:00
\param policyArn: The policy Amazon Resource Name (ARN).
2022-10-06 16:46:51 -04:00
\param clientConfig: Aws client configuration.
\return bool: Successful completion.
*/
2022-10-20 15:00:56 -04:00
// snippet-start:[iam.cpp.get_policy.code]
2022-10-07 15:58:01 -04:00
bool AwsDoc : : IAM : : getPolicy ( const Aws : : String & policyArn ,
const Aws : : Client : : ClientConfiguration & clientConfig ) {
Aws : : IAM : : IAMClient iam ( clientConfig ) ;
2022-10-06 16:46:51 -04:00
Aws : : IAM : : Model : : GetPolicyRequest request ;
request . SetPolicyArn ( policyArn ) ;
auto outcome = iam . GetPolicy ( request ) ;
2022-10-07 15:58:01 -04:00
if ( ! outcome . IsSuccess ( ) ) {
2022-10-06 16:46:51 -04:00
std : : cerr < < " Error getting policy " < < policyArn < < " : " < <
outcome . GetError ( ) . GetMessage ( ) < < std : : endl ;
}
2022-10-07 15:58:01 -04:00
else {
2022-10-06 16:46:51 -04:00
const auto & policy = outcome . GetResult ( ) . GetPolicy ( ) ;
std : : cout < < " Name: " < < policy . GetPolicyName ( ) < < std : : endl < <
" ID: " < < policy . GetPolicyId ( ) < < std : : endl < < " Arn: " < <
policy . GetArn ( ) < < std : : endl < < " Description: " < <
policy . GetDescription ( ) < < std : : endl < < " CreateDate: " < <
policy . GetCreateDate ( ) . ToGmtString ( Aws : : Utils : : DateFormat : : ISO_8601 )
< < std : : endl ;
}
return outcome . IsSuccess ( ) ;
}
// snippet-end:[iam.cpp.get_policy.code]
/*
*
* main function
*
2022-10-07 15:58:01 -04:00
* Prerequisites: Existing IAM policy.
*
2022-10-06 16:46:51 -04:00
* Usage: 'run_get_policy <policy_arn>'
*
2021-11-15 13:15:43 +00:00
*/
2022-10-06 16:46:51 -04:00
# ifndef TESTING_BUILD
2022-10-07 15:58:01 -04:00
int main ( int argc , char * * argv ) {
if ( argc ! = 2 ) {
2022-10-06 16:46:51 -04:00
std : : cout < < " Usage: run_get_policy <policy_arn> " < < std : : endl ;
2021-11-15 13:15:43 +00:00
return 1 ;
}
Aws : : SDKOptions options ;
Aws : : InitAPI ( options ) ;
{
2022-10-06 16:46:51 -04:00
Aws : : String policyArn ( argv [ 1 ] ) ;
2021-11-15 13:15:43 +00:00
2022-10-06 16:46:51 -04:00
Aws : : Client : : ClientConfiguration clientConfig ;
// Optional: Set to the AWS Region in which the bucket was created (overrides config file).
// clientConfig.region = "us-east-1";
AwsDoc : : IAM : : getPolicy ( policyArn , clientConfig ) ;
2021-11-15 13:15:43 +00:00
}
Aws : : ShutdownAPI ( options ) ;
return 0 ;
}
2022-10-07 15:58:01 -04:00
2022-10-06 16:46:51 -04:00
# endif // TESTING_BUILD
2021-11-15 13:15:43 +00:00