The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

NAME

Paws::Lambda::AddPermission - Arguments for method AddPermission on Paws::Lambda

DESCRIPTION

This class represents the parameters used for calling the method AddPermission on the AWS Lambda service. Use the attributes of this class as arguments to method AddPermission.

You shouldn't make instances of this class. Each attribute should be used as a named argument in the call to AddPermission.

SYNOPSIS

    my $lambda = Paws->service('Lambda');
    # To grant Amazon S3 permission to invoke a function
    # The following example adds permission for Amazon S3 to invoke a Lambda
    # function named my-function for notifications from a bucket named
    # my-bucket-1xpuxmplzrlbh in account 123456789012.
    my $AddPermissionResponse = $lambda->AddPermission(
      'Action'        => 'lambda:InvokeFunction',
      'FunctionName'  => 'my-function',
      'Principal'     => 's3.amazonaws.com',
      'SourceAccount' => 123456789012,
      'SourceArn'     => 'arn:aws:s3:::my-bucket-1xpuxmplzrlbh/*',
      'StatementId'   => 's3'
    );

    # Results:
    my $Statement = $AddPermissionResponse->Statement;

# Returns a Paws::Lambda::AddPermissionResponse object. # To grant another account permission to invoke a function # The following example adds permission for account 223456789012 invoke a Lambda # function named my-function. my $AddPermissionResponse = $lambda->AddPermission( 'Action' => 'lambda:InvokeFunction', 'FunctionName' => 'my-function', 'Principal' => 223456789012, 'StatementId' => 'xaccount' );

    # Results:
    my $Statement = $AddPermissionResponse->Statement;

    # Returns a L<Paws::Lambda::AddPermissionResponse> 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 https://docs.aws.amazon.com/goto/WebAPI/lambda/AddPermission

ATTRIBUTES

REQUIRED Action => Str

The action that the principal can use on the function. For example, lambda:InvokeFunction or lambda:GetFunction.

EventSourceToken => Str

For Alexa Smart Home functions, a token that must be supplied by the invoker.

REQUIRED FunctionName => Str

The name of the Lambda function, version, or alias.

Name formats

  • Function name - my-function (name-only), my-function:v1 (with alias).

  • Function ARN - arn:aws:lambda:us-west-2:123456789012:function:my-function.

  • Partial ARN - 123456789012:function:my-function.

You can append a version number or alias to any of the formats. The length constraint applies only to the full ARN. If you specify only the function name, it is limited to 64 characters in length.

REQUIRED Principal => Str

The Amazon Web Services service or account that invokes the function. If you specify a service, use SourceArn or SourceAccount to limit who can invoke the function through that service.

Qualifier => Str

Specify a version or alias to add permissions to a published version of the function.

RevisionId => Str

Only update the policy if the revision ID matches the ID that's specified. Use this option to avoid modifying a policy that has changed since you last read it.

SourceAccount => Str

For Amazon S3, the ID of the account that owns the resource. Use this together with SourceArn to ensure that the resource is owned by the specified account. It is possible for an Amazon S3 bucket to be deleted by its owner and recreated by another account.

SourceArn => Str

For Amazon Web Services services, the ARN of the Amazon Web Services resource that invokes the function. For example, an Amazon S3 bucket or Amazon SNS topic.

REQUIRED StatementId => Str

A statement identifier that differentiates the statement from others in the same policy.

SEE ALSO

This class forms part of Paws, documenting arguments for method AddPermission in Paws::Lambda

BUGS and CONTRIBUTIONS

The source code is located here: https://github.com/pplu/aws-sdk-perl

Please report bugs to: https://github.com/pplu/aws-sdk-perl/issues