Returns a list of versions, with the version-specific configuration of each. Lambda returns up to 50 versions per call.
Parameters:
-
function_name
(NamespacedFunctionName)
–
The name or ARN of the Lambda function.
Name formats
-
Function name - MyFunction.
-
Function ARN - arn:aws:lambda:us-west-2:123456789012:function:MyFunction.
-
Partial ARN - 123456789012:function:MyFunction.
The length constraint applies only to the full ARN. If you specify only the function name, it is limited to 64 characters in length.
-
marker
(Optional[String], default:
None
)
–
Specify the pagination token that's returned by a previous request to retrieve the next page of results.
-
max_items
(Optional[MaxListItems], default:
None
)
–
The maximum number of versions to return. Note that ListVersionsByFunction returns a maximum of 50 items in each response, even if you set the number higher.
Raises:
Examples:
To list versions of a function
The following example returns a list of versions of a function named my-function
>>> await client.list_versions_by_function(function_name='my-function')
Source code in docs_src/capo_lambda/_services/async__lambda.py
| async def list_versions_by_function(
self,
function_name: "capo_lambda.types.namespaced_function_name.NamespacedFunctionName",
*,
config_overrides: Optional[AsyncLambdaClientConfig] = None,
marker: Optional["capo_lambda.types.string.String"] = None,
max_items: Optional["capo_lambda.types.max_list_items.MaxListItems"] = None,
) -> "capo_lambda.types.list_versions_by_function_response.ListVersionsByFunctionResponse":
"""<p>Returns a list of <a href="https://docs.aws.amazon.com/lambda/latest/dg/versioning-aliases.html">versions</a>, with the version-specific configuration of each. Lambda returns up to 50 versions per call.</p>
Args:
function_name: <p>The name or ARN of the Lambda function.</p> <p class="title"> <b>Name formats</b> </p> <ul> <li> <p> <b>Function name</b> - <code>MyFunction</code>.</p> </li> <li> <p> <b>Function ARN</b> - <code>arn:aws:lambda:us-west-2:123456789012:function:MyFunction</code>.</p> </li> <li> <p> <b>Partial ARN</b> - <code>123456789012:function:MyFunction</code>.</p> </li> </ul> <p>The length constraint applies only to the full ARN. If you specify only the function name, it is limited to 64 characters in length.</p>
marker: <p>Specify the pagination token that's returned by a previous request to retrieve the next page of results.</p>
max_items: <p>The maximum number of versions to return. Note that <code>ListVersionsByFunction</code> returns a maximum of 50 items in each response, even if you set the number higher.</p>
Raises:
capo_lambda.errors.invalid_parameter_value_exception.InvalidParameterValueException: <p>One of the parameters in the request is not valid.</p>
capo_lambda.errors.resource_not_found_exception.ResourceNotFoundException: <p>The resource specified in the request does not exist.</p>
capo_lambda.errors.service_exception.ServiceException: <p>The Lambda service encountered an internal error.</p>
capo_lambda.errors.too_many_requests_exception.TooManyRequestsException: <p>The request throughput limit was exceeded. For more information, see <a href="https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html#api-requests">Lambda quotas</a>.</p>
capo_lambda.errors.UnknownServiceError: The service returned an error code this client does not model.
Examples:
To list versions of a function
The following example returns a list of versions of a function named my-function
>>> await client.list_versions_by_function(function_name='my-function')
"""
async def _handler(
req: "AsyncOperationRequest[capo_lambda.types.list_versions_by_function_request.ListVersionsByFunctionRequest]",
) -> AsyncOperationResponse[
"capo_lambda.types.list_versions_by_function_response.ListVersionsByFunctionResponse"
]:
import capo_lambda._operations.aws_gir_api_service.list_versions_by_function
(
output,
http_response,
) = await capo_lambda._operations.aws_gir_api_service.list_versions_by_function.async_list_versions_by_function(
req.options, req.input
)
return AsyncOperationResponse(output=output, response=http_response)
def _redact_output(
output: "capo_lambda.types.list_versions_by_function_response.ListVersionsByFunctionResponse",
) -> dict[str, Any]:
import capo_lambda.types.list_versions_by_function_response
return (
capo_lambda.types.list_versions_by_function_response.redact_sensitive(
output
)
)
interceptors_, options_ = self.operation_options(
config_overrides,
OperationLogging("ListVersionsByFunction", redact_output=_redact_output),
)
input_: capo_lambda.types.list_versions_by_function_request.ListVersionsByFunctionRequest = {
"function_name": function_name
}
if marker is not None:
input_["marker"] = marker
if max_items is not None:
input_["max_items"] = max_items
response = await aexecute_pipeline(
AsyncOperationRequest(input=input_, options=options_),
handler=_handler,
interceptors=list(interceptors_),
)
await response.response.aclose()
return response.output
|