Beispiele für die Verwendung der AWS CLI mit Lambda - AWS Command Line Interface
Aktionen

Beispiele für die Verwendung der AWS CLI mit Lambda

Das folgende Codebeispiel zeigt, wie Sie Aktionen durchführen und gängige Szenarien implementieren, indem Sie die AWS Command Line Interface mit Lambda verwenden.

Aktionen sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen.

Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anleitungen zum Einrichten und Ausführen des Codes im Kontext finden.

Themen

Aktionen

Das folgende Codebeispiel zeigt, wie add-layer-version-permission verwendet wird.

AWS CLI

So fügen Sie einer Layer-Version Berechtigungen hinzu

Im folgenden Beispiel für add-layer-version-permission wird dem angegebenen Konto die Berechtigung erteilt, Version 1 des Layers my-layer zu verwenden.

aws lambda add-layer-version-permission \
    --layer-name my-layer \
    --statement-id xaccount \
    --action lambda:GetLayerVersion  \
    --principal 123456789012 \
    --version-number 1

Ausgabe:

{
    "RevisionId": "35d87451-f796-4a3f-a618-95a3671b0a0c",
    "Statement":
    {
        "Sid":"xaccount",
        "Effect":"Allow",
        "Principal":{
            "AWS":"arn:aws:iam::210987654321:root"
        },
        "Action":"lambda:GetLayerVersion",
        "Resource":"arn:aws:lambda:us-east-2:123456789012:layer:my-layer:1"
    }
}

Weitere Informationen finden Sie unter AWS-Lambda-Layer im AWS-Lambda-Entwicklerhandbuch.

Das folgende Codebeispiel zeigt, wie add-permission verwendet wird.

AWS CLI

So fügen Sie einer vorhandenen Lambda-Funktion Berechtigungen hinzu

Im folgenden Beispiel für add-permission wird die Berechtigung für den Amazon-SNS-Service zum Aufrufen einer Funktion namens my-function erteilt.

aws lambda add-permission \
    --function-name my-function \
    --action lambda:InvokeFunction \
    --statement-id sns \
    --principal sns.amazonaws.com

Ausgabe:

{
    "Statement":
    {
        "Sid":"sns",
        "Effect":"Allow",
        "Principal":{
            "Service":"sns.amazonaws.com"
        },
        "Action":"lambda:InvokeFunction",
        "Resource":"arn:aws:lambda:us-east-2:123456789012:function:my-function"
    }
}

Weitere Informationen finden Sie unter Verwendung ressourcenbasierter Richtlinien für AWS Lambda im AWS-Lambda-Entwicklerhandbuch.

  • API-Details finden Sie unter AddPermission in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie create-alias verwendet wird.

AWS CLI

So erstellen Sie einen Alias für eine Lambda-Funktion

Im folgenden Beispiel für create-alias wird ein Alias namens LIVE erstellt, der auf Version 1 der my-function-Lambda-Funktion verweist.

aws lambda create-alias \
    --function-name my-function \
    --description "alias for live version of function" \
    --function-version 1 \
    --name LIVE

Ausgabe:

{
    "FunctionVersion": "1",
    "Name": "LIVE",
    "AliasArn": "arn:aws:lambda:us-west-2:123456789012:function:my-function:LIVE",
    "RevisionId": "873282ed-4cd3-4dc8-a069-d0c647e470c6",
    "Description": "alias for live version of function"
}

Weitere Informationen finden Sie unter Konfigurieren von AWS-Lambda-Funktionsaliasen im AWS-Lambda-Entwicklerhandbuch.

  • API-Details finden Sie unter CreateAlias in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie create-event-source-mapping verwendet wird.

AWS CLI

So erstellen Sie eine Zuordnung zwischen einer Ereignisquelle und einer AWS-Lambda-Funktion

Im folgenden Beispiel für create-event-source-mapping wird eine Zuordnung zwischen einer SQS-Warteschlange und der Lambda-Funktion my-function erstellt.

aws lambda create-event-source-mapping \
    --function-name my-function \
    --batch-size 5 \
    --event-source-arn arn:aws:sqs:us-west-2:123456789012:mySQSqueue

Ausgabe:

{
    "UUID": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE",
    "StateTransitionReason": "USER_INITIATED",
    "LastModified": 1569284520.333,
    "BatchSize": 5,
    "State": "Creating",
    "FunctionArn": "arn:aws:lambda:us-west-2:123456789012:function:my-function",
    "EventSourceArn": "arn:aws:sqs:us-west-2:123456789012:mySQSqueue"
}

Weitere Informationen finden Sie unter AWS-Lambda-Zuordnung von Ereignisquellen im AWS-Lambda-Entwicklerhandbuch.

Das folgende Codebeispiel zeigt, wie create-function verwendet wird.

AWS CLI

Eine Lambda-Funktion erstellen

Im folgenden Beispiel für create-function wird eine Lambda-Funktion mit dem Namen my-function erstellt.

aws lambda create-function \
    --function-name my-function \
    --runtime nodejs18.x \
    --zip-file fileb://my-function.zip \
    --handler my-function.handler \
    --role arn:aws:iam::123456789012:role/service-role/MyTestFunction-role-tges6bf4

Inhalt von my-function.zip:

This file is a deployment package that contains your function code and any dependencies.

Ausgabe:

{
    "TracingConfig": {
        "Mode": "PassThrough"
    },
    "CodeSha256": "PFn4S+er27qk+UuZSTKEQfNKG/XNn7QJs90mJgq6oH8=",
    "FunctionName": "my-function",
    "CodeSize": 308,
    "RevisionId": "873282ed-4cd3-4dc8-a069-d0c647e470c6",
    "MemorySize": 128,
    "FunctionArn": "arn:aws:lambda:us-west-2:123456789012:function:my-function",
    "Version": "$LATEST",
    "Role": "arn:aws:iam::123456789012:role/service-role/MyTestFunction-role-zgur6bf4",
    "Timeout": 3,
    "LastModified": "2023-10-14T22:26:11.234+0000",
    "Handler": "my-function.handler",
    "Runtime": "nodejs18.x",
    "Description": ""
}

Weitere Informationen finden Sie unter Konfigurieren von AWS-Lambda-Funktionen im AWS-Lambda-Entwicklerhandbuch.

  • API-Details finden Sie unter CreateFunction in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie delete-alias verwendet wird.

AWS CLI

So löschen Sie einen Alias einer Lambda-Funktion

Im folgenden delete-alias-Beispiel wird der Alias mit dem Namen LIVE aus der my-function-Lambda-Funktion gelöscht.

aws lambda delete-alias \
    --function-name my-function \
    --name LIVE

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Konfigurieren von AWS-Lambda-Funktionsaliasen im AWS-Lambda-Entwicklerhandbuch.

  • API-Details finden Sie unter DeleteAlias in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie delete-event-source-mapping verwendet wird.

AWS CLI

So löschen Sie die Zuordnung zwischen einer Ereignisquelle und einer AWS-Lambda-Funktion

Im folgenden Beispiel für delete-event-source-mapping wird die Zuordnung zwischen einer SQS-Warteschlange und der Lambda-Funktion my-function gelöscht.

aws lambda delete-event-source-mapping \
    --uuid  a1b2c3d4-5678-90ab-cdef-11111EXAMPLE

Ausgabe:

{
    "UUID": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE",
    "StateTransitionReason": "USER_INITIATED",
    "LastModified": 1569285870.271,
    "BatchSize": 5,
    "State": "Deleting",
    "FunctionArn": "arn:aws:lambda:us-west-2:123456789012:function:my-function",
    "EventSourceArn": "arn:aws:sqs:us-west-2:123456789012:mySQSqueue"
}

Weitere Informationen finden Sie unter AWS-Lambda-Zuordnung von Ereignisquellen im AWS-Lambda-Entwicklerhandbuch.

Das folgende Codebeispiel zeigt, wie delete-function-concurrency verwendet wird.

AWS CLI

So entfernen Sie das Limit für die reservierte gleichzeitige Ausführung einer Funktion

Im folgenden delete-function-concurrency-Beispiel wird das reservierte Limit für gleichzeitige Ausführung aus der my-function-Funktion gelöscht.

aws lambda delete-function-concurrency \
    --function-name  my-function

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Gleichzeitigkeit für eine Lambda-Funktion reservieren im AWS-Lambda-Entwicklerhandbuch.

Das folgende Codebeispiel zeigt, wie delete-function-event-invoke-config verwendet wird.

AWS CLI

So löschen Sie eine Konfiguration für asynchronen Aufruf

Im folgenden Beispiel für delete-function-event-invoke-config wird die Konfiguration für asynchronen Aufruf für den GREEN-Alias der angegebenen Funktion gelöscht.

aws lambda delete-function-event-invoke-config --function-name my-function:GREEN

Das folgende Codebeispiel zeigt, wie delete-function verwendet wird.

AWS CLI

Beispiel 1: So löschen Sie eine Lambda-Funktion anhand des Funktionsnamens

Im folgenden Beispiel für delete-function wird die Lambda-Funktion my-function durch Angabe des Funktionsnamens gelöscht.

aws lambda delete-function \
    --function-name my-function

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Beispiel 2: Eine Lambda-Funktion anhand des Funktions-ARN löschen

Im folgenden Beispiel für delete-function wird die Lambda-Funktion my-function durch Angabe des ARN der Funktion gelöscht.

aws lambda delete-function \
    --function-name arn:aws:lambda:us-west-2:123456789012:function:my-function

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Beispiel 3: Eine Lambda-Funktion anhand eines teilweisen Funktions-ARN löschen

Im folgenden Beispiel für delete-function wird die Lambda-Funktion my-function durch Angabe des teilweisen ARN der Funktion gelöscht.

aws lambda delete-function \
    --function-name 123456789012:function:my-function

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Konfigurieren von AWS-Lambda-Funktionen im AWS-Lambda-Entwicklerhandbuch.

  • API-Details finden Sie unter DeleteFunction in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie delete-layer-version verwendet wird.

AWS CLI

So löschen Sie eine Version eines Lambda-Layers

Im folgenden Beispiel für delete-layer-version wird Version 2 des Layers namens my-layer gelöscht.

aws lambda delete-layer-version \
    --layer-name my-layer \
    --version-number 2

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter AWS-Lambda-Layer im AWS-Lambda-Entwicklerhandbuch.

Das folgende Codebeispiel zeigt, wie delete-provisioned-concurrency-config verwendet wird.

AWS CLI

So löschen Sie eine bereitgestellte Gleichzeitigkeitskonfiguration

Das folgende delete-provisioned-concurrency-config-Beispiel löscht die bereitgestellte Gleichzeitigkeitskonfiguration für den GREEN-Alias der angegebenen Funktion.

aws lambda delete-provisioned-concurrency-config \
    --function-name my-function \
    --qualifier GREEN

Das folgende Codebeispiel zeigt, wie get-account-settings verwendet wird.

AWS CLI

So rufen Sie Details zu Ihrem Konto in einer AWS-Region ab

Im folgenden get-account-settings-Beispiel werden die Lambda-Grenzwerte und Nutzungsinformationen für Ihr Konto angezeigt.

aws lambda get-account-settings

Ausgabe:

{
    "AccountLimit": {
       "CodeSizeUnzipped": 262144000,
       "UnreservedConcurrentExecutions": 1000,
       "ConcurrentExecutions": 1000,
       "CodeSizeZipped": 52428800,
       "TotalCodeSize": 80530636800
    },
    "AccountUsage": {
       "FunctionCount": 4,
       "TotalCodeSize": 9426
    }
}

Weitere Informationen finden Sie unter AWS Lambda Limits im AWS-Lambda-Entwicklerhandbuch.

Das folgende Codebeispiel zeigt, wie get-alias verwendet wird.

AWS CLI

So rufen Sie Details über einen Funktionsalias ab

Das folgende get-alias-Beispiel zeigt Details für den Alias namens LIVE für die my-function-Lambda-Funktion an.

aws lambda get-alias \
    --function-name my-function \
    --name LIVE

Ausgabe:

{
    "FunctionVersion": "3",
    "Name": "LIVE",
    "AliasArn": "arn:aws:lambda:us-west-2:123456789012:function:my-function:LIVE",
    "RevisionId": "594f41fb-b85f-4c20-95c7-6ca5f2a92c93",
    "Description": "alias for live version of function"
}

Weitere Informationen finden Sie unter Konfigurieren von AWS-Lambda-Funktionsaliasen im AWS-Lambda-Entwicklerhandbuch.

  • API-Details finden Sie unter GetAlias in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie get-event-source-mapping verwendet wird.

AWS CLI

So rufen Sie Details zu einer Zuordnung von Ereignisquellen ab

Das folgende Beispiel für get-event-source-mapping zeigt die Details für die Zuordnung zwischen einer SQS-Warteschlange und der Lambda-Funktion my-function an.

aws lambda get-event-source-mapping \
    --uuid "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE"

Ausgabe:

{
    "UUID": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE",
    "StateTransitionReason": "USER_INITIATED",
    "LastModified": 1569284520.333,
    "BatchSize": 5,
    "State": "Enabled",
    "FunctionArn": "arn:aws:lambda:us-west-2:123456789012:function:my-function",
    "EventSourceArn": "arn:aws:sqs:us-west-2:123456789012:mySQSqueue"
}

Weitere Informationen finden Sie unter AWS-Lambda-Zuordnung von Ereignisquellen im AWS-Lambda-Entwicklerhandbuch.

Das folgende Codebeispiel zeigt, wie get-function-concurrency verwendet wird.

AWS CLI

So zeigen Sie die reservierte Gleichzeitigkeitseinstellung für eine Funktion an

Das folgende get-function-concurrency-Beispiel ruft die reservierte Gleichzeitigkeitseinstellung für die angegebene Funktion ab.

aws lambda get-function-concurrency \
    --function-name my-function

Ausgabe:

{
    "ReservedConcurrentExecutions": 250
}

Das folgende Codebeispiel zeigt, wie get-function-configuration verwendet wird.

AWS CLI

So rufen Sie die versionsspezifischen Einstellungen einer Lambda-Funktion ab

Das folgende get-function-configuration-Beispiel zeigt die Einstellungen für Version 2 der my-function-Funktion.

aws lambda get-function-configuration \
    --function-name  my-function:2

Ausgabe:

{
    "FunctionName": "my-function",
    "LastModified": "2019-09-26T20:28:40.438+0000",
    "RevisionId": "e52502d4-9320-4688-9cd6-152a6ab7490d",
    "MemorySize": 256,
    "Version": "2",
    "Role": "arn:aws:iam::123456789012:role/service-role/my-function-role-uy3l9qyq",
    "Timeout": 3,
    "Runtime": "nodejs10.x",
    "TracingConfig": {
        "Mode": "PassThrough"
    },
    "CodeSha256": "5tT2qgzYUHaqwR716pZ2dpkn/0J1FrzJmlKidWoaCgk=",
    "Description": "",
    "VpcConfig": {
        "SubnetIds": [],
        "VpcId": "",
        "SecurityGroupIds": []
    },
    "CodeSize": 304,
    "FunctionArn": "arn:aws:lambda:us-west-2:123456789012:function:my-function:2",
    "Handler": "index.handler"
}

Weitere Informationen finden Sie unter Konfigurieren von AWS-Lambda-Funktionen im AWS-Lambda-Entwicklerhandbuch.

Das folgende Codebeispiel zeigt, wie get-function-event-invoke-config verwendet wird.

AWS CLI

So zeigen Sie eine Konfiguration für asynchronen Aufruf an

Im folgenden Beispiel für get-function-event-invoke-config wird die Konfiguration für asynchronen Aufruf für den Alias BLUE der angegebenen Funktion abgerufen.

aws lambda get-function-event-invoke-config \
    --function-name my-function:BLUE

Ausgabe:

{
    "LastModified": 1577824396.653,
    "FunctionArn": "arn:aws:lambda:us-east-2:123456789012:function:my-function:BLUE",
    "MaximumRetryAttempts": 0,
    "MaximumEventAgeInSeconds": 3600,
    "DestinationConfig": {
        "OnSuccess": {},
        "OnFailure": {
            "Destination": "arn:aws:sqs:us-east-2:123456789012:failed-invocations"
        }
    }
}

Das folgende Codebeispiel zeigt, wie get-function verwendet wird.

AWS CLI

Informationen zu einer Funktion abrufen

Das folgende Beispiel für get-function zeigt Informationen zur Funktion my-function an.

aws lambda get-function \
    --function-name  my-function

Ausgabe:

{
    "Concurrency": {
        "ReservedConcurrentExecutions": 100
    },
    "Code": {
        "RepositoryType": "S3",
        "Location": "https://awslambda-us-west-2-tasks.s3.us-west-2.amazonaws.com/snapshots/123456789012/my-function..."
    },
    "Configuration": {
        "TracingConfig": {
            "Mode": "PassThrough"
        },
        "Version": "$LATEST",
        "CodeSha256": "5tT2qgzYUHoqwR616pZ2dpkn/0J1FrzJmlKidWaaCgk=",
        "FunctionName": "my-function",
        "VpcConfig": {
            "SubnetIds": [],
            "VpcId": "",
            "SecurityGroupIds": []
        },
        "MemorySize": 128,
        "RevisionId": "28f0fb31-5c5c-43d3-8955-03e76c5c1075",
        "CodeSize": 304,
        "FunctionArn": "arn:aws:lambda:us-west-2:123456789012:function:my-function",
        "Handler": "index.handler",
        "Role": "arn:aws:iam::123456789012:role/service-role/helloWorldPython-role-uy3l9qyq",
        "Timeout": 3,
        "LastModified": "2019-09-24T18:20:35.054+0000",
        "Runtime": "nodejs10.x",
        "Description": ""
    }
}

Weitere Informationen finden Sie unter Konfigurieren von AWS-Lambda-Funktionen im AWS-Lambda-Entwicklerhandbuch.

  • API-Details finden Sie unter GetFunction in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie get-layer-version-by-arn verwendet wird.

AWS CLI

So rufen Sie Informationen zu einer Lambda-Layer-Version ab

Im folgenden Beispiel für get-layer-version-by-arn werden Informationen zur Layer-Version mit dem angegebenen Amazon-Ressourcennamen (ARN) angezeigt.

aws lambda get-layer-version-by-arn \
    --arn "arn:aws:lambda:us-west-2:123456789012:layer:AWSLambda-Python311-SciPy1x:2"

Ausgabe:

{
    "LayerVersionArn": "arn:aws:lambda:us-west-2:123456789012:layer:AWSLambda-Python311-SciPy1x:2",
    "Description": "AWS Lambda SciPy layer for Python 3.11 (scipy-1.1.0, numpy-1.15.4) https://github.com/scipy/scipy/releases/tag/v1.1.0 https://github.com/numpy/numpy/releases/tag/v1.15.4",
    "CreatedDate": "2023-10-12T10:09:38.398+0000",
    "LayerArn": "arn:aws:lambda:us-west-2:123456789012:layer:AWSLambda-Python311-SciPy1x",
    "Content": {
        "CodeSize": 41784542,
        "CodeSha256": "GGmv8ocUw4cly0T8HL0Vx/f5V4RmSCGNjDIslY4VskM=",
        "Location": "https://awslambda-us-west-2-layers.s3.us-west-2.amazonaws.com/snapshots/123456789012/..."
    },
    "Version": 2,
    "CompatibleRuntimes": [
        "python3.11"
    ],
    "LicenseInfo": "SciPy: https://github.com/scipy/scipy/blob/main/LICENSE.txt, NumPy: https://github.com/numpy/numpy/blob/main/LICENSE.txt"
}

Weitere Informationen finden Sie unter AWS-Lambda-Layer im AWS-Lambda-Entwicklerhandbuch.

Das folgende Codebeispiel zeigt, wie get-layer-version-policy verwendet wird.

AWS CLI

So rufen Sie die Berechtigungsrichtlinie für eine Lambda-Layer-Version ab

Im folgenden Beispiel für get-layer-version-policy werden Richtlinieninformationen zu Version 1 für den Layer namens my-layer angezeigt.

aws lambda get-layer-version-policy \
    --layer-name my-layer \
    --version-number 1

Ausgabe:

{
    "Policy": {
        "Version":"2012-10-17",		 	 	 
        "Id":"default",
        "Statement":
        [
            {
                "Sid":"xaccount",
                "Effect":"Allow",
                "Principal": {"AWS":"arn:aws:iam::123456789012:root"},
                "Action":"lambda:GetLayerVersion",
                "Resource":"arn:aws:lambda:us-west-2:123456789012:layer:my-layer:1"
            }
        ]
    },
    "RevisionId": "c68f21d2-cbf0-4026-90f6-1375ee465cd0"
}

Weitere Informationen finden Sie unter AWS-Lambda-Layer im AWS-Lambda-Entwicklerhandbuch.

Das folgende Codebeispiel zeigt, wie get-layer-version verwendet wird.

AWS CLI

So rufen Sie Informationen zu einer Lambda-Layer-Version ab

Im folgenden Beispiel für get-layer-version werden Informationen zu Version 1 des Layers namens my-layer angezeigt.

aws lambda get-layer-version \
    --layer-name my-layer \
    --version-number 1

Ausgabe:

{
    "Content": {
        "Location": "https://awslambda-us-east-2-layers.s3.us-east-2.amazonaws.com/snapshots/123456789012/my-layer-4aaa2fbb-ff77-4b0a-ad92-5b78a716a96a?versionId=27iWyA73cCAYqyH...",
        "CodeSha256": "tv9jJO+rPbXUUXuRKi7CwHzKtLDkDRJLB3cC3Z/ouXo=",
        "CodeSize": 169
    },
    "LayerArn": "arn:aws:lambda:us-east-2:123456789012:layer:my-layer",
    "LayerVersionArn": "arn:aws:lambda:us-east-2:123456789012:layer:my-layer:1",
    "Description": "My Python layer",
    "CreatedDate": "2018-11-14T23:03:52.894+0000",
    "Version": 1,
    "LicenseInfo": "MIT",
    "CompatibleRuntimes": [
        "python3.10",
        "python3.11"
    ]
}

Weitere Informationen finden Sie unter AWS-Lambda-Layer im AWS-Lambda-Entwicklerhandbuch.

  • API-Details finden Sie unter GetLayerVersion in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie get-policy verwendet wird.

AWS CLI

So rufen Sie die ressourcenbasierte IAM-Richtlinie für eine Funktion, eine Version oder einen Alias ab

Das folgende get-policy-Beispiel zeigt Richtlinieninformationen über die my-function-Lambda-Funktion an.

aws lambda get-policy \
    --function-name my-function

Ausgabe:

{
    "Policy": {
        "Version":"2012-10-17",		 	 	 
        "Id":"default",
        "Statement":
        [
            {
                "Sid":"iot-events",
                "Effect":"Allow",
                "Principal": {"Service":"iotevents.amazonaws.com"},
                "Action":"lambda:InvokeFunction",
                "Resource":"arn:aws:lambda:us-west-2:123456789012:function:my-function"
            }
        ]
    },
    "RevisionId": "93017fc9-59cb-41dc-901b-4845ce4bf668"
}

Weitere Informationen finden Sie unter Verwendung ressourcenbasierter Richtlinien für AWS-Lambda im AWS-Lambda-Entwicklerhandbuch.

  • API-Details finden Sie unter GetPolicy in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie get-provisioned-concurrency-config verwendet wird.

AWS CLI

So zeigen Sie eine bereitgestellte Gleichzeitigkeitskonfiguration an

Im folgenden get-provisioned-concurrency-config-Beispiel werden Details für die bereitgestellte Gleichzeitigkeitskonfiguration für den BLUE-Alias der angegebenen Funktion angezeigt.

aws lambda get-provisioned-concurrency-config \
    --function-name my-function \
    --qualifier BLUE

Ausgabe:

{
    "RequestedProvisionedConcurrentExecutions": 100,
    "AvailableProvisionedConcurrentExecutions": 100,
    "AllocatedProvisionedConcurrentExecutions": 100,
    "Status": "READY",
    "LastModified": "2019-12-31T20:28:49+0000"
}

Das folgende Codebeispiel zeigt, wie invoke verwendet wird.

AWS CLI

Beispiel 1: Eine Lambda-Funktion synchron aufrufen

Im folgenden Beispiel für invoke wird die Funktion my-function synchron aufgerufen. Die Option cli-binary-format ist erforderlich, wenn Sie die AWS-CLI-Version 2 verwenden. Weitere Informationen finden Sie unter Von der AWS CLI unterstützte globale Befehlszeilenoptionen im AWS-CLI-Benutzerhandbuch.

aws lambda invoke \
    --function-name my-function \
    --cli-binary-format raw-in-base64-out \
    --payload '{ "name": "Bob" }' \
    response.json

Ausgabe:

{
    "ExecutedVersion": "$LATEST",
    "StatusCode": 200
}

Weitere Informationen finden Sie unter Synchrones Aufrufen einer Lambda-Funktion im AWS-Lambda-Entwicklerhandbuch.

Beispiel 2: Eine Lambda-Funktion asynchron aufrufen

Im folgenden Beispiel für invoke wird die Funktion my-function asynchron aufgerufen. Die Option cli-binary-format ist erforderlich, wenn Sie die AWS CLI Version 2 verwenden. Weitere Informationen finden Sie unter Von der AWS CLI unterstützte globale Befehlszeilenoptionen im AWS-CLI-Benutzerhandbuch.

aws lambda invoke \
    --function-name my-function \
    --invocation-type Event \
    --cli-binary-format raw-in-base64-out \
    --payload '{ "name": "Bob" }' \
    response.json

Ausgabe:

{
    "StatusCode": 202
}

Weitere Informationen finden Sie unter Asynchrones Aufrufen einer Lambda-Funktion im AWS-Lambda-Entwicklerhandbuch.

  • API-Details finden Sie unter Invoke in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie list-aliases verwendet wird.

AWS CLI

So rufen Sie die Liste der Aliasse für eine Lambda-Funktion ab

Im folgenden Beispiel für list-aliases wird eine Liste der Aliasse für die Lambda-Funktion my-function angezeigt.

aws lambda list-aliases \
    --function-name my-function

Ausgabe:

{
    "Aliases": [
        {
            "AliasArn": "arn:aws:lambda:us-west-2:123456789012:function:my-function:BETA",
            "RevisionId": "a410117f-ab16-494e-8035-7e204bb7933b",
            "FunctionVersion": "2",
            "Name": "BETA",
            "Description": "alias for beta version of function"
        },
        {
            "AliasArn": "arn:aws:lambda:us-west-2:123456789012:function:my-function:LIVE",
            "RevisionId": "21d40116-f8b1-40ba-9360-3ea284da1bb5",
            "FunctionVersion": "1",
            "Name": "LIVE",
            "Description": "alias for live version of function"
        }
    ]
}

Weitere Informationen finden Sie unter Konfigurieren von AWS-Lambda-Funktionsaliassen im AWS-Lambda-Entwicklerhandbuch.

  • API-Details finden Sie unter ListAliases in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie list-event-source-mappings verwendet wird.

AWS CLI

So listen Sie die Zuordnungen von Ereignisquellen für eine Funktion auf

Im folgenden Beispiel für list-event-source-mappings wird eine Liste der Zuordnungen von Ereignisquellen für die Lambda-Funktion my-function angezeigt.

aws lambda list-event-source-mappings \
    --function-name my-function

Ausgabe:

{
    "EventSourceMappings": [
        {
            "UUID": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE",
            "StateTransitionReason": "USER_INITIATED",
            "LastModified": 1569284520.333,
            "BatchSize": 5,
            "State": "Enabled",
            "FunctionArn": "arn:aws:lambda:us-west-2:123456789012:function:my-function",
            "EventSourceArn": "arn:aws:sqs:us-west-2:123456789012:mySQSqueue"
        }
    ]
}

Weitere Informationen finden Sie unter AWS-Lambda-Zuordnung von Ereignisquellen im AWS-Lambda-Entwicklerhandbuch.

Das folgende Codebeispiel zeigt, wie list-function-event-invoke-configs verwendet wird.

AWS CLI

So zeigen Sie eine Liste der Konfigurationen für asynchronen Aufruf an

Das folgende Beispiel für list-function-event-invoke-configs listet die Konfigurationen für asynchronen Aufruf für die angegebene Funktion auf.

aws lambda list-function-event-invoke-configs \
    --function-name my-function

Ausgabe:

{
    "FunctionEventInvokeConfigs": [
        {
            "LastModified": 1577824406.719,
            "FunctionArn": "arn:aws:lambda:us-east-2:123456789012:function:my-function:GREEN",
            "MaximumRetryAttempts": 2,
            "MaximumEventAgeInSeconds": 1800
        },
        {
            "LastModified": 1577824396.653,
            "FunctionArn": "arn:aws:lambda:us-east-2:123456789012:function:my-function:BLUE",
            "MaximumRetryAttempts": 0,
            "MaximumEventAgeInSeconds": 3600
        }
    ]
}

Das folgende Codebeispiel zeigt, wie list-functions verwendet wird.

AWS CLI

Eine Liste der Lambda-Funktionen abrufen

Im folgenden Beispiel für list-functions wird eine Liste aller Funktionen für den aktuellen Benutzer angezeigt.

aws lambda list-functions

Ausgabe:

{
    "Functions": [
        {
            "TracingConfig": {
                "Mode": "PassThrough"
            },
            "Version": "$LATEST",
            "CodeSha256": "dBG9m8SGdmlEjw/JYXlhhvCrAv5TxvXsbL/RMr0fT/I=",
            "FunctionName": "helloworld",
            "MemorySize": 128,
            "RevisionId": "1718e831-badf-4253-9518-d0644210af7b",
            "CodeSize": 294,
            "FunctionArn": "arn:aws:lambda:us-west-2:123456789012:function:helloworld",
            "Handler": "helloworld.handler",
            "Role": "arn:aws:iam::123456789012:role/service-role/MyTestFunction-role-zgur6bf4",
            "Timeout": 3,
            "LastModified": "2023-09-23T18:32:33.857+0000",
            "Runtime": "nodejs18.x",
            "Description": ""
        },
        {
            "TracingConfig": {
                "Mode": "PassThrough"
            },
            "Version": "$LATEST",
            "CodeSha256": "sU0cJ2/hOZevwV/lTxCuQqK3gDZP3i8gUoqUUVRmY6E=",
            "FunctionName": "my-function",
            "VpcConfig": {
                "SubnetIds": [],
                "VpcId": "",
                "SecurityGroupIds": []
            },
            "MemorySize": 256,
            "RevisionId": "93017fc9-59cb-41dc-901b-4845ce4bf668",
            "CodeSize": 266,
            "FunctionArn": "arn:aws:lambda:us-west-2:123456789012:function:my-function",
            "Handler": "index.handler",
            "Role": "arn:aws:iam::123456789012:role/service-role/helloWorldPython-role-uy3l9qyq",
            "Timeout": 3,
            "LastModified": "2023-10-01T16:47:28.490+0000",
            "Runtime": "nodejs18.x",
            "Description": ""
        },
        {
            "Layers": [
                {
                    "CodeSize": 41784542,
                    "Arn": "arn:aws:lambda:us-west-2:420165488524:layer:AWSLambda-Python37-SciPy1x:2"
                },
                {
                    "CodeSize": 4121,
                    "Arn": "arn:aws:lambda:us-west-2:123456789012:layer:pythonLayer:1"
                }
            ],
            "TracingConfig": {
                "Mode": "PassThrough"
            },
            "Version": "$LATEST",
            "CodeSha256": "ZQukCqxtkqFgyF2cU41Avj99TKQ/hNihPtDtRcc08mI=",
            "FunctionName": "my-python-function",
            "VpcConfig": {
                "SubnetIds": [],
                "VpcId": "",
                "SecurityGroupIds": []
            },
            "MemorySize": 128,
            "RevisionId": "80b4eabc-acf7-4ea8-919a-e874c213707d",
            "CodeSize": 299,
            "FunctionArn": "arn:aws:lambda:us-west-2:123456789012:function:my-python-function",
            "Handler": "lambda_function.lambda_handler",
            "Role": "arn:aws:iam::123456789012:role/service-role/my-python-function-role-z5g7dr6n",
            "Timeout": 3,
            "LastModified": "2023-10-01T19:40:41.643+0000",
            "Runtime": "python3.11",
            "Description": ""
        }
    ]
}

Weitere Informationen finden Sie unter Konfigurieren von AWS-Lambda-Funktionen im AWS-Lambda-Entwicklerhandbuch.

  • API-Details finden Sie unter ListFunctions in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie list-layer-versions verwendet wird.

AWS CLI

So listen Sie die Versionen eines AWS-Lambda-Layers auf

Im folgenden Beispiel für list-layers-versions werden Informationen zu den Versionen für den Layer namens my-layer angezeigt.

aws lambda list-layer-versions \
    --layer-name my-layer

Ausgabe:

{
    "Layers": [
        {
            "LayerVersionArn": "arn:aws:lambda:us-east-2:123456789012:layer:my-layer:2",
            "Version": 2,
            "Description": "My layer",
            "CreatedDate": "2023-11-15T00:37:46.592+0000",
            "CompatibleRuntimes": [
                "python3.10",
                "python3.11"
            ]
        }
    ]
}

Weitere Informationen finden Sie unter AWS-Lambda-Layer im AWS-Lambda-Entwicklerhandbuch.

Das folgende Codebeispiel zeigt, wie list-layers verwendet wird.

AWS CLI

So listen Sie die Layer auf, die mit der Laufzeit Ihrer Funktion kompatibel sind

Im folgenden Beispiel für list-layers werden Informationen zu Layern angezeigt, die mit der Python 3.11-Laufzeit kompatibel sind.

aws lambda list-layers \
    --compatible-runtime python3.11

Ausgabe:

{
    "Layers": [
        {
            "LayerName": "my-layer",
            "LayerArn": "arn:aws:lambda:us-east-2:123456789012:layer:my-layer",
            "LatestMatchingVersion": {
                "LayerVersionArn": "arn:aws:lambda:us-east-2:123456789012:layer:my-layer:2",
                "Version": 2,
                "Description": "My layer",
                "CreatedDate": "2023-11-15T00:37:46.592+0000",
                "CompatibleRuntimes": [
                    "python3.10",
                    "python3.11"
                ]
            }
        }
    ]
}

Weitere Informationen finden Sie unter AWS-Lambda-Layer im AWS-Lambda-Entwicklerhandbuch.

  • API-Details finden Sie unter ListLayers in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie list-provisioned-concurrency-configs verwendet wird.

AWS CLI

So erhalten Sie eine Liste der bereitgestellten Gleichzeitigkeitskonfigurationen

Das folgende list-provisioned-concurrency-configs-Beispiel listet die bereitgestellten Gleichzeitigkeitskonfigurationen für die angegebene Funktion auf.

aws lambda list-provisioned-concurrency-configs \
    --function-name my-function

Ausgabe:

{
    "ProvisionedConcurrencyConfigs": [
        {
            "FunctionArn": "arn:aws:lambda:us-east-2:123456789012:function:my-function:GREEN",
            "RequestedProvisionedConcurrentExecutions": 100,
            "AvailableProvisionedConcurrentExecutions": 100,
            "AllocatedProvisionedConcurrentExecutions": 100,
            "Status": "READY",
            "LastModified": "2019-12-31T20:29:00+0000"
        },
        {
            "FunctionArn": "arn:aws:lambda:us-east-2:123456789012:function:my-function:BLUE",
            "RequestedProvisionedConcurrentExecutions": 100,
            "AvailableProvisionedConcurrentExecutions": 100,
            "AllocatedProvisionedConcurrentExecutions": 100,
            "Status": "READY",
            "LastModified": "2019-12-31T20:28:49+0000"
        }
    ]
}

Das folgende Codebeispiel zeigt, wie list-tags verwendet wird.

AWS CLI

So rufen Sie die Liste der Tags für eine Lambda-Funktion ab

Das folgende list-tags-Beispiel zeigt die an die my-function-Lambda-Funktion angehängten Tags an.

aws lambda list-tags \
    --resource arn:aws:lambda:us-west-2:123456789012:function:my-function

Ausgabe:

{
    "Tags": {
        "Category": "Web Tools",
        "Department": "Sales"
    }
}

Weitere Informationen finden Sie unter Tagging von Lambda-Funktionen im AWS-Lambda-Entwicklerhandbuch.

  • API-Details finden Sie unter ListTags in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie list-versions-by-function verwendet wird.

AWS CLI

So rufen Sie eine Liste der Versionen einer Funktion ab

Im folgenden list-versions-by-function-Beispiel wird die Liste der Versionen für die my-function-Lambda-Funktion angezeigt.

aws lambda list-versions-by-function \
    --function-name my-function

Ausgabe:

{
    "Versions": [
        {
            "TracingConfig": {
                "Mode": "PassThrough"
            },
            "Version": "$LATEST",
            "CodeSha256": "sU0cJ2/hOZevwV/lTxCuQqK3gDZP3i8gUoqUUVRmY6E=",
            "FunctionName": "my-function",
            "VpcConfig": {
                "SubnetIds": [],
                "VpcId": "",
                "SecurityGroupIds": []
            },
            "MemorySize": 256,
            "RevisionId": "93017fc9-59cb-41dc-901b-4845ce4bf668",
            "CodeSize": 266,
            "FunctionArn": "arn:aws:lambda:us-west-2:123456789012:function:my-function:$LATEST",
            "Handler": "index.handler",
            "Role": "arn:aws:iam::123456789012:role/service-role/helloWorldPython-role-uy3l9qyq",
            "Timeout": 3,
            "LastModified": "2019-10-01T16:47:28.490+0000",
            "Runtime": "nodejs10.x",
            "Description": ""
        },
        {
            "TracingConfig": {
                "Mode": "PassThrough"
            },
            "Version": "1",
            "CodeSha256": "5tT2qgzYUHoqwR616pZ2dpkn/0J1FrzJmlKidWaaCgk=",
            "FunctionName": "my-function",
            "VpcConfig": {
                "SubnetIds": [],
                "VpcId": "",
                "SecurityGroupIds": []
            },
            "MemorySize": 256,
            "RevisionId": "949c8914-012e-4795-998c-e467121951b1",
            "CodeSize": 304,
            "FunctionArn": "arn:aws:lambda:us-west-2:123456789012:function:my-function:1",
            "Handler": "index.handler",
            "Role": "arn:aws:iam::123456789012:role/service-role/helloWorldPython-role-uy3l9qyq",
            "Timeout": 3,
            "LastModified": "2019-09-26T20:28:40.438+0000",
            "Runtime": "nodejs10.x",
            "Description": "new version"
        },
        {
            "TracingConfig": {
                "Mode": "PassThrough"
            },
            "Version": "2",
            "CodeSha256": "sU0cJ2/hOZevwV/lTxCuQqK3gDZP3i8gUoqUUVRmY6E=",
            "FunctionName": "my-function",
            "VpcConfig": {
                "SubnetIds": [],
                "VpcId": "",
                "SecurityGroupIds": []
            },
            "MemorySize": 256,
            "RevisionId": "cd669f21-0f3d-4e1c-9566-948837f2e2ea",
            "CodeSize": 266,
            "FunctionArn": "arn:aws:lambda:us-west-2:123456789012:function:my-function:2",
            "Handler": "index.handler",
            "Role": "arn:aws:iam::123456789012:role/service-role/helloWorldPython-role-uy3l9qyq",
            "Timeout": 3,
            "LastModified": "2019-10-01T16:47:28.490+0000",
            "Runtime": "nodejs10.x",
            "Description": "newer version"
        }
    ]
}

Weitere Informationen finden Sie unter Konfigurieren von AWS-Lambda-Funktionsaliasen im AWS-Lambda-Entwicklerhandbuch.

Das folgende Codebeispiel zeigt, wie publish-layer-version verwendet wird.

AWS CLI

So erstellen Sie eine Lambda-Layer-Version

Im folgenden Beispiel für publish-layer-version wird eine neue Layer-Version einer Python-Bibliothek erstellt. Der Befehl ruft den Layer-Inhalt einer Datei namens layer.zip im angegebenen S3-Bucket ab.

aws lambda publish-layer-version \
    --layer-name my-layer \
    --description "My Python layer" \
    --license-info "MIT" \
    --content S3Bucket=lambda-layers-us-west-2-123456789012,S3Key=layer.zip \
    --compatible-runtimes python3.10 python3.11

Ausgabe:

{
    "Content": {
        "Location": "https://awslambda-us-west-2-layers.s3.us-west-2.amazonaws.com/snapshots/123456789012/my-layer-4aaa2fbb-ff77-4b0a-ad92-5b78a716a96a?versionId=27iWyA73cCAYqyH...",
        "CodeSha256": "tv9jJO+rPbXUUXuRKi7CwHzKtLDkDRJLB3cC3Z/ouXo=",
        "CodeSize": 169
    },
    "LayerArn": "arn:aws:lambda:us-west-2:123456789012:layer:my-layer",
    "LayerVersionArn": "arn:aws:lambda:us-west-2:123456789012:layer:my-layer:1",
    "Description": "My Python layer",
    "CreatedDate": "2023-11-14T23:03:52.894+0000",
    "Version": 1,
    "LicenseInfo": "MIT",
    "CompatibleRuntimes": [
        "python3.10",
        "python3.11"
    ]
}

Weitere Informationen finden Sie unter AWS-Lambda-Layer im AWS-Lambda-Entwicklerhandbuch.

Das folgende Codebeispiel zeigt, wie publish-version verwendet wird.

AWS CLI

So veröffentlichen Sie eine neue Version einer Funktion

Im folgenden Beispiel wird eine neue Version der publish-version my-function-Lambda-Funktion veröffentlicht.

aws lambda publish-version \
    --function-name my-function

Ausgabe:

{
    "TracingConfig": {
        "Mode": "PassThrough"
    },
    "CodeSha256": "dBG9m8SGdmlEjw/JYXlhhvCrAv5TxvXsbL/RMr0fT/I=",
    "FunctionName": "my-function",
    "CodeSize": 294,
    "RevisionId": "f31d3d39-cc63-4520-97d4-43cd44c94c20",
    "MemorySize": 128,
    "FunctionArn": "arn:aws:lambda:us-west-2:123456789012:function:my-function:3",
    "Version": "2",
    "Role": "arn:aws:iam::123456789012:role/service-role/MyTestFunction-role-zgur6bf4",
    "Timeout": 3,
    "LastModified": "2019-09-23T18:32:33.857+0000",
    "Handler": "my-function.handler",
    "Runtime": "nodejs10.x",
    "Description": ""
}

Weitere Informationen finden Sie unter Konfigurieren von AWS-Lambda-Funktionsaliasen im AWS-Lambda-Entwicklerhandbuch.

  • API-Details finden Sie unter PublishVersion in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie put-function-concurrency verwendet wird.

AWS CLI

So konfigurieren Sie ein Limit für reservierte Gleichzeitigkeit für eine Funktion

Im folgenden put-function-concurrency-Beispiel werden 100 reservierte gleichzeitige Ausführungen für die my-function-Funktion konfiguriert.

aws lambda put-function-concurrency \
    --function-name  my-function  \
    --reserved-concurrent-executions 100

Ausgabe:

{
    "ReservedConcurrentExecutions": 100
}

Weitere Informationen finden Sie unter Gleichzeitigkeit für eine Lambda-Funktion reservieren im AWS-Lambda-Entwicklerhandbuch.

Das folgende Codebeispiel zeigt, wie put-function-event-invoke-config verwendet wird.

AWS CLI

So konfigurieren Sie die Fehlerbehandlung für asynchronen Aufruf

Im folgenden Beispiel für put-function-event-invoke-config wird ein maximales Ereignisalter von einer Stunde festgelegt und Wiederholungsversuche werden für die angegebene Funktion deaktiviert.

aws lambda put-function-event-invoke-config \
    --function-name my-function \
    --maximum-event-age-in-seconds 3600 \
    --maximum-retry-attempts 0

Ausgabe:

{
    "LastModified": 1573686021.479,
    "FunctionArn": "arn:aws:lambda:us-east-2:123456789012:function:my-function:$LATEST",
    "MaximumRetryAttempts": 0,
    "MaximumEventAgeInSeconds": 3600,
    "DestinationConfig": {
        "OnSuccess": {},
        "OnFailure": {}
    }
}

Das folgende Codebeispiel zeigt, wie put-provisioned-concurrency-config verwendet wird.

AWS CLI

So weisen Sie bereitgestellte Gleichzeitigkeit zu

Das folgende put-provisioned-concurrency-config-Beispiel weist dem BLUE-Alias der angegebenen Funktion 100 bereitgestellte Gleichzeitigkeit zu.

aws lambda put-provisioned-concurrency-config \
    --function-name my-function \
    --qualifier BLUE \
    --provisioned-concurrent-executions 100

Ausgabe:

{
    "Requested ProvisionedConcurrentExecutions": 100,
    "Allocated ProvisionedConcurrentExecutions": 0,
    "Status": "IN_PROGRESS",
    "LastModified": "2019-11-21T19:32:12+0000"
}

Das folgende Codebeispiel zeigt, wie remove-layer-version-permission verwendet wird.

AWS CLI

So löschen Sie Berechtigungen für Layer-Versionen

Im folgenden Beispiel für remove-layer-version-permission wird die Berechtigung eines Kontos zum Konfigurieren einer Layer-Version gelöscht.

aws lambda remove-layer-version-permission \
    --layer-name my-layer \
    --statement-id xaccount \
    --version-number 1

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter AWS-Lambda-Layer im AWS-Lambda-Entwicklerhandbuch.

Das folgende Codebeispiel zeigt, wie remove-permission verwendet wird.

AWS CLI

So entfernen Sie Berechtigungen aus einer vorhandenen Lambda-Funktion

Das folgende remove-permission-Beispiel entfernt die Berechtigung zum Aufrufen einer Funktion namens my-function.

aws lambda remove-permission \
    --function-name my-function \
    --statement-id sns

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Verwendung ressourcenbasierter Richtlinien für AWS-Lambda im AWS-Lambda-Entwicklerhandbuch.

Das folgende Codebeispiel zeigt, wie tag-resource verwendet wird.

AWS CLI

So fügen Sie einer vorhandenen Lambda-Funktion Tags hinzu

Das folgende tag-resource-Beispiel fügt der angegebenen Lambda-Funktion ein Tag mit dem Schlüsselnamen DEPARTMENT und einem Wert von Department A hinzu.

aws lambda tag-resource \
    --resource arn:aws:lambda:us-west-2:123456789012:function:my-function \
    --tags "DEPARTMENT=Department A"

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Tagging von Lambda-Funktionen im AWS-Lambda-Entwicklerhandbuch.

  • API-Details finden Sie unter TagResource in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie untag-resource verwendet wird.

AWS CLI

So entfernen Sie Tags aus einer vorhandenen Lambda-Funktion

Das folgende untag-resource-Beispiel entfernt das Tag mit dem Schlüsselnamen DEPARTMENT-Tag aus der Lambda-Funktion my-function.

aws lambda untag-resource \
    --resource arn:aws:lambda:us-west-2:123456789012:function:my-function \
    --tag-keys DEPARTMENT

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Tagging von Lambda-Funktionen im AWS-Lambda-Entwicklerhandbuch.

  • API-Details finden Sie unter UntagResource in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie update-alias verwendet wird.

AWS CLI

So aktualisieren Sie einen Funktionsalias

Das folgende update-alias-Beispiel aktualisiert den Alias mit dem Namen LIVE so, dass er auf Version 3 der my-function-Lambda-Funktion verweist.

aws lambda update-alias \
    --function-name my-function \
    --function-version 3 \
    --name LIVE

Ausgabe:

{
    "FunctionVersion": "3",
    "Name": "LIVE",
    "AliasArn": "arn:aws:lambda:us-west-2:123456789012:function:my-function:LIVE",
    "RevisionId": "594f41fb-b85f-4c20-95c7-6ca5f2a92c93",
    "Description": "alias for live version of function"
}

Weitere Informationen finden Sie unter Konfigurieren von AWS-Lambda-Funktionsaliasen im AWS-Lambda-Entwicklerhandbuch.

  • API-Details finden Sie unter UpdateAlias in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie update-event-source-mapping verwendet wird.

AWS CLI

So aktualisieren Sie die Zuordnung zwischen einer Ereignisquelle und einer AWS-Lambda-Funktion

Im folgenden Beispiel für update-event-source-mapping wird die Batchgröße in der angegebenen Zuordnung auf 8 aktualisiert.

aws lambda update-event-source-mapping \
    --uuid  "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE" \
    --batch-size 8

Ausgabe:

{
    "UUID": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE",
    "StateTransitionReason": "USER_INITIATED",
    "LastModified": 1569284520.333,
    "BatchSize": 8,
    "State": "Updating",
    "FunctionArn": "arn:aws:lambda:us-west-2:123456789012:function:my-function",
    "EventSourceArn": "arn:aws:sqs:us-west-2:123456789012:mySQSqueue"
}

Weitere Informationen finden Sie unter AWS-Lambda-Zuordnung von Ereignisquellen im AWS-Lambda-Entwicklerhandbuch.

Das folgende Codebeispiel zeigt, wie update-function-code verwendet wird.

AWS CLI

Den Code einer Lambda-Funktion aktualisieren

Im folgenden Beispiel für update-function-code wird der Code der unveröffentlichten Version ($LATEST) der Funktion my-function durch den Inhalt der angegebenen ZIP-Datei ersetzt.

aws lambda update-function-code \
    --function-name  my-function \
    --zip-file fileb://my-function.zip

Ausgabe:

{
    "FunctionName": "my-function",
    "LastModified": "2019-09-26T20:28:40.438+0000",
    "RevisionId": "e52502d4-9320-4688-9cd6-152a6ab7490d",
    "MemorySize": 256,
    "Version": "$LATEST",
    "Role": "arn:aws:iam::123456789012:role/service-role/my-function-role-uy3l9qyq",
    "Timeout": 3,
    "Runtime": "nodejs10.x",
    "TracingConfig": {
        "Mode": "PassThrough"
    },
    "CodeSha256": "5tT2qgzYUHaqwR716pZ2dpkn/0J1FrzJmlKidWoaCgk=",
    "Description": "",
    "VpcConfig": {
        "SubnetIds": [],
        "VpcId": "",
        "SecurityGroupIds": []
    },
    "CodeSize": 304,
    "FunctionArn": "arn:aws:lambda:us-west-2:123456789012:function:my-function",
    "Handler": "index.handler"
}

Weitere Informationen finden Sie unter Konfigurieren von AWS-Lambda-Funktionen im AWS-Lambda-Entwicklerhandbuch.

Das folgende Codebeispiel zeigt, wie update-function-configuration verwendet wird.

AWS CLI

Die Konfiguration einer Funktion ändern

Im folgenden Beispiel für update-function-configuration wird die Speichergröße für die unveröffentlichte Version ($LATEST) der Funktion my-function auf 256 MB geändert.

aws lambda update-function-configuration \
    --function-name  my-function \
    --memory-size 256

Ausgabe:

{
    "FunctionName": "my-function",
    "LastModified": "2019-09-26T20:28:40.438+0000",
    "RevisionId": "e52502d4-9320-4688-9cd6-152a6ab7490d",
    "MemorySize": 256,
    "Version": "$LATEST",
    "Role": "arn:aws:iam::123456789012:role/service-role/my-function-role-uy3l9qyq",
    "Timeout": 3,
    "Runtime": "nodejs10.x",
    "TracingConfig": {
        "Mode": "PassThrough"
    },
    "CodeSha256": "5tT2qgzYUHaqwR716pZ2dpkn/0J1FrzJmlKidWoaCgk=",
    "Description": "",
    "VpcConfig": {
        "SubnetIds": [],
        "VpcId": "",
        "SecurityGroupIds": []
    },
    "CodeSize": 304,
    "FunctionArn": "arn:aws:lambda:us-west-2:123456789012:function:my-function",
    "Handler": "index.handler"
}

Weitere Informationen finden Sie unter Konfigurieren von AWS-Lambda-Funktionen im AWS-Lambda-Entwicklerhandbuch.

Das folgende Codebeispiel zeigt, wie update-function-event-invoke-config verwendet wird.

AWS CLI

So aktualisieren Sie eine Konfiguration für asynchronen Aufruf

Im folgenden Beispiel für update-function-event-invoke-config wird der vorhandenen Konfiguration für asynchronen Aufruf ein Ausfallziel für die angegebene Funktion hinzugefügt.

aws lambda update-function-event-invoke-config \
    --function-name my-function \
    --destination-config '{"OnFailure":{"Destination": "arn:aws:sqs:us-east-2:123456789012:destination"}}'

Ausgabe:

{
    "LastModified": 1573687896.493,
    "FunctionArn": "arn:aws:lambda:us-east-2:123456789012:function:my-function:$LATEST",
    "MaximumRetryAttempts": 0,
    "MaximumEventAgeInSeconds": 3600,
    "DestinationConfig": {
        "OnSuccess": {},
        "OnFailure": {
            "Destination": "arn:aws:sqs:us-east-2:123456789012:destination"
        }
    }
}