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

Beispiele für die Verwendung der AWS CLI mit MemoryDB

Die folgenden Codebeispiele zeigen, wie Sie Aktionen durchführen und gängige Szenarien implementieren, indem Sie die AWS Command Line Interface mit MemoryDB nutzen.

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 eine Anleitung zum Einrichten und Ausführen des Codes im Kontext finden.

Themen

Aktionen

Das folgende Codebeispiel zeigt, wie copy-snapshot verwendet wird.

AWS CLI

So kopieren Sie einen Snapshot

Im folgenden Beispiel für copy-snapshot wird die Kopie eines DB-Snapshots erstellt.

aws memorydb copy-snapshot \
    --source-snapshot-name my-cluster-snapshot \
    --target-snapshot-name my-cluster-snapshot-copy

Output

{
    "Snapshot": {
        "Name": "my-cluster-snapshot-copy",
        "Status": "creating",
        "Source": "manual",
        "ARN": "arn:aws:memorydb:us-east-1:491658xxxxxx:snapshot/my-cluster-snapshot-copy",
        "ClusterConfiguration": {
            "Name": "my-cluster",
            "Description": " ",
            "NodeType": "db.r6g.large",
            "EngineVersion": "6.2",
            "MaintenanceWindow": "wed:03:00-wed:04:00",
            "Port": 6379,
            "ParameterGroupName": "default.memorydb-redis6",
            "SubnetGroupName": "my-sg",
            "VpcId": "vpc-xx2574fc",
            "SnapshotRetentionLimit": 0,
            "SnapshotWindow": "04:30-05:30",
            "NumShards": 2
        }
    }
}

Weitere Informationen finden Sie unter Kopieren eines Snapshots im Benutzerhandbuch zu MemoryDB.

  • Weitere Details zur API finden Sie unter CopySnapshot in der AWS CLI-Befehlsreferenz.

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

AWS CLI

So erstellen Sie eine CLI

Im folgenden Beispiel für create-acl wird eine neue Zugriffssteuerungsliste erstellt.

aws memorydb create-acl \
    --acl-name "new-acl-1" \
    --user-names "my-user"

Ausgabe:

{
    "ACL": {
        "Name": "new-acl-1",
        "Status": "creating",
        "UserNames": [
            "my-user"
        ],
        "MinimumEngineVersion": "6.2",
        "Clusters": [],
        "ARN": "arn:aws:memorydb:us-east-1:491658xxxxxx:acl/new-acl-1"
    }
}

Weitere Informationen finden Sie unter Authentifizieren von Benutzern mit Zugriffssteuerungslisten im Benutzerhandbuch zu MemoryDB.

  • Weitere Details zur API finden Sie unter CreateAcl in der AWS CLI-Befehlsreferenz.

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

AWS CLI

So erstellen Sie einen Cluster

Im folgenden Beispiel für create-cluster wird ein neuer Cluster erstellt.

aws memorydb create-cluster \
    --cluster-name my-new-cluster \
    --node-type db.r6g.large \
    --acl-name my-acl \
    --subnet-group my-sg

Ausgabe:

{
    "Cluster": {
        "Name": "my-new-cluster",
        "Status": "creating",
        "NumberOfShards": 1,
        "AvailabilityMode": "MultiAZ",
        "ClusterEndpoint": {
            "Port": 6379
        },
        "NodeType": "db.r6g.large",
        "EngineVersion": "6.2",
        "EnginePatchVersion": "6.2.6",
        "ParameterGroupName": "default.memorydb-redis6",
        "ParameterGroupStatus": "in-sync",
        "SubnetGroupName": "my-sg",
        "TLSEnabled": true,
        "ARN": "arn:aws:memorydb:us-east-1:49165xxxxxx:cluster/my-new-cluster",
        "SnapshotRetentionLimit": 0,
        "MaintenanceWindow": "sat:10:00-sat:11:00",
        "SnapshotWindow": "07:30-08:30",
        "ACLName": "my-acl",
        "AutoMinorVersionUpgrade": true
    }
}

Weitere Informationen finden Sie unter Verwalten von Clustern im Benutzerhandbuch zu MemoryDB.

  • Weitere Details zur API finden Sie unter CreateCluster in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie create-parameter-group verwendet wird.

AWS CLI

So erstellen Sie eine Parametergruppe

Im folgenden Beispiel für create-parameter-group wird eine Parametergruppe erstellt.

aws memorydb create-parameter-group \
    --parameter-group-name myRedis6x \
    --family memorydb_redis6 \
    --description "my-parameter-group"

Ausgabe:

{
    "ParameterGroup": {
        "Name": "myredis6x",
        "Family": "memorydb_redis6",
        "Description": "my-parameter-group",
        "ARN": "arn:aws:memorydb:us-east-1:49165xxxxxx:parametergroup/myredis6x"
    }
}

Weitere Informationen finden Sie unter Erstellen einer Parametergruppe im Benutzerhandbuch zu MemoryDB.

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

AWS CLI

So erstellen Sie einen Snapshot

Im folgenden Beispiel für create-snapshot wird ein Snapshot erstellt.

aws memorydb create-snapshot \
    --cluster-name my-cluster \
    --snapshot-name my-cluster-snapshot

Ausgabe:

{
    "Snapshot": {
        "Name": "my-cluster-snapshot1",
        "Status": "creating",
        "Source": "manual",
        "ARN": "arn:aws:memorydb:us-east-1:49165xxxxxx:snapshot/my-cluster-snapshot",
        "ClusterConfiguration": {
            "Name": "my-cluster",
            "Description": "",
            "NodeType": "db.r6g.large",
            "EngineVersion": "6.2",
            "MaintenanceWindow": "wed:03:00-wed:04:00",
            "Port": 6379,
            "ParameterGroupName": "default.memorydb-redis6",
            "SubnetGroupName": "my-sg",
            "VpcId": "vpc-862xxxxc",
            "SnapshotRetentionLimit": 0,
            "SnapshotWindow": "04:30-05:30",
            "NumShards": 2
        }
    }
}

Weitere Informationen finden Sie unter Erstellen manueller Snapshots im Benutzerhandbuch zu MemoryDB.

  • Weitere Details zur API finden Sie unter CreateSnapshot in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie create-subnet-group verwendet wird.

AWS CLI

So erstellen Sie eine Subnetzgruppe

Im folgenden Beispiel für create-subnet-group wird eine Subnetzgruppe erstellt.

aws memorydb create-subnet-group \
    --subnet-group-name mysubnetgroup \
    --description "my subnet group" \
    --subnet-ids subnet-5623xxxx

Ausgabe:

{
    "SubnetGroup": {
        "Name": "mysubnetgroup",
        "Description": "my subnet group",
        "VpcId": "vpc-86257xxx",
        "Subnets": [
            {
                "Identifier": "subnet-5623xxxx",
                "AvailabilityZone": {
                    "Name": "us-east-1a"
                }
            }
        ],
        "ARN": "arn:aws:memorydb:us-east-1:491658xxxxxx:subnetgroup/mysubnetgroup"
    }
}

Weitere Informationen finden Sie unter Erstellen einer Subnetzgruppe im Benutzerhandbuch zu MemoryDB.

  • Weitere Details zur API finden Sie unter CreateSubnetGroup in der AWS CLI-Befehlsreferenz.

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

AWS CLI

So erstellen Sie einen Benutzer

Im folgenden Beispiel für create-user wird ein neuer Benutzer erstellt.

aws memorydb create-user \
    --user-name user-name-1 \
    --access-string "~objects:* ~items:* ~public:*" \
     --authentication-mode \
         Passwords="enterapasswordhere",Type=password

Ausgabe:

{
    "User": {
        "Name": "user-name-1",
        "Status": "active",
        "AccessString": "off ~objects:* ~items:* ~public:* resetchannels -@all",
        "ACLNames": [],
        "MinimumEngineVersion": "6.2",
        "Authentication": {
            "Type": "password",
            "PasswordCount": 1
        },
        "ARN": "arn:aws:memorydb:us-west-2:491658xxxxxx:user/user-name-1"
    }
}

Weitere Informationen finden Sie unter Authentifizieren von Benutzern mit Zugriffssteuerungslisten im Benutzerhandbuch zu MemoryDB.

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

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

AWS CLI

So löschen Sie einen ACL

Im folgenden Beispiel für delete-acl wird eine Zugriffssteuerungsliste gelöscht.

aws memorydb delete-acl \
    --acl-name "new-acl-1"

Ausgabe:

{
    "ACL": {
        "Name": "new-acl-1",
        "Status": "deleting",
        "UserNames": [
            "pat"
        ],
        "MinimumEngineVersion": "6.2",
        "Clusters": [],
        "ARN": "arn:aws:memorydb:us-east-1:491658xxxxxx:acl/new-acl-1"
    }
}

Weitere Informationen finden Sie unter Authentifizieren von Benutzern mit Zugriffssteuerungslisten im Benutzerhandbuch zu MemoryDB.

  • Weitere Details zur API finden Sie unter DeleteAcl in der AWS CLI-Befehlsreferenz.

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

AWS CLI

Löschen eines Clusters

Im folgenden Beispiel für delete-cluster wird ein Cluster gelöscht.

aws memorydb delete-cluster \
    --cluster-name my-new-cluster

Ausgabe:

{
    "Cluster": {
        "Name": "my-new-cluster",
        "Status": "deleting",
        "NumberOfShards": 1,
        "ClusterEndpoint": {
            "Address": "clustercfg.my-new-cluster.xxxxx.memorydb.us-east-1.amazonaws.com",
            "Port": 6379
        },
        "NodeType": "db.r6g.large",
        "EngineVersion": "6.2",
        "EnginePatchVersion": "6.2.6",
        "ParameterGroupName": "default.memorydb-redis6",
        "ParameterGroupStatus": "in-sync",
        "SubnetGroupName": "my-sg",
        "TLSEnabled": true,
        "ARN": "arn:aws:memorydb:us-east-1:491658xxxxxx:cluster/my-new-cluster",
        "SnapshotRetentionLimit": 0,
        "MaintenanceWindow": "sat:10:00-sat:11:00",
        "SnapshotWindow": "07:30-08:30",
        "AutoMinorVersionUpgrade": true
    }
}

Weitere Informationen finden Sie unter Löschen eines Clusters im Benutzerhandbuch zu MemoryDB.

  • Weitere Details zur API finden Sie unter DeleteCluster in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie delete-parameter-group verwendet wird.

AWS CLI

So löschen Sie eine Parametergruppe

Im folgenden Beispiel für delete-parameter-group wird eine Parametergruppe gelöscht.

aws memorydb delete-parameter-group \
    --parameter-group-name myRedis6x

Ausgabe:

{
    "ParameterGroup": {
        "Name": "myredis6x",
        "Family": "memorydb_redis6",
        "Description": "my-parameter-group",
        "ARN": "arn:aws:memorydb:us-east-1:491658xxxxxx:parametergroup/myredis6x"
    }
}

Weitere Informationen finden Sie unter Löschen einer Parametergruppe im Benutzerhandbuch zu MemoryDB.

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

AWS CLI

So löschen Sie einen Snapshot

Im folgenden Beispiel für delete-snapshot wird ein Snapshot gelöscht.

aws memorydb delete-snapshot \
    --snapshot-name my-cluster-snapshot

Ausgabe:

{
    "Snapshot": {
        "Name": "my-cluster-snapshot",
        "Status": "deleting",
        "Source": "manual",
        "ARN": "arn:aws:memorydb:us-east-1:49165xxxxxx:snapshot/my-cluster-snapshot",
        "ClusterConfiguration": {
            "Name": "my-cluster",
            "Description": "",
            "NodeType": "db.r6g.large",
            "EngineVersion": "6.2",
            "MaintenanceWindow": "wed:03:00-wed:04:00",
            "Port": 6379,
            "ParameterGroupName": "default.memorydb-redis6",
            "SubnetGroupName": "my-sg",
            "VpcId": "vpc-862xxxxc",
            "SnapshotRetentionLimit": 0,
            "SnapshotWindow": "04:30-05:30",
            "NumShards": 2
        }
    }
}

Weitere Informationen finden Sie unter Löschen eines Snapshots im Benutzerhandbuch zu MemoryDB.

  • Weitere Details zur API finden Sie unter DeleteSnapshot in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie delete-subnet-group verwendet wird.

AWS CLI

So löschen Sie eine Subnetzgruppe

Im folgenden Beispiel für delete-subnet-group wird ein Subnetz gelöscht.

aws memorydb delete-subnet-group \
    --subnet-group-name mysubnetgroup

Ausgabe:

{
    "SubnetGroup": {
        "Name": "mysubnetgroup",
        "Description": "my subnet group",
        "VpcId": "vpc-86xxxx4fc",
        "Subnets": [
            {
                "Identifier": "subnet-56xxx61b",
                "AvailabilityZone": {
                    "Name": "us-east-1a"
                }
            }
        ],
        "ARN": "arn:aws:memorydb:us-east-1:491658xxxxxx:subnetgroup/mysubnetgroup"
    }
}

Weitere Informationen finden Sie unter Löschen einer Subnetzgruppe im Benutzerhandbuch zu MemoryDB.

  • Weitere Details zur API finden Sie unter DeleteSubnetGroup in der AWS CLI-Befehlsreferenz.

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

AWS CLI

Benutzer löschen

Im folgenden Beispiel für delete-user wird ein Benutzer gelöscht.

aws memorydb delete-user \
    --user-name my-user

Ausgabe:

{
    "User": {
        "Name": "my-user",
        "Status": "deleting",
        "AccessString": "on ~app::* resetchannels -@all +@read",
        "ACLNames": [
            "my-acl"
        ],
        "MinimumEngineVersion": "6.2",
        "Authentication": {
            "Type": "password",
            "PasswordCount": 1
        },
        "ARN": "arn:aws:memorydb:us-east-1:491658xxxxxx:user/my-user"
    }
}

Weitere Informationen finden Sie unter Authentifizieren von Benutzern mit Zugriffssteuerungslisten im Benutzerhandbuch zu MemoryDB.

  • Weitere Details zur API finden Sie unter DeleteUser in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie describe-acls verwendet wird.

AWS CLI

So geben Sie eine Liste von ACLs zurück

Der folgende Befehl „describe-acls`“ gibt eine Liste von ACLs zurück.

aws memorydb describe-acls

Ausgabe:

{
    "ACLs": [
        {
            "Name": "open-access",
            "Status": "active",
            "UserNames": [
                "default"
            ],
            "MinimumEngineVersion": "6.2",
            "Clusters": [],
            "ARN": "arn:aws:memorydb:us-east-1:491658xxxxxx:acl/open-access"
        },
        {
            "Name": my-acl",
            "Status": "active",
            "UserNames": [],
            "MinimumEngineVersion": "6.2",
            "Clusters": [
                "my-cluster"
            ],
            "ARN": "arn:aws:memorydb:us-east-1:49165xxxxxxx:acl/my-acl"
        }
    ]
}

Weitere Informationen finden Sie unter Authentifizieren von Benutzern mit Zugriffssteuerungslisten im Benutzerhandbuch zu MemoryDB.

  • Weitere Details zur API finden Sie unter DescribeAcls in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie describe-clusters verwendet wird.

AWS CLI

So geben Sie eine Liste von Clustern zurück

Der folgende Befehl „describe-clusters`“ gibt eine Liste von Clustern zurück.

aws memorydb describe-clusters

Ausgabe:

{
    "Clusters": [
        {
                "Name": "my-cluster",
                "Status": "available",
                "NumberOfShards": 2,
                "ClusterEndpoint": {
                    "Address": "clustercfg.my-cluster.llru6f.memorydb.us-east-1.amazonaws.com",
                    "Port": 6379
                },
                "NodeType": "db.r6g.large",
                "EngineVersion": "6.2",
                "EnginePatchVersion": "6.2.6",
                "ParameterGroupName": "default.memorydb-redis6",
                "ParameterGroupStatus": "in-sync",
                "SecurityGroups": [
                    {
                        "SecurityGroupId": "sg-0a1434xxxxxc9fae",
                        "Status": "active"
                    }
                ],
                "SubnetGroupName": "pat-sg",
                "TLSEnabled": true,
                "ARN": "arn:aws:memorydb:us-east-1:49165xxxxxx:cluster/my-cluster",
                "SnapshotRetentionLimit": 0,
                "MaintenanceWindow": "wed:03:00-wed:04:00",
                "SnapshotWindow": "04:30-05:30",
                "ACLName": "my-acl",
                "AutoMinorVersionUpgrade": true
        }
    ]
}

Weitere Informationen finden Sie unter Verwalten von Clustern im Benutzerhandbuch zu MemoryDB.

  • Weitere Details zur API finden Sie unter DescribeClusters in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie describe-engine-versions verwendet wird.

AWS CLI

So geben Sie eine Liste von Engine-Versionen zurück

Der folgende Befehl „describe-engine-versions`“ gibt eine Liste von Engine-Versionen zurück.

aws memorydb describe-engine-versions

Ausgabe:

{
    "EngineVersions": [
        {
            "EngineVersion": "6.2",
            "EnginePatchVersion": "6.2.6",
            "ParameterGroupFamily": "memorydb_redis6"
        }
    ]
}

Weitere Informationen finden Sie unter Engine-Versionen und Upgrades im Benutzerhandbuch zu MemoryDB.

Das folgende Codebeispiel zeigt, wie describe-events verwendet wird.

AWS CLI

So geben Sie eine Liste von Ereignissen zurück

Der folgende Befehl „describe-events`“ gibt eine Liste von Ereignissen zurück.

aws memorydb describe-events

Ausgabe:

{
    "Events": [
        {
            "SourceName": "my-cluster",
            "SourceType": "cluster",
            "Message": "Increase replica count started for replication group my-cluster on 2022-07-22T14:09:01.440Z",
            "Date": "2022-07-22T07:09:01.443000-07:00"
        },
        {
            "SourceName": "my-user",
            "SourceType": "user",
            "Message": "Create user my-user operation completed.",
            "Date": "2022-07-22T07:00:02.975000-07:00"
        }
    ]
}

Weitere Informationen finden Sie unter Überwachen von Ereignissen im Benutzerhandbuch zu MemoryDB.

  • Weitere Details zur API finden Sie unter DescribeEvents in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie describe-parameter-groups verwendet wird.

AWS CLI

So geben Sie eine Liste von Parametergruppen zurück

Der folgende Befehl „describe-parameter-groups`“ gibt eine Liste von Parametergruppen zurück.

aws memorydb describe-parameter-groups

Ausgabe:

{
    "ParameterGroups": [
        {
            "Name": "default.memorydb-redis6",
            "Family": "memorydb_redis6",
            "Description": "Default parameter group for memorydb_redis6",
            "ARN": "arn:aws:memorydb:us-east-1:491658xxxxxx:parametergroup/default.memorydb-redis6"
        }
    ]
}

Weitere Informationen finden Sie unter Konfigurieren von Engine-Parametern mithilfe von Parametergruppen im Benutzerhandbuch zu MemoryDB.

Das folgende Codebeispiel zeigt, wie describe-parameters verwendet wird.

AWS CLI

So geben Sie eine Liste von Parametergruppen zurück

Der folgende Befehl „describe-parameters`“ gibt eine Liste von Parametern zurück.

aws memorydb describe-parameters

Ausgabe:

{
    "Parameters": [
        {
            "Name": "acllog-max-len",
            "Value": "128",
            "Description": "The maximum length of the ACL Log",
            "DataType": "integer",
            "AllowedValues": "1-10000",
            "MinimumEngineVersion": "6.2.4"
        },
        {
            "Name": "activedefrag",
            "Value": "no",
            "Description": "Enabled active memory defragmentation",
            "DataType": "string",
            "AllowedValues": "yes,no",
            "MinimumEngineVersion": "6.2.4"
        },
        {
            "Name": "active-defrag-cycle-max",
            "Value": "75",
            "Description": "Maximal effort for defrag in CPU percentage",
            "DataType": "integer",
            "AllowedValues": "1-75",
            "MinimumEngineVersion": "6.2.4"
        },
        {
            "Name": "active-defrag-cycle-min",
            "Value": "5",
            "Description": "Minimal effort for defrag in CPU percentage",
            "DataType": "integer",
            "AllowedValues": "1-75",
            "MinimumEngineVersion": "6.2.4"
        },
        {
            "Name": "active-defrag-ignore-bytes",
            "Value": "104857600",
            "Description": "Minimum amount of fragmentation waste to start active defrag",
            "DataType": "integer",
            "AllowedValues": "1048576-",
            "MinimumEngineVersion": "6.2.4"
        },
        {
            "Name": "active-defrag-max-scan-fields",
            "Value": "1000",
            "Description": "Maximum number of set/hash/zset/list fields that will be processed from the main dictionary scan",
            "DataType": "integer",
            "AllowedValues": "1-1000000",
            "MinimumEngineVersion": "6.2.4"
        },
        {
            "Name": "active-defrag-threshold-lower",
            "Value": "10",
            "Description": "Minimum percentage of fragmentation to start active defrag",
            "DataType": "integer",
            "AllowedValues": "1-100",
            "MinimumEngineVersion": "6.2.4"
        },
        {
            "Name": "active-defrag-threshold-upper",
            "Value": "100",
            "Description": "Maximum percentage of fragmentation at which we use maximum effort",
            "DataType": "integer",
            "AllowedValues": "1-100",
            "MinimumEngineVersion": "6.2.4"
        },
        {
            "Name": "active-expire-effort",
            "Value": "1",
            "Description": "The amount of effort that redis uses to expire items in the active expiration job",
            "DataType": "integer",
            "AllowedValues": "1-10",
            "MinimumEngineVersion": "6.2.4"
        },
        {
            "Name": "activerehashing",
            "Value": "yes",
            "Description": "Apply rehashing or not",
            "DataType": "string",
            "AllowedValues": "yes,no",
            "MinimumEngineVersion": "6.2.4"
        },
        {
            "Name": "client-output-buffer-limit-normal-hard-limit",
            "Value": "0",
            "Description": "Normal client output buffer hard limit in bytes",
            "DataType": "integer",
            "AllowedValues": "0-",
            "MinimumEngineVersion": "6.2.4"
        },
        {
            "Name": "client-output-buffer-limit-normal-soft-limit",
            "Value": "0",
            "Description": "Normal client output buffer soft limit in bytes",
            "DataType": "integer",
            "AllowedValues": "0-",
            "MinimumEngineVersion": "6.2.4"
        },
        {
            "Name": "client-output-buffer-limit-normal-soft-seconds",
            "Value": "0",
            "Description": "Normal client output buffer soft limit in seconds",
            "DataType": "integer",
            "AllowedValues": "0-",
            "MinimumEngineVersion": "6.2.4"
        },
        {
            "Name": "client-output-buffer-limit-pubsub-hard-limit",
            "Value": "33554432",
            "Description": "Pubsub client output buffer hard limit in bytes",
            "DataType": "integer",
            "AllowedValues": "0-",
            "MinimumEngineVersion": "6.2.4"
        },
        {
            "Name": "client-output-buffer-limit-pubsub-soft-limit",
            "Value": "8388608",
            "Description": "Pubsub client output buffer soft limit in bytes",
            "DataType": "integer",
            "AllowedValues": "0-",
            "MinimumEngineVersion": "6.2.4"
        },
        {
            "Name": "client-output-buffer-limit-pubsub-soft-seconds",
            "Value": "60",
            "Description": "Pubsub client output buffer soft limit in seconds",
            "DataType": "integer",
            "AllowedValues": "0-",
            "MinimumEngineVersion": "6.2.4"
        },
        {
            "Name": "hash-max-ziplist-entries",
            "Value": "512",
            "Description": "The maximum number of hash entries in order for the dataset to be compressed",
            "DataType": "integer",
            "AllowedValues": "0-",
            "MinimumEngineVersion": "6.2.4"
        },
        {
            "Name": "hash-max-ziplist-value",
            "Value": "64",
            "Description": "The threshold of biggest hash entries in order for the dataset to be compressed",
            "DataType": "integer",
            "AllowedValues": "0-",
            "MinimumEngineVersion": "6.2.4"
        },
        {
            "Name": "hll-sparse-max-bytes",
            "Value": "3000",
            "Description": "HyperLogLog sparse representation bytes limit",
            "DataType": "integer",
            "AllowedValues": "1-16000",
            "MinimumEngineVersion": "6.2.4"
        },
        {
            "Name": "lazyfree-lazy-eviction",
            "Value": "no",
            "Description": "Perform an asynchronous delete on evictions",
            "DataType": "string",
            "AllowedValues": "yes,no",
            "MinimumEngineVersion": "6.2.4"
        },
        {
            "Name": "lazyfree-lazy-expire",
            "Value": "no",
            "Description": "Perform an asynchronous delete on expired keys",
            "DataType": "string",
            "AllowedValues": "yes,no",
            "MinimumEngineVersion": "6.2.4"
        },
        {
            "Name": "lazyfree-lazy-server-del",
            "Value": "no",
            "Description": "Perform an asynchronous delete on key updates",
            "DataType": "string",
            "AllowedValues": "yes,no",
            "MinimumEngineVersion": "6.2.4"
        },
        {
            "Name": "lazyfree-lazy-user-del",
            "Value": "no",
            "Description": "Specifies whether the default behavior of DEL command acts the same as UNLINK",
            "DataType": "string",
            "AllowedValues": "yes,no",
            "MinimumEngineVersion": "6.2.4"
        },
        {
            "Name": "lfu-decay-time",
            "Value": "1",
            "Description": "The amount of time in minutes to decrement the key counter for LFU eviction policyd",
            "DataType": "integer",
            "AllowedValues": "0-",
            "MinimumEngineVersion": "6.2.4"
        },
        {
            "Name": "lfu-log-factor",
            "Value": "10",
            "Description": "The log factor for incrementing key counter for LFU eviction policy",
            "DataType": "integer",
            "AllowedValues": "1-",
            "MinimumEngineVersion": "6.2.4"
        },
        {
            "Name": "list-compress-depth",
            "Value": "0",
            "Description": "Number of quicklist ziplist nodes from each side of the list to exclude from compression. The head and tail of the list are always uncompressed for fast push/pop operations",
            "DataType": "integer",
            "AllowedValues": "0-",
            "MinimumEngineVersion": "6.2.4"
        },
        {
            "Name": "maxmemory-policy",
            "Value": "noeviction",
            "Description": "Max memory policy",
            "DataType": "string",
            "AllowedValues": "volatile-lru,allkeys-lru,volatile-lfu,allkeys-lfu,volatile-random,allkeys-random,volatile-ttl,noeviction",
            "MinimumEngineVersion": "6.2.4"
        },
        {
            "Name": "maxmemory-samples",
            "Value": "3",
            "Description": "Max memory samples",
            "DataType": "integer",
            "AllowedValues": "1-",
            "MinimumEngineVersion": "6.2.4"
        },
        {
            "Name": "notify-keyspace-events",
            "Description": "The keyspace events for Redis to notify Pub/Sub clients about. By default all notifications are disabled",
            "DataType": "string",
            "MinimumEngineVersion": "6.2.4"
        },
        {
            "Name": "set-max-intset-entries",
            "Value": "512",
            "Description": "The limit in the size of the set in order for the dataset to be compressed",
            "DataType": "integer",
            "AllowedValues": "0-",
            "MinimumEngineVersion": "6.2.4"
        },
        {
            "Name": "slowlog-log-slower-than",
            "Value": "10000",
            "Description": "The execution time, in microseconds, to exceed in order for the command to get logged. Note that a negative number disables the slow log, while a value of zero forces the logging of every command",
            "DataType": "integer",
            "AllowedValues": "-",
            "MinimumEngineVersion": "6.2.4"
        },
        {
            "Name": "slowlog-max-len",
            "Value": "128",
            "Description": "The length of the slow log. There is no limit to this length. Just be aware that it will consume memory. You can reclaim memory used by the slow log with SLOWLOG RESET.",
            "DataType": "integer",
            "AllowedValues": "0-",
            "MinimumEngineVersion": "6.2.4"
        },
        {
            "Name": "stream-node-max-bytes",
            "Value": "4096",
            "Description": "The maximum size of a single node in a stream in bytes",
            "DataType": "integer",
            "AllowedValues": "0-",
            "MinimumEngineVersion": "6.2.4"
        },
        {
            "Name": "stream-node-max-entries",
            "Value": "100",
            "Description": "The maximum number of items a single node in a stream can contain",
            "DataType": "integer",
            "AllowedValues": "0-",
            "MinimumEngineVersion": "6.2.4"
        },
        {
            "Name": "tcp-keepalive",
            "Value": "300",
            "Description": "If non-zero, send ACKs every given number of seconds",
            "DataType": "integer",
            "AllowedValues": "0-",
            "MinimumEngineVersion": "6.2.4"
        },
        {
            "Name": "timeout",
            "Value": "0",
            "Description": "Close connection if client is idle for a given number of seconds, or never if 0",
            "DataType": "integer",
            "AllowedValues": "0,20-",
            "MinimumEngineVersion": "6.2.4"
        },
        {
            "Name": "tracking-table-max-keys",
            "Value": "1000000",
            "Description": "The maximum number of keys allowed for the tracking table for client side caching",
            "DataType": "integer",
            "AllowedValues": "1-100000000",
            "MinimumEngineVersion": "6.2.4"
        },
        {
            "Name": "zset-max-ziplist-entries",
            "Value": "128",
            "Description": "The maximum number of sorted set entries in order for the dataset to be compressed",
            "DataType": "integer",
            "AllowedValues": "0-",
            "MinimumEngineVersion": "6.2.4"
        },
        {
            "Name": "zset-max-ziplist-value",
            "Value": "64",
            "Description": "The threshold of biggest sorted set entries in order for the dataset to be compressed",
            "DataType": "integer",
            "AllowedValues": "0-",
            "MinimumEngineVersion": "6.2.4"
        }
    ]
}

Weitere Informationen finden Sie unter Konfigurieren von Engine-Parametern mithilfe von Parametergruppen im Benutzerhandbuch zu MemoryDB.

Das folgende Codebeispiel zeigt, wie describe-snapshots verwendet wird.

AWS CLI

So geben Sie eine Liste von Snapshots zurück

Der folgende Befehl „describe-snapshots`“ gibt eine Liste von Snapshots zurück.

aws memorydb describe-snapshots

Ausgabe:

{
"Snapshots": [
    {
        "Name": "my-cluster-snapshot",
        "Status": "available",
        "Source": "manual",
        "ARN": "arn:aws:memorydb:us-east-1:491658xxxxxx2:snapshot/my-cluster-snapshot",
        "ClusterConfiguration": {
            "Name": "my-cluster",
            "Description": " ",
            "NodeType": "db.r6g.large",
            "EngineVersion": "6.2",
            "MaintenanceWindow": "wed:03:00-wed:04:00",
            "Port": 6379,
            "ParameterGroupName": "default.memorydb-redis6",
            "SubnetGroupName": "my-sg",
            "VpcId": "vpc-862574fc",
            "SnapshotRetentionLimit": 0,
            "SnapshotWindow": "04:30-05:30",
            "NumShards": 2
        }
    }
}

Weitere Informationen finden Sie unter Snapshot und Wiederherstellung im Benutzerhandbuch zu MemoryDB.

Das folgende Codebeispiel zeigt, wie describe-subnet-groups verwendet wird.

AWS CLI

So geben Sie eine Liste von Subnetzgruppen zurück

Der folgende Befehl „describe-subnet-groups`“ gibt eine Liste von Subnetzgruppen zurück.

aws memorydb describe-subnet-groups

Output

{
    "SubnetGroups": [
        {
            "Name": "my-sg",
            "Description": "pat-sg",
            "VpcId": "vpc-86xxx4fc",
            "Subnets": [
                {
                    "Identifier": "subnet-faxx84a6",
                    "AvailabilityZone": {
                        "Name": "us-east-1b"
                    }
                },
                {
                    "Identifier": "subnet-56xxf61b",
                    "AvailabilityZone": {
                        "Name": "us-east-1a"
                    }
                }
            ],
            "ARN": "arn:aws:memorydb:us-east-1:49165xxxxxx:subnetgroup/my-sg"
        }
    ]
}

Weitere Informationen finden Sie unter Subnetze und Subnetzgruppen im Benutzerhandbuch zu MemoryDB.

Das folgende Codebeispiel zeigt, wie describe-users verwendet wird.

AWS CLI

So geben Sie eine Liste von Benutzern zurück

Der folgende Befehl „describe-users`“ gibt eine Liste von Benutzern zurück.

aws memorydb describe-users

Output

{
    "Users": [
        {
            "Name": "default",
            "Status": "active",
            "AccessString": "on ~* &* +@all",
            "ACLNames": [
                "open-access"
            ],
            "MinimumEngineVersion": "6.0",
            "Authentication": {
                "Type": "no-password"
            },
            "ARN": "arn:aws:memorydb:us-east-1:491658xxxxxx:user/default"
        },
        {
            "Name": "my-user",
            "Status": "active",
            "AccessString": "off ~objects:* ~items:* ~public:* resetchannels -@all",
            "ACLNames": [],
            "MinimumEngineVersion": "6.2",
            "Authentication": {
                "Type": "password",
                "PasswordCount": 2
            },
            "ARN": "arn:aws:memorydb:us-east-1:491658xxxxxx:user/my-user"
        }
    ]
}

Weitere Informationen finden Sie unter Authentifizieren von Benutzern mit Zugriffssteuerungslisten im Benutzerhandbuch zu MemoryDB.

  • Weitere Details zur API finden Sie unter DescribeUsers in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie failover-shard verwendet wird.

AWS CLI

So führen Sie ein Failover für einen Shard durch

Der folgende Befehl „failover-shard`“ führt ein Failover für einen Shard durch.

aws memorydb failover-shard \
    --cluster-name my-cluster --shard-name 0001

Ausgabe:

{
    "Cluster": {
        "Name": "my-cluster",
        "Status": "available",
        "NumberOfShards": 2,
        "ClusterEndpoint": {
            "Address": "clustercfg.my-cluster.xxxxxx.memorydb.us-east-1.amazonaws.com",
            "Port": 6379
        },
        "NodeType": "db.r6g.large",
        "EngineVersion": "6.2",
        "EnginePatchVersion": "6.2.6",
        "ParameterGroupName": "default.memorydb-redis6",
        "ParameterGroupStatus": "in-sync",
        "SecurityGroups": [
            {
                "SecurityGroupId": "sg-0a143xxxx45c9fae",
                "Status": "active"
            }
        ],
        "SubnetGroupName": "my-sg",
        "TLSEnabled": true,
        "ARN": "arn:aws:memorydb:us-east-1:491658xxxxxx:cluster/my-cluster",
        "SnapshotRetentionLimit": 0,
        "MaintenanceWindow": "wed:03:00-wed:04:00",
        "SnapshotWindow": "04:30-05:30",
        "AutoMinorVersionUpgrade": true
    }
}

Weitere Informationen finden Sie unter Minimieren von Ausfallzeiten mit MultiAZ im Benutzerhandbuch zu MemoryDB.

  • Weitere Details zur API finden Sie unter FailoverShard in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie list-allowed-node-type-updates verwendet wird.

AWS CLI

So geben Sie eine Liste der zulässigen Knotentypaktualisierungen zurück

Der folgende Befehl „list-allowed-node-type-updates“ gibt eine Liste der verfügbaren Knotentypaktualisierungen zurück.

aws memorydb list-allowed-node-type-updates

Ausgabe:

{
    "Cluster": {
        "Name": "my-cluster",
        "Status": "available",
        "NumberOfShards": 2,
        "ClusterEndpoint": {
            "Address": "clustercfg.my-cluster.xxxxxx.memorydb.us-east-1.amazonaws.com",
            "Port": 6379
        },
        "NodeType": "db.r6g.large",
        "EngineVersion": "6.2",
        "EnginePatchVersion": "6.2.6",
        "ParameterGroupName": "default.memorydb-redis6",
        "ParameterGroupStatus": "in-sync",
        "SecurityGroups": [
            {
                "SecurityGroupId": "sg-0a143xxxx45c9fae",
                "Status": "active"
            }
        ],
        "SubnetGroupName": "my-sg",
        "TLSEnabled": true,
        "ARN": "arn:aws:memorydb:us-east-1:491658xxxxxx:cluster/my-cluster",
        "SnapshotRetentionLimit": 0,
        "MaintenanceWindow": "wed:03:00-wed:04:00",
        "SnapshotWindow": "04:30-05:30",
        "AutoMinorVersionUpgrade": true
    }
}

Weitere Informationen finden Sie unter Skalierung im Benutzerhandbuch zu MemoryDB.

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

AWS CLI

So geben Sie eine Liste von Tags zurück

Der folgende Befehl „list-tags“ gibt eine Liste von Tags zurück.

aws memorydb list-tags \
    --resource-arn arn:aws:memorydb:us-east-1:491658xxxxxx:cluster/my-cluster

Ausgabe:

{
    "TagList": [
        {
            "Key": "mytag",
            "Value": "myvalue"
        }
    ]
}

Weitere Informationen finden Sie unter Markieren von Ressourcen im Benutzerhandbuch zu MemoryDB.

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

Das folgende Codebeispiel zeigt, wie reset-parameter-group verwendet wird.

AWS CLI

So setzen Sie eine Parametergruppe zurück

Der folgende Befehl „reset-parameter-group`“ setzt eine Parametergruppe zurück.

aws memorydb reset-parameter-group \
    --parameter-group-name my-parameter-group \
    --all-parameters

Ausgabe:

{
    "ParameterGroup": {
        "Name": "my-parameter-group",
        "Family": "memorydb_redis6",
        "Description": "my parameter group",
        "ARN": "arn:aws:memorydb:us-east-1:491658xxxxxx:parametergroup/my-parameter-group"
    }
}

Weitere Informationen finden Sie unter Konfigurieren von Engine-Parametern mithilfe von Parametergruppen im Benutzerhandbuch zu MemoryDB.

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

AWS CLI

So taggen Sie eine Ressource

Der folgende Befehl „tag-resource“ fügt einer Ressource ein Tag hinzu.

aws memorydb tag-resource \
    --resource-arn arn:aws:memorydb:us-east-1:491658xxxxxx:cluster/my-cluster \
    --tags Key="mykey",Value="myvalue"

Ausgabe:

{
    "TagList": [
        {
            "Key": "mytag",
            "Value": "myvalue"
        },
        {
            "Key": "mykey",
            "Value": "myvalue"
        }
    ]
}

Weitere Informationen finden Sie unter Markieren von Ressourcen im Benutzerhandbuch zu MemoryDB.

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

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

AWS CLI

So aktualisieren Sie eine ACL

Der folgende Befehl „update-acl`“ aktualisiert eine ACL, indem ein Benutzer hinzugefügt wird.

aws memorydb untag-resource \
    --resource-arn arn:aws:memorydb:us-east-1:491658xxxxx:cluster/my-cluster \
    --tag-keys mykey

Ausgabe:

{
    "TagList": [
        {
            "Key": "mytag",
            "Value": "myvalue"
        }
    ]
}

Weitere Informationen finden Sie unter Markieren von Ressourcen im Benutzerhandbuch zu MemoryDB.

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

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

AWS CLI

So aktualisieren Sie einen Cluster

Der folgende Befehl „update-cluster`“ aktualisiert die Parametergruppe eines Clusters in „my-parameter-group“.

aws memorydb update-cluster \
    --cluster-name my-cluster \
    --parameter-group-name my-parameter-group

Ausgabe:

{
    "Cluster": {
        "Name": "my-cluster",
        "Status": "available",
        "NumberOfShards": 2,
        "AvailabilityMode": "MultiAZ",
        "ClusterEndpoint": {
            "Address": "clustercfg.my-cluster.llru6f.memorydb.us-east-1.amazonaws.com",
            "Port": 6379
        },
        "NodeType": "db.r6g.large",
        "EngineVersion": "6.2",
        "EnginePatchVersion": "6.2.6",
        "ParameterGroupName": "my-parameter-group",
        "ParameterGroupStatus": "in-sync",
        "SecurityGroups": [
            {
                "SecurityGroupId": "sg-0a143xxxxxc9fae",
                "Status": "active"
            }
        ],
        "SubnetGroupName": "pat-sg",
        "TLSEnabled": true,
        "ARN": "arn:aws:memorydb:us-east-1:491658xxxxxx:cluster/my-cluster",
        "SnapshotRetentionLimit": 0,
        "MaintenanceWindow": "wed:03:00-wed:04:00",
        "SnapshotWindow": "04:30-05:30",
        "ACLName": "my-acl",
        "AutoMinorVersionUpgrade": true
    }
}

Weitere Informationen finden Sie unter Modifizieren eines Clusters im Benutzerhandbuch zu MemoryDB.

  • Weitere Details zur API finden Sie unter UpdateCluster in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie update-parameter-group verwendet wird.

AWS CLI

So erstellen Sie eine Parametergruppe

Der folgende Befehl „update-parameter-group`“ aktualisiert eine Parametergruppe.

aws memorydb update-parameter-group \
    --parameter-group-name my-parameter-group \
    --parameter-name-values "ParameterName=activedefrag, ParameterValue=no"

Ausgabe:

{
    "ParameterGroup": {
        "Name": "my-parameter-group",
        "Family": "memorydb_redis6",
        "Description": "my parameter group",
        "ARN": "arn:aws:memorydb:us-east-1:49165xxxxxx:parametergroup/my-parameter-group"
    }
}

Weitere Informationen finden Sie unter Modifizieren einer Parametergruppe im Benutzerhandbuch zu MemoryDB.

Das folgende Codebeispiel zeigt, wie update-subnet-group verwendet wird.

AWS CLI

So aktualisieren Sie eine Subnetzgruppe

Der folgende Befehl „update-subnet-group`“ aktualisiert die Subnetz-ID einer Subnetzgruppe.

aws memorydb update-subnet-group \
    --subnet-group-name my-sg \
    --subnet-ids subnet-01f29d458f3xxxxx

Ausgabe:

{
    "SubnetGroup": {
        "Name": "my-sg-1",
        "Description": "my-sg",
        "VpcId": "vpc-09d2cfc01xxxxxxx",
        "Subnets": [
            {
                "Identifier": "subnet-01f29d458fxxxxxx",
                "AvailabilityZone": {
                    "Name": "us-east-1a"
                }
            }
        ],
        "ARN": "arn:aws:memorydb:us-east-1:491658xxxxxx:subnetgroup/my-sg"
    }
}

Weitere Informationen finden Sie unter Subnetze und Subnetzgruppen im Benutzerhandbuch zu MemoryDB.

  • Weitere Details zur API finden Sie unter UpdateSubnetGroup in der AWS CLI-Befehlsreferenz.

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

AWS CLI

So aktualisieren Sie einen Benutzer

Im folgenden Beispiel für update-user wird die Zugriffszeichenfolge eines Benutzers geändert.

aws memorydb update-user \
    --user-name my-user \
    --access-string "off ~objects:* ~items:* ~public:* resetchannels -@all"

Ausgabe:

{
    "User": {
        "Name": "my-user",
        "Status": "modifying",
        "AccessString": "off ~objects:* ~items:* ~public:* resetchannels -@all",
        "ACLNames": [
            "myt-acl"
        ],
        "MinimumEngineVersion": "6.2",
        "Authentication": {
            "Type": "password",
            "PasswordCount": 2
        },
        "ARN": "arn:aws:memorydb:us-east-1:491658xxxxxx:user/my-user"
    }
}

Weitere Informationen finden Sie unter Authentifizieren von Benutzern mit Zugriffssteuerungslisten im Benutzerhandbuch zu MemoryDB.

  • Weitere Details zur API finden Sie unter UpdateUser in der AWS CLI-Befehlsreferenz.