package Paws::SecretsManager::PutResourcePolicy; use Moose; has BlockPublicPolicy => (is => 'ro', isa => 'Bool'); has ResourcePolicy => (is => 'ro', isa => 'Str', required => 1); has SecretId => (is => 'ro', isa => 'Str', required => 1); use MooseX::ClassAttribute; class_has _api_call => (isa => 'Str', is => 'ro', default => 'PutResourcePolicy'); class_has _returns => (isa => 'Str', is => 'ro', default => 'Paws::SecretsManager::PutResourcePolicyResponse'); class_has _result_key => (isa => 'Str', is => 'ro'); 1; ### main pod documentation begin ### =head1 NAME Paws::SecretsManager::PutResourcePolicy - Arguments for method PutResourcePolicy on L =head1 DESCRIPTION This class represents the parameters used for calling the method PutResourcePolicy on the L service. Use the attributes of this class as arguments to method PutResourcePolicy. You shouldn't make instances of this class. Each attribute should be used as a named argument in the call to PutResourcePolicy. =head1 SYNOPSIS my $secretsmanager = Paws->service('SecretsManager'); # To add a resource-based policy to a secret # The following example shows how to add a resource-based policy to a secret. my $PutResourcePolicyResponse = $secretsmanager->PutResourcePolicy( 'ResourcePolicy' => '{ "Version":"2012-10-17", "Statement":[{ "Effect":"Allow", "Principal":{ "AWS":"arn:aws:iam::123456789012:root" }, "Action":"secretsmanager:GetSecretValue", "Resource":"*" }] }', 'SecretId' => 'MyTestDatabaseSecret' ); # Results: my $ARN = $PutResourcePolicyResponse->ARN; my $Name = $PutResourcePolicyResponse->Name; # Returns a L object. Values for attributes that are native types (Int, String, Float, etc) can passed as-is (scalar values). Values for complex Types (objects) can be passed as a HashRef. The keys and values of the hashref will be used to instance the underlying object. For the AWS API documentation, see L =head1 ATTRIBUTES =head2 BlockPublicPolicy => Bool (Optional) If you set the parameter, C to true, then you block resource-based policies that allow broad access to the secret. =head2 B ResourcePolicy => Str A JSON-formatted string constructed according to the grammar and syntax for an AWS resource-based policy. The policy in the string identifies who can access or manage this secret and its versions. For information on how to format a JSON parameter for the various command line tool environments, see Using JSON for Parameters (http://docs.aws.amazon.com/cli/latest/userguide/cli-using-param.html#cli-using-param-json) in the I. =head2 B SecretId => Str Specifies the secret that you want to attach the resource-based policy. You can specify either the ARN or the friendly name of the secret. If you specify an ARN, we generally recommend that you specify a complete ARN. You can specify a partial ARN tooEfor example, if you donEt include the final hyphen and six random characters that Secrets Manager adds at the end of the ARN when you created the secret. A partial ARN match can work as long as it uniquely matches only one secret. However, if your secret has a name that ends in a hyphen followed by six characters (before Secrets Manager adds the hyphen and six characters to the ARN) and you try to use that as a partial ARN, then those characters cause Secrets Manager to assume that youEre specifying a complete ARN. This confusion can cause unexpected results. To avoid this situation, we recommend that you donEt create secret names ending with a hyphen followed by six characters. If you specify an incomplete ARN without the random suffix, and instead provide the 'friendly name', you I not include the random suffix. If you do include the random suffix added by Secrets Manager, you receive either a I or an I error, depending on your permissions. =head1 SEE ALSO This class forms part of L, documenting arguments for method PutResourcePolicy in L =head1 BUGS and CONTRIBUTIONS The source code is located here: L Please report bugs to: L =cut