메모리DB 예제 사용 AWS CLI

다음 코드 예제는 with MemoryDB를 사용하여 작업을 수행하고 일반적인 시나리오를 구현하는 방법을 보여줍니다. AWS Command Line Interface

작업은 대규모 프로그램에서 발췌한 코드이며 컨텍스트에 맞춰 실행해야 합니다. 작업은 개별 서비스 함수를 직접적으로 호출하는 방법을 보여주며 관련 시나리오의 컨텍스트에 맞는 작업을 볼 수 있습니다.

각 예제에는 전체 소스 코드에 대한 링크가 포함되어 있으며, 여기에서 상황에 맞게 코드를 설정하고 실행하는 방법에 대한 지침을 찾을 수 있습니다.

작업

copy-snapshot

다음 코드 예시에서는 copy-snapshot을 사용하는 방법을 보여 줍니다.

AWS CLI

스냅샷을 복사하려면

다음 copy-snapshot 예제에서는 스냅샷의 사본을 만듭니다.

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

출력

{
    "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
        }
    }
}

자세한 내용은 MemoryDB 사용 설명서의 스냅샷 복사를 참조하십시오.

• 자세한 API 내용은 AWS CLI 명령 CopySnapshot참조를 참조하십시오.

create-acl

다음 코드 예시에서는 create-acl을 사용하는 방법을 보여 줍니다.

AWS CLI

생성하려면 ACL

다음 create-acl 예제에서는 새 액세스 제어 목록을 만듭니다.

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

출력:

{
    "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"
    }
}

자세한 내용은 MemoryDB 사용 설명서의 액세스 제어 목록을 사용한 사용자 인증을 참조하십시오.

• 자세한 API 내용은 명령 CreateAcl참조를 참조하십시오.AWS CLI

create-cluster

다음 코드 예시에서는 create-cluster을 사용하는 방법을 보여 줍니다.

AWS CLI

클러스터를 만들려면

다음 create-cluster 예제에서는 새 클러스터를 생성합니다.

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

출력:

{
    "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
    }
}

자세한 내용은 MemoryDB 사용 설명서의 클러스터 관리를 참조하십시오.

• 자세한 API 내용은 AWS CLI 명령 CreateCluster참조를 참조하십시오.

create-parameter-group

다음 코드 예시에서는 create-parameter-group을 사용하는 방법을 보여 줍니다.

AWS CLI

파라미터 그룹을 만들려면

다음 create-parameter-group 예제에서는 파라미터 그룹을 생성합니다.

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

출력:

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

자세한 내용은 MemoryDB 사용 설명서의 파라미터 그룹 생성을 참조하십시오.

• 자세한 API 내용은 AWS CLI 명령 CreateParameterGroup참조를 참조하십시오.

create-snapshot

다음 코드 예시에서는 create-snapshot을 사용하는 방법을 보여 줍니다.

AWS CLI

스냅샷을 만들려면

다음 create-snapshot 예제에서는 스냅샷을 생성합니다.

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

출력:

{
    "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
        }
    }
}

자세한 내용은 MemoryDB 사용 설명서의 수동 스냅샷 만들기를 참조하십시오.

• 자세한 API 내용은 명령 CreateSnapshot참조를 참조하십시오.AWS CLI

create-subnet-group

다음 코드 예시에서는 create-subnet-group을 사용하는 방법을 보여 줍니다.

AWS CLI

서브넷 그룹을 만들려면

다음 create-subnet-group 예에서는 서브넷 그룹을 생성합니다.

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

출력:

{
    "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"
    }
}

자세한 내용은 MemoryDB 사용 설명서의 서브넷 그룹 생성을 참조하십시오.

• 자세한 API 내용은 명령 CreateSubnetGroup참조를 참조하십시오.AWS CLI

create-user

다음 코드 예시에서는 create-user을 사용하는 방법을 보여 줍니다.

AWS CLI

사용자 생성하기

다음 create-user 예제에서는 새 사용자를 생성합니다.

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

출력:

{
    "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"
    }
}

자세한 내용은 MemoryDB 사용 설명서의 액세스 제어 목록을 사용한 사용자 인증을 참조하십시오.

• 자세한 API 내용은 명령 CreateUser참조를 참조하십시오.AWS CLI

delete-acl

다음 코드 예시에서는 delete-acl을 사용하는 방법을 보여 줍니다.

AWS CLI

삭제하려면 ACL

다음 delete-acl 예제에서는 액세스 제어 목록을 삭제합니다.

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

출력:

{
    "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"
    }
}

자세한 내용은 MemoryDB 사용 설명서의 액세스 제어 목록을 사용하여 사용자 인증을 참조하십시오.

• 자세한 API 내용은 명령 DeleteAcl참조를 참조하십시오.AWS CLI

delete-cluster

다음 코드 예시에서는 delete-cluster을 사용하는 방법을 보여 줍니다.

AWS CLI

클러스터를 삭제하려면

다음 delete-cluster 예제는 클러스터를 삭제합니다.

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

출력:

{
    "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
    }
}

자세한 내용은 MemoryDB 사용 설명서의 클러스터 삭제를 참조하십시오.

• 자세한 API 내용은 AWS CLI 명령 DeleteCluster참조를 참조하십시오.

delete-parameter-group

다음 코드 예시에서는 delete-parameter-group을 사용하는 방법을 보여 줍니다.

AWS CLI

파라미터 그룹을 삭제하려면

다음 delete-parameter-group 예제에서는 파라미터 그룹을 삭제합니다.

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

출력:

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

자세한 내용은 MemoryDB 사용 설명서의 파라미터 그룹 삭제를 참조하십시오.

• 자세한 API 내용은 AWS CLI 명령 DeleteParameterGroup참조를 참조하십시오.

delete-snapshot

다음 코드 예시에서는 delete-snapshot을 사용하는 방법을 보여 줍니다.

AWS CLI

스냅샷을 삭제하는 방법

다음 delete-snapshot 예제는 스냅샷을 삭제합니다.

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

출력:

{
    "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
        }
    }
}

자세한 내용은 MemoryDB 사용 설명서의 스냅샷 삭제를 참조하십시오.

• 자세한 API 내용은 AWS CLI 명령 DeleteSnapshot참조를 참조하십시오.

delete-subnet-group

다음 코드 예시에서는 delete-subnet-group을 사용하는 방법을 보여 줍니다.

AWS CLI

서브넷 그룹을 삭제하려면

다음 delete-subnet-group 예에서는 서브넷을 삭제합니다.

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

출력:

{
    "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"
    }
}

자세한 내용은 MemoryDB 사용 설명서의 서브넷 그룹 삭제를 참조하십시오.

• 자세한 API 내용은 명령 DeleteSubnetGroup참조를 참조하십시오.AWS CLI

delete-user

다음 코드 예시에서는 delete-user을 사용하는 방법을 보여 줍니다.

AWS CLI

사용자 삭제

다음 delete-user 예제는 사용자를 삭제합니다.

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

출력:

{
    "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"
    }
}

자세한 내용은 MemoryDB 사용 설명서의 액세스 제어 목록을 사용한 사용자 인증을 참조하십시오.

• 자세한 API 내용은 명령 DeleteUser참조를 참조하십시오.AWS CLI

describe-acls

다음 코드 예시에서는 describe-acls을 사용하는 방법을 보여 줍니다.

AWS CLI

목록을 반환하려면 ACLs

다음 설명-acls'는 목록을 반환합니다. ACLs

aws memorydb describe-acls

출력:

{
    "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"
        }
    ]
}

자세한 내용은 MemoryDB 사용 설명서의 액세스 제어 목록을 통한 사용자 인증을 참조하십시오.

• 자세한 API 내용은 명령 DescribeAcls참조를 참조하십시오.AWS CLI

describe-clusters

다음 코드 예시에서는 describe-clusters을 사용하는 방법을 보여 줍니다.

AWS CLI

클러스터 목록을 반환하려면

다음 설명 클러스터'는 클러스터 목록을 반환합니다.

aws memorydb describe-clusters

출력:

{
    "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
        }
    ]
}

자세한 내용은 MemoryDB 사용 설명서의 클러스터 관리를 참조하십시오.

• 자세한 API 내용은 AWS CLI 명령 DescribeClusters참조를 참조하십시오.

describe-engine-versions

다음 코드 예시에서는 describe-engine-versions을 사용하는 방법을 보여 줍니다.

AWS CLI

엔진 버전 목록을 반환하려면

describe-engine-versions다음`은 엔진 버전 목록을 반환합니다.

aws memorydb describe-engine-versions

출력:

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

자세한 내용은 MemoryDB 사용 설명서의 엔진 버전 및 업그레이드를 참조하십시오.

• 자세한 API 내용은 AWS CLI 명령 DescribeEngineVersions참조를 참조하십시오.

describe-events

다음 코드 예시에서는 describe-events을 사용하는 방법을 보여 줍니다.

AWS CLI

이벤트 목록을 반환하려면

다음 설명 이벤트'는 이벤트 목록을 반환합니다.

aws memorydb describe-events

출력:

{
    "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"
        }
    ]
}

자세한 내용은 MemoryDB 사용 설명서의 이벤트 모니터링을 참조하십시오.

• 자세한 API 내용은 AWS CLI 명령 DescribeEvents참조를 참조하십시오.

describe-parameter-groups

다음 코드 예시에서는 describe-parameter-groups을 사용하는 방법을 보여 줍니다.

AWS CLI

파라미터 그룹 목록을 반환하려면

describe-parameter-groups다음`은 파라미터 그룹 목록을 반환합니다.

aws memorydb describe-parameter-groups

출력:

{
    "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"
        }
    ]
}

자세한 내용은 MemoryDB 사용 설명서의 파라미터 그룹을 사용하여 엔진 파라미터 구성을 참조하십시오.

• 자세한 API 내용은 AWS CLI 명령 DescribeParameterGroups참조를 참조하십시오.

describe-parameters

다음 코드 예시에서는 describe-parameters을 사용하는 방법을 보여 줍니다.

AWS CLI

파라미터 목록을 반환하려면

다음 설명 매개변수'는 매개변수 목록을 반환합니다.

aws memorydb describe-parameters

출력:

{
    "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"
        }
    ]
}

자세한 내용은 MemoryDB 사용 설명서의 파라미터 그룹을 사용하여 엔진 파라미터 구성을 참조하십시오.

• 자세한 API 내용은 AWS CLI 명령 DescribeParameters참조를 참조하십시오.

describe-snapshots

다음 코드 예시에서는 describe-snapshots을 사용하는 방법을 보여 줍니다.

AWS CLI

스냅샷 목록을 반환하려면

다음 설명 스냅샷'은 스냅샷 목록을 반환합니다.

aws memorydb describe-snapshots

출력:

{
"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
        }
    }
}

자세한 내용은 MemoryDB 사용 설명서의 스냅샷 및 복원을 참조하십시오.

• 자세한 API 내용은 AWS CLI 명령 DescribeSnapshots참조를 참조하십시오.

describe-subnet-groups

다음 코드 예시에서는 describe-subnet-groups을 사용하는 방법을 보여 줍니다.

AWS CLI

서브넷 그룹 목록을 반환하려면

describe-subnet-groups다음`은 서브넷 그룹 목록을 반환합니다.

aws memorydb describe-subnet-groups

출력

{
    "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"
        }
    ]
}

자세한 내용은 MemoryDB 사용 설명서의 서브넷 및 서브넷 그룹을 참조하십시오.

• API자세한 내용은 명령 참조를 참조하십시오 DescribeSubnetGroups.AWS CLI

describe-users

다음 코드 예시에서는 describe-users을 사용하는 방법을 보여 줍니다.

AWS CLI

사용자 목록을 반환하려면

다음 설명-사용자'는 사용자 목록을 반환합니다.

aws memorydb describe-users

출력

{
    "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"
        }
    ]
}

자세한 내용은 MemoryDB 사용 설명서의 액세스 제어 목록을 통한 사용자 인증을 참조하십시오.

• 자세한 API 내용은 명령 DescribeUsers참조를 참조하십시오.AWS CLI

failover-shard

다음 코드 예시에서는 failover-shard을 사용하는 방법을 보여 줍니다.

AWS CLI

샤드를 페일오버하려면

다음 페일오버 샤드'는 샤드를 페일오버합니다.

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

출력:

{
    "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
    }
}

자세한 내용은 MemoryDB 사용 설명서의 MultiAZ를 사용한 가동 중지 시간 최소화를 참조하십시오.

• API자세한 내용은 명령 참조를 참조하십시오. FailoverShardAWS CLI

list-allowed-node-type-updates

다음 코드 예시에서는 list-allowed-node-type-updates을 사용하는 방법을 보여 줍니다.

AWS CLI

허용된 노드 유형 업데이트 목록을 반환하려면

다음 list-allowed-node-type -update는 사용 가능한 노드 유형 업데이트 목록을 반환합니다.

aws memorydb list-allowed-node-type-updates

출력:

{
    "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
    }
}

자세한 내용은 MemoryDB 사용 설명서의 크기 조정을 참조하십시오.

• 자세한 API 내용은 AWS CLI 명령 ListAllowedNodeTypeUpdates참조를 참조하십시오.

list-tags

다음 코드 예시에서는 list-tags을 사용하는 방법을 보여 줍니다.

AWS CLI

태그 목록을 반환하려면

다음 목록 태그는 태그 목록을 반환합니다.

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

출력:

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

자세한 내용은 MemoryDB 사용 설명서의 리소스 태깅을 참조하십시오.

• 자세한 API 내용은 명령 ListTags참조를 참조하십시오.AWS CLI

reset-parameter-group

다음 코드 예시에서는 reset-parameter-group을 사용하는 방법을 보여 줍니다.

AWS CLI

파라미터 그룹을 재설정하려면

다음 reset-parameter-group `은 파라미터 그룹을 재설정합니다.

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

출력:

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

자세한 내용은 MemoryDB 사용 설명서의 파라미터 그룹을 사용하여 엔진 파라미터 구성을 참조하십시오.

• 자세한 API 내용은 AWS CLI 명령 ResetParameterGroup참조를 참조하십시오.

tag-resource

다음 코드 예시에서는 tag-resource을 사용하는 방법을 보여 줍니다.

AWS CLI

리소스에 태그를 지정하려면

다음 태그-리소스'는 리소스에 태그를 추가합니다.

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

출력:

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

자세한 내용은 MemoryDB 사용 설명서의 리소스 태깅을 참조하십시오.

• 자세한 API 내용은 명령 TagResource참조를 참조하십시오.AWS CLI

untag-resource

다음 코드 예시에서는 untag-resource을 사용하는 방법을 보여 줍니다.

AWS CLI

업데이트하려면 ACL

다음 업데이트는 사용자를 추가하여 a를 업데이트합니다. ACL

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

출력:

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

자세한 내용은 MemoryDB 사용 설명서의 리소스 태깅을 참조하십시오.

• 자세한 API 내용은 명령 UntagResource참조를 참조하십시오.AWS CLI

update-cluster

다음 코드 예시에서는 update-cluster을 사용하는 방법을 보여 줍니다.

AWS CLI

클러스터를 업데이트하려면

다음 업데이트 클러스터``는 클러스터의 파라미터 그룹을 로 업데이트합니다. my-parameter-group

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

출력:

{
    "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
    }
}

자세한 내용은 MemoryDB 사용 설명서의 클러스터 수정을 참조하십시오.

• 자세한 API 내용은 명령 UpdateCluster참조를 참조하십시오.AWS CLI

update-parameter-group

다음 코드 예시에서는 update-parameter-group을 사용하는 방법을 보여 줍니다.

AWS CLI

파라미터 그룹을 업데이트하려면

다음 update-parameter-group ``는 파라미터 그룹을 업데이트합니다.

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

출력:

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

자세한 내용은 MemoryDB 사용 설명서의 파라미터 그룹 수정을 참조하십시오.

• 자세한 API 내용은 명령 UpdateParameterGroup참조를 참조하십시오.AWS CLI

update-subnet-group

다음 코드 예시에서는 update-subnet-group을 사용하는 방법을 보여 줍니다.

AWS CLI

서브넷 그룹을 업데이트하려면

update-subnet-group다음`은 서브넷 그룹의 서브넷 ID를 업데이트합니다.

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

출력:

{
    "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"
    }
}

자세한 내용은 MemoryDB 사용 설명서의 서브넷 및 서브넷 그룹을 참조하십시오.

• API자세한 내용은 명령 참조를 참조하십시오 UpdateSubnetGroup.AWS CLI

update-user

다음 코드 예시에서는 update-user을 사용하는 방법을 보여 줍니다.

AWS CLI

사용자를 업데이트하려면

다음은 사용자의 액세스 문자열을 update-user 수정합니다.

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

출력:

{
    "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"
    }
}

자세한 내용은 MemoryDB 사용 설명서의 액세스 제어 목록을 통한 사용자 인증을 참조하십시오.

• 자세한 API 내용은 명령 UpdateUser참조를 참조하십시오.AWS CLI