LambdaWeb / Client / get_web_function_revision

get_web_function_revision¶

LambdaWeb.Client.get_web_function_revision(**kwargs)¶

Retrieves details about a web function revision, including its state and configuration.

Request Syntax

response = client.get_web_function_revision(
    functionName='string',
    revisionId='string'
)

Parameters:

functionName (string) –
[REQUIRED]

The name of the web function. You can specify the function name or the function ARN. The length constraint applies only to the full ARN. If you specify only the function name, it is limited to 64 characters in length.
revisionId (string) –
[REQUIRED]

The identifier of the revision to retrieve. You can specify the revision identifier or the revision ARN. The length constraint applies only to the full ARN.

Return type:

dict

Returns:

Response Syntax

{
    'functionArn': 'string',
    'revisionArn': 'string',
    'revisionId': 'string',
    'description': 'string',
    'kmsKeyArn': 'string',
    'buildConfig': {
        'codeConfig': {
            's3Object': {
                'bucket': 'string',
                'key': 'string',
                'versionId': 'string'
            }
        },
        'runtimeConfig': {
            'runtime': 'string'
        }
    },
    'serviceConfig': {
        'executionRoleArn': 'string',
        'timeoutSeconds': 123,
        'maxConcurrencyPerEnvironment': 123,
        'environmentVariables': {
            'string': 'string'
        },
        'telemetryConfig': {
            'loggingConfig': {
                'logGroup': 'string',
                'applicationLogLevel': 'TRACE'|'DEBUG'|'INFO'|'WARN'|'ERROR'|'FATAL',
                'systemLogLevel': 'DEBUG'|'INFO'|'WARN'
            }
        }
    },
    'state': 'Pending'|'Active'|'Failed',
    'stateReason': 'string',
    'errors': [
        {
            'attribute': 'string',
            'errorCode': 'string',
            'errorMessage': 'string'
        },
    ],
    'createdAt': datetime(2015, 1, 1)
}

Response Structure

(dict) –

Contains details about the web function revision.
- functionArn (string) –
  
  The Amazon Resource Name (ARN) of the web function.
- revisionArn (string) –
  
  The Amazon Resource Name (ARN) of the revision.
- revisionId (string) –
  
  The identifier of the revision.
- description (string) –
  
  The description of the revision.
- kmsKeyArn (string) –
  
  The Amazon Resource Name (ARN) of the AWS KMS key used to encrypt the revision’s code and environment variables.
- buildConfig (dict) –
  
  The build configuration for a web function revision, including code location and runtime settings.
  - codeConfig (dict) –
    
    The code configuration specifying where the deployment artifact is stored.
    - s3Object (dict) –
      
      The Amazon S3 location of the deployment artifact.
      - bucket (string) –
        
        The name of the Amazon S3 bucket. Must be between 3 and 63 characters.
      - key (string) –
        
        The Amazon S3 object key. Must be between 1 and 1024 characters.
      - versionId (string) –
        
        The version ID of the Amazon S3 object.
  - runtimeConfig (dict) –
    
    The runtime configuration for the revision.
    - runtime (string) –
      
      The runtime identifier for the web function (for example, a Node.js runtime identifier).
- serviceConfig (dict) –
  
  The service configuration for a web function revision, including execution role, timeout, concurrency, and telemetry settings.
  - executionRoleArn (string) –
    
    The ARN of the IAM role that the web function assumes when it runs. This role provides permissions to access AWS services and resources.
  - timeoutSeconds (integer) –
    
    The amount of time (in seconds) that Lambda allows the web function to run before stopping it. Minimum value of 3, maximum value of 900. If you don’t specify a value, the default is 30, and this default is returned in the response.
  - maxConcurrencyPerEnvironment (integer) –
    
    The maximum number of concurrent requests handled per execution environment. Minimum value of 1, maximum value of 128. If you don’t specify a value, the default is 64, and this default is returned in the response.
  - environmentVariables (dict) –
    
    A map of environment variable key-value pairs available to the web function at runtime. Environment variable values are sensitive.
    - (string) –
      - (string) –
  - telemetryConfig (dict) –
    
    The telemetry configuration for the web function, including logging settings.
    - loggingConfig (dict) –
      
      The logging configuration for the web function.
      - logGroup (string) –
        
        The name of the Amazon CloudWatch Logs log group the web function sends logs to. If you don’t specify a value, the default is /aws/lambda/web/{functionName}, and this default is returned in the response.
      - applicationLogLevel (string) –
        
        The log level for application logs emitted by the web function. If you don’t specify a value, the default is INFO, and this default is returned in the response.
      - systemLogLevel (string) –
        
        The log level for system logs emitted by the Lambda runtime. If you don’t specify a value, the default is INFO, and this default is returned in the response.
- state (string) –
  
  The current state of the revision.
- stateReason (string) –
  
  The reason for the current state of the revision.
- errors (list) –
  
  A list of errors encountered during revision creation. This field is absent when the revision has no errors.
  - (dict) –
    
    A single error encountered while creating or reading a web function revision. The error describes the affected attribute, an error code, and a human-readable message. This structure is present only when the revision has errors.
    - attribute (string) –
      
      The name of the revision attribute that the error applies to. Must be between 1 and 64 characters.
    - errorCode (string) –
      
      A short, machine-readable code that identifies the error. Must be between 1 and 64 characters.
    - errorMessage (string) –
      
      A human-readable message describing the error. Must be between 1 and 2048 characters.
- createdAt (datetime) –
  
  The date and time the revision was created.

Exceptions

LambdaWeb.Client.exceptions.AccessDeniedException
LambdaWeb.Client.exceptions.InternalServerException
LambdaWeb.Client.exceptions.ValidationException
LambdaWeb.Client.exceptions.ResourceNotFoundException
LambdaWeb.Client.exceptions.ThrottlingException