aws-sdk-lambda 0.4.0__py3-none-any.whl

aws_sdk_lambda/_resources/aws_gir_api_service/function_version_resource.py

@@ -0,0 +1,265 @@
+from typing import TYPE_CHECKING, Optional
+
+import aws_sdk_lambda._auth._signers
+import aws_sdk_lambda._auth._sigv4
+from aws_sdk_lambda._services._pipeline import (
+    AsyncOperationRequest,
+    AsyncOperationResponse,
+    OperationRequest,
+    OperationResponse,
+    aexecute_pipeline,
+    execute_pipeline,
+)
+
+if TYPE_CHECKING:
+    import aws_sdk_lambda.types.description
+    import aws_sdk_lambda.types.function_configuration
+    import aws_sdk_lambda.types.function_name
+    import aws_sdk_lambda.types.function_version_latest_published
+    import aws_sdk_lambda.types.list_versions_by_function_request
+    import aws_sdk_lambda.types.list_versions_by_function_response
+    import aws_sdk_lambda.types.max_list_items
+    import aws_sdk_lambda.types.namespaced_function_name
+    import aws_sdk_lambda.types.publish_version_request
+    import aws_sdk_lambda.types.string
+    from aws_sdk_lambda._services._lambda import LambdaClient, LambdaClientConfig
+    from aws_sdk_lambda._services.async__lambda import (
+        AsyncLambdaClient,
+        AsyncLambdaClientConfig,
+    )
+
+
+class FunctionVersionResource:
+    def __init__(self, service: LambdaClient) -> None:
+        self._service = service
+
+    def create(
+        self,
+        function_name: "aws_sdk_lambda.types.function_name.FunctionName",
+        *,
+        config_overrides: Optional[LambdaClientConfig] = None,
+        code_sha256: Optional["aws_sdk_lambda.types.string.String"] = None,
+        description: Optional["aws_sdk_lambda.types.description.Description"] = None,
+        revision_id: Optional["aws_sdk_lambda.types.string.String"] = None,
+        publish_to: Optional[
+            "aws_sdk_lambda.types.function_version_latest_published.FunctionVersionLatestPublished"
+        ] = None,
+    ) -> "aws_sdk_lambda.types.function_configuration.FunctionConfiguration":
+        """<p>Creates a <a href=\"https://docs.aws.amazon.com/lambda/latest/dg/versioning-aliases.html\">version</a> from the current code and configuration of a function. Use versions to create a snapshot of your function code and configuration that doesn't change.</p> <p>Lambda doesn't publish a version if the function's configuration and code haven't changed since the last version. Use <a>UpdateFunctionCode</a> or <a>UpdateFunctionConfiguration</a> to update the function before publishing a version.</p> <p>Clients can invoke versions directly or with an alias. To create an alias, use <a>CreateAlias</a>.</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>
+            code_sha256: <p>Only publish a version if the hash value matches the value that's specified. Use this option to avoid publishing a version if the function code has changed since you last updated it. You can get the hash for the version that you uploaded from the output of <a>UpdateFunctionCode</a>.</p>
+            description: <p>A description for the version to override the description in the function configuration.</p>
+            revision_id: <p>Only update the function if the revision ID matches the ID that's specified. Use this option to avoid publishing a version if the function configuration has changed since you last updated it.</p>
+            publish_to: <p>Specifies where to publish the function version or configuration.</p>
+
+        Examples:
+            To publish a version of a Lambda function
+            This operation publishes a version of a Lambda function
+
+            >>> client.create(function_name='myFunction', code_sha256='', description='')
+        """
+
+        def _handler(
+            req: "OperationRequest[aws_sdk_lambda.types.publish_version_request.PublishVersionRequest]",
+        ) -> OperationResponse[
+            "aws_sdk_lambda.types.function_configuration.FunctionConfiguration"
+        ]:
+            import aws_sdk_lambda._operations.aws_gir_api_service.publish_version
+
+            output, http_response = (
+                aws_sdk_lambda._operations.aws_gir_api_service.publish_version.publish_version(
+                    req.options, req.input
+                )
+            )
+            return OperationResponse(output=output, response=http_response)
+
+        interceptors_, options_ = self._service.operation_options(config_overrides)
+        input: aws_sdk_lambda.types.publish_version_request.PublishVersionRequest = {}  # type: ignore[typeddict-item]
+        input["function_name"] = function_name
+        if code_sha256 is not None:
+            input["code_sha256"] = code_sha256
+        if description is not None:
+            input["description"] = description
+        if revision_id is not None:
+            input["revision_id"] = revision_id
+        if publish_to is not None:
+            input["publish_to"] = publish_to
+
+        response = execute_pipeline(
+            OperationRequest(input=input, options=options_),
+            handler=_handler,
+            interceptors=list(interceptors_),
+        )
+        return response.output
+
+    def list_versions_by_function(
+        self,
+        function_name: "aws_sdk_lambda.types.namespaced_function_name.NamespacedFunctionName",
+        *,
+        config_overrides: Optional[LambdaClientConfig] = None,
+        marker: Optional["aws_sdk_lambda.types.string.String"] = None,
+        max_items: Optional["aws_sdk_lambda.types.max_list_items.MaxListItems"] = None,
+    ) -> "aws_sdk_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>
+
+        Examples:
+            To list versions of a function
+            The following example returns a list of versions of a function named my-function
+
+            >>> client.list_versions_by_function(function_name='my-function')
+        """
+
+        def _handler(
+            req: "OperationRequest[aws_sdk_lambda.types.list_versions_by_function_request.ListVersionsByFunctionRequest]",
+        ) -> OperationResponse[
+            "aws_sdk_lambda.types.list_versions_by_function_response.ListVersionsByFunctionResponse"
+        ]:
+            import aws_sdk_lambda._operations.aws_gir_api_service.list_versions_by_function
+
+            output, http_response = (
+                aws_sdk_lambda._operations.aws_gir_api_service.list_versions_by_function.list_versions_by_function(
+                    req.options, req.input
+                )
+            )
+            return OperationResponse(output=output, response=http_response)
+
+        interceptors_, options_ = self._service.operation_options(config_overrides)
+        input: aws_sdk_lambda.types.list_versions_by_function_request.ListVersionsByFunctionRequest = {}  # type: ignore[typeddict-item]
+        input["function_name"] = function_name
+        if marker is not None:
+            input["marker"] = marker
+        if max_items is not None:
+            input["max_items"] = max_items
+
+        response = execute_pipeline(
+            OperationRequest(input=input, options=options_),
+            handler=_handler,
+            interceptors=list(interceptors_),
+        )
+        return response.output
+
+
+class AsyncFunctionVersionResource:
+    def __init__(self, service: AsyncLambdaClient) -> None:
+        self._service = service
+
+    async def create(
+        self,
+        function_name: "aws_sdk_lambda.types.function_name.FunctionName",
+        *,
+        config_overrides: Optional[AsyncLambdaClientConfig] = None,
+        code_sha256: Optional["aws_sdk_lambda.types.string.String"] = None,
+        description: Optional["aws_sdk_lambda.types.description.Description"] = None,
+        revision_id: Optional["aws_sdk_lambda.types.string.String"] = None,
+        publish_to: Optional[
+            "aws_sdk_lambda.types.function_version_latest_published.FunctionVersionLatestPublished"
+        ] = None,
+    ) -> "aws_sdk_lambda.types.function_configuration.FunctionConfiguration":
+        """<p>Creates a <a href=\"https://docs.aws.amazon.com/lambda/latest/dg/versioning-aliases.html\">version</a> from the current code and configuration of a function. Use versions to create a snapshot of your function code and configuration that doesn't change.</p> <p>Lambda doesn't publish a version if the function's configuration and code haven't changed since the last version. Use <a>UpdateFunctionCode</a> or <a>UpdateFunctionConfiguration</a> to update the function before publishing a version.</p> <p>Clients can invoke versions directly or with an alias. To create an alias, use <a>CreateAlias</a>.</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>
+            code_sha256: <p>Only publish a version if the hash value matches the value that's specified. Use this option to avoid publishing a version if the function code has changed since you last updated it. You can get the hash for the version that you uploaded from the output of <a>UpdateFunctionCode</a>.</p>
+            description: <p>A description for the version to override the description in the function configuration.</p>
+            revision_id: <p>Only update the function if the revision ID matches the ID that's specified. Use this option to avoid publishing a version if the function configuration has changed since you last updated it.</p>
+            publish_to: <p>Specifies where to publish the function version or configuration.</p>
+
+        Examples:
+            To publish a version of a Lambda function
+            This operation publishes a version of a Lambda function
+
+            >>> await client.create(function_name='myFunction', code_sha256='', description='')
+        """
+
+        async def _handler(
+            req: "AsyncOperationRequest[aws_sdk_lambda.types.publish_version_request.PublishVersionRequest]",
+        ) -> AsyncOperationResponse[
+            "aws_sdk_lambda.types.function_configuration.FunctionConfiguration"
+        ]:
+            import aws_sdk_lambda._operations.aws_gir_api_service.publish_version
+
+            (
+                output,
+                http_response,
+            ) = await aws_sdk_lambda._operations.aws_gir_api_service.publish_version.async_publish_version(
+                req.options, req.input
+            )
+            return AsyncOperationResponse(output=output, response=http_response)
+
+        interceptors_, options_ = self._service.operation_options(config_overrides)
+        input: aws_sdk_lambda.types.publish_version_request.PublishVersionRequest = {}  # type: ignore[typeddict-item]
+        input["function_name"] = function_name
+        if code_sha256 is not None:
+            input["code_sha256"] = code_sha256
+        if description is not None:
+            input["description"] = description
+        if revision_id is not None:
+            input["revision_id"] = revision_id
+        if publish_to is not None:
+            input["publish_to"] = publish_to
+
+        response = await aexecute_pipeline(
+            AsyncOperationRequest(input=input, options=options_),
+            handler=_handler,
+            interceptors=list(interceptors_),
+        )
+        return response.output
+
+    async def list_versions_by_function(
+        self,
+        function_name: "aws_sdk_lambda.types.namespaced_function_name.NamespacedFunctionName",
+        *,
+        config_overrides: Optional[AsyncLambdaClientConfig] = None,
+        marker: Optional["aws_sdk_lambda.types.string.String"] = None,
+        max_items: Optional["aws_sdk_lambda.types.max_list_items.MaxListItems"] = None,
+    ) -> "aws_sdk_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>
+
+        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[aws_sdk_lambda.types.list_versions_by_function_request.ListVersionsByFunctionRequest]",
+        ) -> AsyncOperationResponse[
+            "aws_sdk_lambda.types.list_versions_by_function_response.ListVersionsByFunctionResponse"
+        ]:
+            import aws_sdk_lambda._operations.aws_gir_api_service.list_versions_by_function
+
+            (
+                output,
+                http_response,
+            ) = await aws_sdk_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)
+
+        interceptors_, options_ = self._service.operation_options(config_overrides)
+        input: aws_sdk_lambda.types.list_versions_by_function_request.ListVersionsByFunctionRequest = {}  # type: ignore[typeddict-item]
+        input["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_),
+        )
+        return response.output

aws_sdk_lambda/_resources/aws_gir_api_service/layer_resource.py

@@ -0,0 +1,156 @@
+from typing import TYPE_CHECKING, Optional
+
+import aws_sdk_lambda._auth._signers
+import aws_sdk_lambda._auth._sigv4
+from aws_sdk_lambda._services._pipeline import (
+    AsyncOperationRequest,
+    AsyncOperationResponse,
+    OperationRequest,
+    OperationResponse,
+    aexecute_pipeline,
+    execute_pipeline,
+)
+
+if TYPE_CHECKING:
+    import aws_sdk_lambda.types.architecture
+    import aws_sdk_lambda.types.list_layers_request
+    import aws_sdk_lambda.types.list_layers_response
+    import aws_sdk_lambda.types.max_layer_list_items
+    import aws_sdk_lambda.types.runtime
+    import aws_sdk_lambda.types.string
+    from aws_sdk_lambda._services._lambda import LambdaClient, LambdaClientConfig
+    from aws_sdk_lambda._services.async__lambda import (
+        AsyncLambdaClient,
+        AsyncLambdaClientConfig,
+    )
+
+
+class LayerResource:
+    def __init__(self, service: LambdaClient) -> None:
+        self._service = service
+
+    def list(
+        self,
+        *,
+        config_overrides: Optional[LambdaClientConfig] = None,
+        compatible_runtime: Optional["aws_sdk_lambda.types.runtime.Runtime"] = None,
+        marker: Optional["aws_sdk_lambda.types.string.String"] = None,
+        max_items: Optional[
+            "aws_sdk_lambda.types.max_layer_list_items.MaxLayerListItems"
+        ] = None,
+        compatible_architecture: Optional[
+            "aws_sdk_lambda.types.architecture.Architecture"
+        ] = None,
+    ) -> "aws_sdk_lambda.types.list_layers_response.ListLayersResponse":
+        """<p>Lists <a href=\"https://docs.aws.amazon.com/lambda/latest/dg/invocation-layers.html\">Lambda layers</a> and shows information about the latest version of each. Specify a <a href=\"https://docs.aws.amazon.com/lambda/latest/dg/lambda-runtimes.html\">runtime identifier</a> to list only layers that indicate that they're compatible with that runtime. Specify a compatible architecture to include only layers that are compatible with that <a href=\"https://docs.aws.amazon.com/lambda/latest/dg/foundation-arch.html\">instruction set architecture</a>.</p>
+
+        Args:
+            compatible_runtime: <p>A runtime identifier.</p> <p>The following list includes deprecated runtimes. For more information, see <a href=\"https://docs.aws.amazon.com/lambda/latest/dg/lambda-runtimes.html#runtime-deprecation-levels\">Runtime use after deprecation</a>.</p> <p>For a list of all currently supported runtimes, see <a href=\"https://docs.aws.amazon.com/lambda/latest/dg/lambda-runtimes.html#runtimes-supported\">Supported runtimes</a>.</p>
+            marker: <p>A pagination token returned by a previous call.</p>
+            max_items: <p>The maximum number of layers to return.</p>
+            compatible_architecture: <p>The compatible <a href=\"https://docs.aws.amazon.com/lambda/latest/dg/foundation-arch.html\">instruction set architecture</a>.</p>
+
+        Examples:
+            To list the layers that are compatible with your function's runtime
+            The following example returns information about layers that are compatible with the Python 3.7 runtime.
+
+            >>> client.list(compatible_runtime='python3.7')
+        """
+
+        def _handler(
+            req: "OperationRequest[aws_sdk_lambda.types.list_layers_request.ListLayersRequest]",
+        ) -> OperationResponse[
+            "aws_sdk_lambda.types.list_layers_response.ListLayersResponse"
+        ]:
+            import aws_sdk_lambda._operations.aws_gir_api_service.list_layers
+
+            output, http_response = (
+                aws_sdk_lambda._operations.aws_gir_api_service.list_layers.list_layers(
+                    req.options, req.input
+                )
+            )
+            return OperationResponse(output=output, response=http_response)
+
+        interceptors_, options_ = self._service.operation_options(config_overrides)
+        input: aws_sdk_lambda.types.list_layers_request.ListLayersRequest = {}  # type: ignore[typeddict-item]
+        if compatible_runtime is not None:
+            input["compatible_runtime"] = compatible_runtime
+        if marker is not None:
+            input["marker"] = marker
+        if max_items is not None:
+            input["max_items"] = max_items
+        if compatible_architecture is not None:
+            input["compatible_architecture"] = compatible_architecture
+
+        response = execute_pipeline(
+            OperationRequest(input=input, options=options_),
+            handler=_handler,
+            interceptors=list(interceptors_),
+        )
+        return response.output
+
+
+class AsyncLayerResource:
+    def __init__(self, service: AsyncLambdaClient) -> None:
+        self._service = service
+
+    async def list(
+        self,
+        *,
+        config_overrides: Optional[AsyncLambdaClientConfig] = None,
+        compatible_runtime: Optional["aws_sdk_lambda.types.runtime.Runtime"] = None,
+        marker: Optional["aws_sdk_lambda.types.string.String"] = None,
+        max_items: Optional[
+            "aws_sdk_lambda.types.max_layer_list_items.MaxLayerListItems"
+        ] = None,
+        compatible_architecture: Optional[
+            "aws_sdk_lambda.types.architecture.Architecture"
+        ] = None,
+    ) -> "aws_sdk_lambda.types.list_layers_response.ListLayersResponse":
+        """<p>Lists <a href=\"https://docs.aws.amazon.com/lambda/latest/dg/invocation-layers.html\">Lambda layers</a> and shows information about the latest version of each. Specify a <a href=\"https://docs.aws.amazon.com/lambda/latest/dg/lambda-runtimes.html\">runtime identifier</a> to list only layers that indicate that they're compatible with that runtime. Specify a compatible architecture to include only layers that are compatible with that <a href=\"https://docs.aws.amazon.com/lambda/latest/dg/foundation-arch.html\">instruction set architecture</a>.</p>
+
+        Args:
+            compatible_runtime: <p>A runtime identifier.</p> <p>The following list includes deprecated runtimes. For more information, see <a href=\"https://docs.aws.amazon.com/lambda/latest/dg/lambda-runtimes.html#runtime-deprecation-levels\">Runtime use after deprecation</a>.</p> <p>For a list of all currently supported runtimes, see <a href=\"https://docs.aws.amazon.com/lambda/latest/dg/lambda-runtimes.html#runtimes-supported\">Supported runtimes</a>.</p>
+            marker: <p>A pagination token returned by a previous call.</p>
+            max_items: <p>The maximum number of layers to return.</p>
+            compatible_architecture: <p>The compatible <a href=\"https://docs.aws.amazon.com/lambda/latest/dg/foundation-arch.html\">instruction set architecture</a>.</p>
+
+        Examples:
+            To list the layers that are compatible with your function's runtime
+            The following example returns information about layers that are compatible with the Python 3.7 runtime.
+
+            >>> await client.list(compatible_runtime='python3.7')
+        """
+
+        async def _handler(
+            req: "AsyncOperationRequest[aws_sdk_lambda.types.list_layers_request.ListLayersRequest]",
+        ) -> AsyncOperationResponse[
+            "aws_sdk_lambda.types.list_layers_response.ListLayersResponse"
+        ]:
+            import aws_sdk_lambda._operations.aws_gir_api_service.list_layers
+
+            (
+                output,
+                http_response,
+            ) = await aws_sdk_lambda._operations.aws_gir_api_service.list_layers.async_list_layers(
+                req.options, req.input
+            )
+            return AsyncOperationResponse(output=output, response=http_response)
+
+        interceptors_, options_ = self._service.operation_options(config_overrides)
+        input: aws_sdk_lambda.types.list_layers_request.ListLayersRequest = {}  # type: ignore[typeddict-item]
+        if compatible_runtime is not None:
+            input["compatible_runtime"] = compatible_runtime
+        if marker is not None:
+            input["marker"] = marker
+        if max_items is not None:
+            input["max_items"] = max_items
+        if compatible_architecture is not None:
+            input["compatible_architecture"] = compatible_architecture
+
+        response = await aexecute_pipeline(
+            AsyncOperationRequest(input=input, options=options_),
+            handler=_handler,
+            interceptors=list(interceptors_),
+        )
+        return response.output