Doc AWS SDK 예제 GitHub 리포지토리에서 더 많은 SDK 예제를 사용할 수 있습니다. [AWS](https://github.com/awsdocs/aws-doc-sdk-examples)
기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# 를 사용한 Amazon Redshift 예제 AWS CLI
다음 코드 예제에서는 AWS Command Line Interface Amazon Redshift에서를 사용하여 작업을 수행하고 일반적인 시나리오를 구현하는 방법을 보여줍니다.
*작업*은 대규모 프로그램에서 발췌한 코드이며 컨텍스트에 맞춰 실행해야 합니다. 작업은 개별 서비스 함수를 직접적으로 호출하는 방법을 보여주며 관련 시나리오의 컨텍스트에 맞는 작업을 볼 수 있습니다.
각 예시에는 전체 소스 코드에 대한 링크가 포함되어 있으며, 여기에서 컨텍스트에 맞춰 코드를 설정하고 실행하는 방법에 대한 지침을 찾을 수 있습니다.
**Topics**
+ [작업](#actions)
## 작업
### `accept-reserved-node-exchange`
다음 코드 예시에서는 `accept-reserved-node-exchange`의 사용 방법을 보여줍니다.
**AWS CLI**
**예약 노드 교환 수락**
다음 `accept-reserved-node-exchange` 예시에서는 DC1 예약 노드를 DC2 예약 노드로 교환하는 것을 수락합니다.
```
aws redshift accept-reserved-node-exchange /
--reserved-node-id 12345678-12ab-12a1-1a2a-12ab-12a12EXAMPLE /
--target-reserved-node-offering-id 12345678-12ab-12a1-1a2a-12ab-12a12EXAMPLE
```
출력:
```
{
"ExchangedReservedNode": {
"ReservedNodeId": "12345678-12ab-12a1-1a2a-12ab-12a12EXAMPLE",
"ReservedNodeOfferingId": "12345678-12ab-12a1-1a2a-12ab-12a12EXAMPLE",
"NodeType": "dc2.large",
"StartTime": "2019-12-06T21:17:26Z",
"Duration": 31536000,
"FixedPrice": 0.0,
"UsagePrice": 0.0,
"CurrencyCode": "USD",
"NodeCount": 1,
"State": "exchanging",
"OfferingType": "All Upfront",
"RecurringCharges": [
{
"RecurringChargeAmount": 0.0,
"RecurringChargeFrequency": "Hourly"
}
],
"ReservedNodeOfferingType": "Regular"
}
}
```
자세한 내용은 *Amazon Redshift 클러스터 관리 안내서*[의 AWS CLI를 사용하여 예약 노드 업그레이드를](https://docs.aws.amazon.com/redshift/latest/mgmt/purchase-reserved-node-offering-console.html) 참조하세요.
+ API 세부 정보는 *AWS CLI 명령 참조*의 [AcceptReservedNodeExchange](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/accept-reserved-node-exchange.html)를 참조하세요.
### `authorize-cluster-security-group-ingress`
다음 코드 예시에서는 `authorize-cluster-security-group-ingress`의 사용 방법을 보여줍니다.
**AWS CLI**
EC2 보안 그룹에 대한 액세스 권한 부여 이 예시에서는 명명된 Amazon EC2 보안 그룹에 대한 액세스 권한을 부여합니다. 명령:
```
aws redshift authorize-cluster-security-group-ingress --cluster-security-group-name mysecuritygroup --ec2-security-group-name myec2securitygroup --ec2-security-group-owner-id 123445677890
```
CIDR 범위에 대한 액세스 권한 부여 이 예시에서는 CIDR 범위에 대한 액세스 권한을 부여합니다. 명령:
```
aws redshift authorize-cluster-security-group-ingress --cluster-security-group-name mysecuritygroup --cidrip 192.168.100.100/32
```
+ API 세부 정보는 *AWS CLI 명령 참조*의 [AuthorizeClusterSecurityGroupIngress](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/authorize-cluster-security-group-ingress.html)를 참조하세요.
### `authorize-snapshot-access`
다음 코드 예시는 `authorize-snapshot-access`의 사용 방법을 보여 줍니다.
**AWS CLI**
스냅샷을 복원할 수 있는 AWS 권한 부여SnapshotThis 예제에서는 AWS 계정에 스냅샷을 복원`444455556666`할 수 있는 권한을 부여합니다`my-snapshot-id`. 기본 출력 형식은 JSON입니다. 명령:
```
aws redshift authorize-snapshot-access --snapshot-id my-snapshot-id --account-with-restore-access 444455556666
```
결과:
```
{
"Snapshot": {
"Status": "available",
"SnapshotCreateTime": "2013-07-17T22:04:18.947Z",
"EstimatedSecondsToCompletion": 0,
"AvailabilityZone": "us-east-1a",
"ClusterVersion": "1.0",
"MasterUsername": "adminuser",
"Encrypted": false,
"OwnerAccount": "111122223333",
"BackupProgressInMegabytes": 11.0,
"ElapsedTimeInSeconds": 0,
"DBName": "dev",
"CurrentBackupRateInMegabytesPerSecond: 0.1534,
"ClusterCreateTime": "2013-01-22T21:59:29.559Z",
"ActualIncrementalBackupSizeInMegabytes"; 11.0,
"SnapshotType": "manual",
"NodeType": "dw.hs1.xlarge",
"ClusterIdentifier": "mycluster",
"TotalBackupSizeInMegabytes": 20.0,
"Port": 5439,
"NumberOfNodes": 2,
"SnapshotIdentifier": "my-snapshot-id"
}
}
```
+ API 세부 정보는 *AWS CLI 명령 참조*의 [AuthorizeSnapshotAccess](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/authorize-snapshot-access.html)를 참조하세요.
### `batch-delete-cluster-snapshots`
다음 코드 예시에서는 `batch-delete-cluster-snapshots`의 사용 방법을 보여줍니다.
**AWS CLI**
**클러스터 스냅샷 세트 삭제**
다음 `batch-delete-cluster-snapshots` 예시에서는 수동 클러스터 스냅샷 세트를 삭제합니다.
```
aws redshift batch-delete-cluster-snapshots \
--identifiers SnapshotIdentifier=mycluster-2019-11-06-14-12 SnapshotIdentifier=mycluster-2019-11-06-14-20
```
출력:
```
{
"Resources": [
"mycluster-2019-11-06-14-12",
"mycluster-2019-11-06-14-20"
]
}
```
자세한 내용은 *Amazon Redshift 클러스터 관리 안내서*의 [Amazon Redshift 스냅샷](https://docs.aws.amazon.com/redshift/latest/mgmt/working-with-snapshots.html)을 참조하세요.
+ API 세부 정보는 *AWS CLI 명령 참조*의 [BatchDeleteClusterSnapshots](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/batch-delete-cluster-snapshots.html)를 참조하세요.
### `batch-modify-cluster-snapshots`
다음 코드 예시에서는 `batch-modify-cluster-snapshots`의 사용 방법을 보여줍니다.
**AWS CLI**
**클러스터 스냅샷 세트 수정**
다음 `batch-modify-cluster-snapshots` 예시에서는 클러스터 스냅샷 세트의 설정을 수정합니다.
```
aws redshift batch-modify-cluster-snapshots \
--snapshot-identifier-list mycluster-2019-11-06-16-31 mycluster-2019-11-06-16-32 \
--manual-snapshot-retention-period 30
```
출력:
```
{
"Resources": [
"mycluster-2019-11-06-16-31",
"mycluster-2019-11-06-16-32"
],
"Errors": [],
"ResponseMetadata": {
"RequestId": "12345678-12ab-12a1-1a2a-12ab-12a12EXAMPLE",
"HTTPStatusCode": 200,
"HTTPHeaders": {
"x-amzn-requestid": "12345678-12ab-12a1-1a2a-12ab-12a12EXAMPLE,
"content-type": "text/xml",
"content-length": "480",
"date": "Sat, 07 Dec 2019 00:36:09 GMT",
"connection": "keep-alive"
},
"RetryAttempts": 0
}
}
```
자세한 내용은 *Amazon Redshift 클러스터 관리 안내서*의 [Amazon Redshift 스냅샷](https://docs.aws.amazon.com/redshift/latest/mgmt/working-with-snapshots.html)을 참조하세요.
+ API 세부 정보는 *AWS CLI 명령 참조*의 [BatchModifyClusterSnapshots](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/batch-modify-cluster-snapshots.html)를 참조하세요.
### `cancel-resize`
다음 코드 예시에서는 `cancel-resize`의 사용 방법을 보여줍니다.
**AWS CLI**
**클러스터 크기 조정 취소**
다음 `cancel-resize` 예시에서는 클러스터에 대한 기존 크기 조정 작업을 취소합니다.
```
aws redshift cancel-resize \
--cluster-identifier mycluster
```
출력:
```
{
"TargetNodeType": "dc2.large",
"TargetNumberOfNodes": 2,
"TargetClusterType": "multi-node",
"Status": "CANCELLING",
"ResizeType": "ClassicResize",
"TargetEncryptionType": "NONE"
}
```
자세한 내용은 *Amazon Redshift 클러스터 관리 안내서*의 [Amazon Redshift에서 클러스터 크기 조정](https://docs.aws.amazon.com/redshift/latest/mgmt/rs-resize-tutorial.html)을 참조하세요.
+ API 세부 정보는 *AWS CLI 명령 참조*의 [CancelResize](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/cancel-resize.html)를 참조하세요.
### `copy-cluster-snapshot`
다음 코드 예시에서는 `copy-cluster-snapshot`의 사용 방법을 보여줍니다.
**AWS CLI**
모든 클러스터 버전에 대한 설명 가져오기 이 예시에서는 모든 클러스터 버전에 대한 설명을 반환합니다. 기본 출력 형식은 JSON입니다. 명령:
```
aws redshift copy-cluster-snapshot --source-snapshot-identifier cm:examplecluster-2013-01-22-19-27-58 --target-snapshot-identifier my-saved-snapshot-copy
```
결과:
```
{
"Snapshot": {
"Status": "available",
"SnapshotCreateTime": "2013-01-22T19:27:58.931Z",
"AvailabilityZone": "us-east-1c",
"ClusterVersion": "1.0",
"MasterUsername": "adminuser",
"DBName": "dev",
"ClusterCreateTime": "2013-01-22T19:23:59.368Z",
"SnapshotType": "manual",
"NodeType": "dw.hs1.xlarge",
"ClusterIdentifier": "examplecluster",
"Port": 5439,
"NumberOfNodes": "2",
"SnapshotIdentifier": "my-saved-snapshot-copy"
},
"ResponseMetadata": {
"RequestId": "3b279691-64e3-11e2-bec0-17624ad140dd"
}
}
```
+ API 세부 정보는 *AWS CLI 명령 참조*의 [CopyClusterSnapshot](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/copy-cluster-snapshot.html)을 참조하세요.
### `create-cluster-parameter-group`
다음 코드 예시에서는 `create-cluster-parameter-group`의 사용 방법을 보여줍니다.
**AWS CLI**
클러스터 파라미터 그룹 생성 이 예시에서는 새 클러스터 파라미터 그룹을 생성합니다. 명령:
```
aws redshift create-cluster-parameter-group --parameter-group-name myclusterparametergroup --parameter-group-family redshift-1.0 --description "My first cluster parameter group"
```
결과:
```
{
"ClusterParameterGroup": {
"ParameterGroupFamily": "redshift-1.0",
"Description": "My first cluster parameter group",
"ParameterGroupName": "myclusterparametergroup"
},
"ResponseMetadata": {
"RequestId": "739448f0-64cc-11e2-8f7d-3b939af52818"
}
}
```
+ API 세부 정보는 *AWS CLI 명령 참조*의 [CreateClusterParameterGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/create-cluster-parameter-group.html)을 참조하세요.
### `create-cluster-security-group`
다음 코드 예시에서는 `create-cluster-security-group`의 사용 방법을 보여줍니다.
**AWS CLI**
클러스터 보안 그룹 생성 이 예시에서는 새 클러스터 보안 그룹을 생성합니다. 기본 출력 형식은 JSON입니다. 명령:
```
aws redshift create-cluster-security-group --cluster-security-group-name mysecuritygroup --description "This is my cluster security group"
```
결과:
```
{
"create_cluster_security_group_response": {
"create_cluster_security_group_result": {
"cluster_security_group": {
"description": "This is my cluster security group",
"owner_id": "300454760768",
"cluster_security_group_name": "mysecuritygroup",
"ec2_security_groups": \[],
"ip_ranges": \[]
}
},
"response_metadata": {
"request_id": "5df486a0-343a-11e2-b0d8-d15d0ef48549"
}
}
}
```
`--output text` 옵션을 사용하여 텍스트 형식으로 동일한 정보를 얻을 수도 있습니다. 명령:
`--output text` 옵션. 명령:
옵션. 명령:
```
aws redshift create-cluster-security-group --cluster-security-group-name mysecuritygroup --description "This is my cluster security group" --output text
```
결과:
```
This is my cluster security group 300454760768 mysecuritygroup
a0c0bfab-343a-11e2-95d2-c3dc9fe8ab57
```
+ API 세부 정보는 *AWS CLI 명령 참조*의 [CreateClusterSecurityGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/create-cluster-security-group.html)을 참조하세요.
### `create-cluster-snapshot`
다음 코드 예시에서는 `create-cluster-snapshot`의 사용 방법을 보여줍니다.
**AWS CLI**
클러스터 스냅샷 생성 이 예시에서는 새 클러스터 스냅샷을 생성합니다. 기본 출력 형식은 JSON입니다. 명령:
```
aws redshift create-cluster-snapshot --cluster-identifier mycluster --snapshot-identifier my-snapshot-id
```
결과:
```
{
"Snapshot": {
"Status": "creating",
"SnapshotCreateTime": "2013-01-22T22:20:33.548Z",
"AvailabilityZone": "us-east-1a",
"ClusterVersion": "1.0",
"MasterUsername": "adminuser",
"DBName": "dev",
"ClusterCreateTime": "2013-01-22T21:59:29.559Z",
"SnapshotType": "manual",
"NodeType": "dw.hs1.xlarge",
"ClusterIdentifier": "mycluster",
"Port": 5439,
"NumberOfNodes": "2",
"SnapshotIdentifier": "my-snapshot-id"
},
"ResponseMetadata": {
"RequestId": "f024d1a5-64e1-11e2-88c5-53eb05787dfb"
}
}
```
+ API 세부 정보는 *AWS CLI 명령 참조*의 [CreateClusterSnapshot](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/create-cluster-snapshot.html)을 참조하세요.
### `create-cluster-subnet-group`
다음 코드 예시에서는 `create-cluster-subnet-group`의 사용 방법을 보여줍니다.
**AWS CLI**
클러스터 서브넷 그룹 생성 이 예시에서는 새 클러스터 서브넷 그룹을 생성합니다. 명령:
```
aws redshift create-cluster-subnet-group --cluster-subnet-group-name mysubnetgroup --description "My subnet group" --subnet-ids subnet-763fdd1c
```
결과:
```
{
"ClusterSubnetGroup": {
"Subnets": [
{
"SubnetStatus": "Active",
"SubnetIdentifier": "subnet-763fdd1c",
"SubnetAvailabilityZone": {
"Name": "us-east-1a"
}
} ],
"VpcId": "vpc-7e3fdd14",
"SubnetGroupStatus": "Complete",
"Description": "My subnet group",
"ClusterSubnetGroupName": "mysubnetgroup"
},
"ResponseMetadata": {
"RequestId": "500b8ce2-698f-11e2-9790-fd67517fb6fd"
}
}
```
+ API 세부 정보는 *AWS CLI 명령 참조*의 [CreateClusterSubnetGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/create-cluster-subnet-group.html)을 참조하세요.
### `create-cluster`
다음 코드 예시에서는 `create-cluster`의 사용 방법을 보여줍니다.
**AWS CLI**
최소 파라미터를 사용하여 클러스터 생성 이 예시에서는 최소 파라미터 세트로 클러스터를 만듭니다. 기본 출력 형식은 JSON입니다. 명령:
```
aws redshift create-cluster --node-type dw.hs1.xlarge --number-of-nodes 2 --master-username adminuser --master-user-password TopSecret1 --cluster-identifier mycluster
```
결과:
```
{
"Cluster": {
"NodeType": "dw.hs1.xlarge",
"ClusterVersion": "1.0",
"PubliclyAccessible": "true",
"MasterUsername": "adminuser",
"ClusterParameterGroups": [
{
"ParameterApplyStatus": "in-sync",
"ParameterGroupName": "default.redshift-1.0"
} ],
"ClusterSecurityGroups": [
{
"Status": "active",
"ClusterSecurityGroupName": "default"
} ],
"AllowVersionUpgrade": true,
"VpcSecurityGroups": \[],
"PreferredMaintenanceWindow": "sat:03:30-sat:04:00",
"AutomatedSnapshotRetentionPeriod": 1,
"ClusterStatus": "creating",
"ClusterIdentifier": "mycluster",
"DBName": "dev",
"NumberOfNodes": 2,
"PendingModifiedValues": {
"MasterUserPassword": "\****"
}
},
"ResponseMetadata": {
"RequestId": "7cf4bcfc-64dd-11e2-bea9-49e0ce183f07"
}
}
```
+ API 세부 정보는 *AWS CLI 명령 참조*의 [CreateCluster](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/create-cluster.html)를 참조하세요.
### `create-event-subscription`
다음 코드 예시에서는 `create-event-subscription`의 사용 방법을 보여줍니다.
**AWS CLI**
**이벤트 알림 구독 생성**
다음 `create-event-subscription` 예시에서는 이벤트 알림 구독을 생성합니다.
```
aws redshift create-event-subscription \
--subscription-name mysubscription \
--sns-topic-arn arn:aws:sns:us-west-2:123456789012:MySNStopic \
--source-type cluster \
--source-ids mycluster
```
출력:
```
{
"EventSubscription": {
"CustomerAwsId": "123456789012",
"CustSubscriptionId": "mysubscription",
"SnsTopicArn": "arn:aws:sns:us-west-2:123456789012:MySNStopic",
"Status": "active",
"SubscriptionCreationTime": "2019-12-09T20:05:19.365Z",
"SourceType": "cluster",
"SourceIdsList": [
"mycluster"
],
"EventCategoriesList": [],
"Severity": "INFO",
"Enabled": true,
"Tags": []
}
}
```
자세한 내용은 *Amazon Redshift 클러스터 관리 안내서*의 [Amazon Redshift 이벤트 알림 구독](https://docs.aws.amazon.com/redshift/latest/mgmt/working-with-event-notifications.html)을 참조하세요.
+ API 세부 정보는 *AWS CLI 명령 참조*의 [CreateEventSubscription](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/create-event-subscription.html)을 참조하세요.
### `create-hsm-client-certificate`
다음 코드 예시에서는 `create-hsm-client-certificate`의 사용 방법을 보여줍니다.
**AWS CLI**
**HSM 클라이언트 인증서 생성**
다음 `create-hsm-client-certificate` 예시에서는 클러스터가 HSM에 연결하는 데 사용할 수 있는 HSM 클라이언트 인증서를 생성합니다.
```
aws redshift create-hsm-client-certificate \
--hsm-client-certificate-identifier myhsmclientcert
```
출력:
```
{
"HsmClientCertificate": {
"HsmClientCertificateIdentifier": "myhsmclientcert",
"HsmClientCertificatePublicKey": "-----BEGIN CERTIFICATE-----
MIICiEXAMPLECQD6m7oRw0uXOjANBgkqhkiG9w0BAQUFADCBiDELMAkGA1UEBhMC
VVMxCzAJBgNVBAgTEXAMPLEwDgYDVQQHEwdTZWF0dGxlMQ8wDQYDVQQKEwZBbWF6
b24xFDASBgNVBAsTC0lBTSBDb25EXAMPLEIwEAYDVQQDEwlUZXN0Q2lsYWMxHzAd
BgkqhkiG9w0BCQEWEG5vb25lQGFtYXpvbi5jb2EXAMPLETEwNDI1MjA0NTIxWhcN
MTIwNDI0MjA0NTIxWjCBiDELMAkGA1UEBhMCVVMxCzAJBgNVBEXAMPLEMRAwDgYD
EXAMPLETZWF0dGxlMQ8wDQYDVQQKEwZBbWF6b24xFDASBgNVBAsTC0lBTSBDb25z
b2xlMRIwEAEXAMPLEwlUZXN0Q2lsYWMxHzAdBgkqhkiG9w0BCQEWEG5vb25lQGFt
YXpvbi5jb20wgZ8wDQYJKEXAMPLEAQEBBQADgY0AMIGJAoGBAMaK0dn+a4GmWIWJ
21uUSfwfEvySWtC2XADZ4nB+BLYgVIk6EXAMPLE3G93vUEIO3IyNoH/f0wYK8m9T
rDHudUZg3qX4waLG5M43q7Wgc/MbQITxOUSQv7c7ugEXAMPLEzZswY6786m86gpE
Ibb3OhjZnzcvQAaRHhdlQWIMm2nrAgMBAAEwDQYJKoZIhvcNAQEEXAMPLEEAtCu4
nUhVVxYUEXAMPLEh8Mg9q6q+auNKyExzyLwaxlAoo7TJHidbtS4J5iNmZgXL0Fkb
FFBjvSfpJIlJ00zbhNYS5f6GEXAMPLEl0ZxBHjJnyp378OD8uTs7fLvjx79LjSTb
NYiytVbZPQUQ5Yaxu2jXnimvw3rEXAMPLE=-----END CERTIFICATE-----\n",
"Tags": []
}
}
```
자세한 내용은 *Amazon Redshift 클러스터 관리 안내서*의 [Amazon Redshift API 권한 참조](https://docs.aws.amazon.com/redshift/latest/mgmt/redshift-policy-resources.resource-permissions.html)를 참조하세요.
+ API 세부 정보는 *AWS CLI 명령 참조*의 [CreateHsmClientCertificate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/create-hsm-client-certificate.html)를 참조하세요.
### `create-hsm-configuration`
다음 코드 예시에서는 `create-hsm-configuration`의 사용 방법을 보여줍니다.
**AWS CLI**
**HSM 구성 생성**
다음 `create-hsm-configuration` 예시에서는 클러스터가 하드웨어 보안 모듈(HSM)에 데이터베이스 암호화 키를 저장하고 사용하는 데 필요한 정보가 포함된 지정된 HSM 구성을 생성합니다.
```
aws redshift create-hsm-configuration /
--hsm-configuration-identifier myhsmconnection
--description "My HSM connection"
--hsm-ip-address 192.0.2.09
--hsm-partition-name myhsmpartition /
--hsm-partition-password A1b2c3d4 /
--hsm-server-public-certificate myhsmclientcert
```
출력:
```
{
"HsmConfiguration": {
"HsmConfigurationIdentifier": "myhsmconnection",
"Description": "My HSM connection",
"HsmIpAddress": "192.0.2.09",
"HsmPartitionName": "myhsmpartition",
"Tags": []
}
}
```
+ API 세부 정보는 *AWS CLI 명령 참조*의 [CreateHsmConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/create-hsm-configuration.html)을 참조하세요.
### `create-snapshot-copy-grant`
다음 코드 예시에서는 `create-snapshot-copy-grant`의 사용 방법을 보여줍니다.
**AWS CLI**
**스냅샷 복사 권한 생성**
다음 `create-snapshot-copy-grant` 예제에서는 스냅샷 복사 권한 부여를 생성하고 대상 AWS 리전에서 복사된 스냅샷을 암호화합니다.
```
aws redshift create-snapshot-copy-grant \
--snapshot-copy-grant-name mysnapshotcopygrantname
```
출력:
```
{
"SnapshotCopyGrant": {
"SnapshotCopyGrantName": "mysnapshotcopygrantname",
"KmsKeyId": "arn:aws:kms:us-west-2:123456789012:key/bPxRfih3yCo8nvbEXAMPLEKEY",
"Tags": []
}
}
```
자세한 내용은 *Amazon Redshift 클러스터 관리 안내서*의 [Amazon Redshift 데이터베이스 암호화](https://docs.aws.amazon.com/redshift/latest/mgmt/working-with-db-encryption.html)를 참조하세요.
+ API 세부 정보는 *AWS CLI 명령 참조*의 [CreateSnapshotCopyGrant](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/create-snapshot-copy-grant.html)를 참조하세요.
### `create-snapshot-schedule`
다음 코드 예시에서는 `create-snapshot-schedule`의 사용 방법을 보여줍니다.
**AWS CLI**
**스냅샷 일정 생성**
다음 `create-snapshot-schedule` 예시에서는 지정된 설명을 포함하여 12시간마다 스냅샷 일정을 생성합니다.
```
aws redshift create-snapshot-schedule \
--schedule-definitions "rate(12 hours)" \
--schedule-identifier mysnapshotschedule \
--schedule-description "My schedule description"
```
출력:
```
{
"ScheduleDefinitions": [
"rate(12 hours)"
],
"ScheduleIdentifier": "mysnapshotschedule",
"ScheduleDescription": "My schedule description",
"Tags": []
}
```
자세한 내용은 *Amazon Redshift 클러스터 관리 안내서*의 [자동 스냅샷 일정](https://docs.aws.amazon.com/redshift/latest/mgmt/working-with-snapshots.html#automated-snapshot-schedules)을 참조하세요.
+ API 세부 정보는 *AWS CLI 명령 참조*의 [CreateSnapshotSchedule](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/create-snapshot-schedule.html)을 참조하세요.
### `create-tags`
다음 코드 예시에서는 `create-tags`의 사용 방법을 보여줍니다.
**AWS CLI**
**클러스터의 태그 생성**
다음 `create-tags` 예시에서는 지정된 태그 키/값 페어를 지정된 클러스터에 추가합니다.
```
aws redshift create-tags \
--resource-name arn:aws:redshift:us-west-2:123456789012:cluster:mycluster \
--tags "Key"="mytags","Value"="tag1"
```
이 명령은 출력을 생성하지 않습니다.
자세한 내용은 *Amazon Redshift 클러스터 관리 안내서*의 [Amazon Redshift에서 리소스 태그 지정](https://docs.aws.amazon.com/redshift/latest/mgmt/amazon-redshift-tagging.html)을 참조하세요.
+ API 세부 정보는 *AWS CLI 명령 참조*의 [CreateTags](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/create-tags.html)를 참조하세요.
### `delete-cluster-parameter-group`
다음 코드 예시에서는 `delete-cluster-parameter-group`의 사용 방법을 보여줍니다.
**AWS CLI**
클러스터 파라미터 그룹 삭제 이 예시에서는 새 클러스터 파라미터 그룹을 삭제합니다. 명령:
```
aws redshift delete-cluster-parameter-group --parameter-group-name myclusterparametergroup
```
+ API 세부 정보는 *AWS CLI 명령 참조*의 [DeleteClusterParameterGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/delete-cluster-parameter-group.html)을 참조하세요.
### `delete-cluster-security-group`
다음 코드 예시에서는 `delete-cluster-security-group`의 사용 방법을 보여줍니다.
**AWS CLI**
클러스터 보안 그룹 삭제 이 예시에서는 클러스터 보안 그룹을 삭제합니다. 명령:
```
aws redshift delete-cluster-security-group --cluster-security-group-name mysecuritygroup
```
+ API 세부 정보는 *AWS CLI 명령 참조*의 [DeleteClusterSecurityGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/delete-cluster-security-group.html)을 참조하세요.
### `delete-cluster-snapshot`
다음 코드 예시에서는 `delete-cluster-snapshot`의 사용 방법을 보여줍니다.
**AWS CLI**
클러스터 스냅샷 삭제 이 예시에서는 클러스터 스냅샷을 삭제합니다. 명령:
```
aws redshift delete-cluster-snapshot --snapshot-identifier my-snapshot-id
```
+ API 세부 정보는 *AWS CLI 명령 참조*의 [DeleteClusterSnapshot](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/delete-cluster-snapshot.html)을 참조하세요.
### `delete-cluster-subnet-group`
다음 코드 예시에서는 `delete-cluster-subnet-group`의 사용 방법을 보여줍니다.
**AWS CLI**
클러스터 서브넷 그룹 삭제 이 예시에서는 클러스터 서브넷 그룹을 삭제합니다. 명령:
```
aws redshift delete-cluster-subnet-group --cluster-subnet-group-name mysubnetgroup
```
결과:
```
{
"ResponseMetadata": {
"RequestId": "253fbffd-6993-11e2-bc3a-47431073908a"
}
}
```
+ API 세부 정보는 *AWS CLI 명령 참조*의 [DeleteClusterSubnetGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/delete-cluster-subnet-group.html)을 참조하세요.
### `delete-cluster`
다음 코드 예시에서는 `delete-cluster`의 사용 방법을 보여줍니다.
**AWS CLI**
클러스터 삭제 및 최종 클러스터 스냅샷 생성 방지 이 예시에서는 클러스터를 삭제하고 최종 클러스터 스냅샷이 생성되지 않도록 데이터를 강제로 삭제합니다. 명령:
```
aws redshift delete-cluster --cluster-identifier mycluster --skip-final-cluster-snapshot
```
클러스터 삭제, 최종 클러스터 스냅샷 허용 이 예시에서는 클러스터를 삭제하지만 최종 클러스터 스냅샷을 지정합니다. 명령:
```
aws redshift delete-cluster --cluster-identifier mycluster --final-cluster-snapshot-identifier myfinalsnapshot
```
+ API 세부 정보는 *AWS CLI 명령 참조*의 [DeleteCluster](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/delete-cluster.html)를 참조하세요.
### `delete-event-subscription`
다음 코드 예시에서는 `delete-event-subscription`의 사용 방법을 보여줍니다.
**AWS CLI**
**이벤트 구독 삭제**
다음 `delete-event-subscription` 예시에서는 지정된 이벤트 알림 구독을 삭제합니다.
```
aws redshift delete-event-subscription \
--subscription-name mysubscription
```
이 명령은 출력을 생성하지 않습니다.
자세한 내용은 *Amazon Redshift 클러스터 관리 안내서*의 [Amazon Redshift 이벤트 알림 구독](https://docs.aws.amazon.com/redshift/latest/mgmt/working-with-event-notifications.html)을 참조하세요.
+ API 세부 정보는 *AWS CLI 명령 참조*의 [DeleteEventSubscription](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/delete-event-subscription.html)을 참조하세요.
### `delete-hsm-client-certificate`
다음 코드 예시에서는 `delete-hsm-client-certificate`의 사용 방법을 보여줍니다.
**AWS CLI**
**HSM 클라이언트 인증서 삭제**
다음 `delete-hsm-client-certificate` 예시에서는 HSM 클라이언트 인증서를 삭제합니다.
```
aws redshift delete-hsm-client-certificate \
--hsm-client-certificate-identifier myhsmclientcert
```
이 명령은 출력을 생성하지 않습니다.
자세한 내용은 *Amazon Redshift 클러스터 관리 안내서*의 [Amazon Redshift API 권한 참조](https://docs.aws.amazon.com/redshift/latest/mgmt/redshift-policy-resources.resource-permissions.html)를 참조하세요.
+ API 세부 정보는 *AWS CLI 명령 참조*의 [DeleteHsmClientCertificate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/delete-hsm-client-certificate.html)를 참조하세요.
### `delete-hsm-configuration`
다음 코드 예시에서는 `delete-hsm-configuration`의 사용 방법을 보여줍니다.
**AWS CLI**
**HSM 구성 삭제**
다음 `delete-hsm-configuration` 예시에서는 현재 AWS 계정에서 지정된 HSM 구성을 삭제합니다.
```
aws redshift delete-hsm-configuration /
--hsm-configuration-identifier myhsmconnection
```
이 명령은 출력을 생성하지 않습니다.
+ API 세부 정보는 *AWS CLI 명령 참조*의 [DeleteHsmConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/delete-hsm-configuration.html)을 참조하세요.
### `delete-scheduled-action`
다음 코드 예시에서는 `delete-scheduled-action`의 사용 방법을 보여줍니다.
**AWS CLI**
**예약된 작업 삭제**
다음 `delete-scheduled-action` 예시에서는 지정된 예약된 작업을 삭제합니다.
```
aws redshift delete-scheduled-action \
--scheduled-action-name myscheduledaction
```
이 명령은 출력을 생성하지 않습니다.
+ API 세부 정보는 *AWS CLI 명령 참조*의 [DeleteScheduledAction](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/delete-scheduled-action.html)을 참조하세요.
### `delete-snapshot-copy-grant`
다음 코드 예시에서는 `delete-snapshot-copy-grant`의 사용 방법을 보여줍니다.
**AWS CLI**
**스냅샷 복사본 권한 삭제**
다음 `delete-snapshot-copy-grant` 예시에서는 지정된 스냅샷 복사 권한을 삭제합니다.
```
aws redshift delete-snapshot-copy-grant \
--snapshot-copy-grant-name mysnapshotcopygrantname
```
이 명령은 출력을 생성하지 않습니다.
자세한 내용은 *Amazon Redshift 클러스터 관리 안내서*의 [Amazon Redshift 데이터베이스 암호화](https://docs.aws.amazon.com/redshift/latest/mgmt/working-with-db-encryption.html)를 참조하세요.
+ API 세부 정보는 *AWS CLI 명령 참조*의 [DeleteSnapshotCopyGrant](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/delete-snapshot-copy-grant.html)를 참조하세요.
### `delete-snapshot-schedule`
다음 코드 예시에서는 `delete-snapshot-schedule`의 사용 방법을 보여줍니다.
**AWS CLI**
**스냅샷 일정 삭제**
다음 `delete-snapshot-schedule` 예시에서는 지정된 스냅샷 일정을 삭제합니다. 일정을 삭제하기 전에 클러스터 연결을 해제해야 합니다.
```
aws redshift delete-snapshot-schedule \
--schedule-identifier mysnapshotschedule
```
이 명령은 출력을 생성하지 않습니다.
자세한 내용은 *Amazon Redshift 클러스터 관리 안내서*의 [자동 스냅샷 일정](https://docs.aws.amazon.com/redshift/latest/mgmt/working-with-snapshots.html#automated-snapshot-schedules)을 참조하세요.
+ API 세부 정보는 *AWS CLI 명령 참조*의 [DeleteSnapshotSchedule](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/delete-snapshot-schedule.html)을 참조하세요.
### `delete-tags`
다음 코드 예시에서는 `delete-tags`의 사용 방법을 보여줍니다.
**AWS CLI**
**클러스터에서 태그 삭제**
다음 `delete-tags` 예시에서는 지정된 클러스터에서 지정된 키 이름을 가진 태그를 삭제합니다.
```
aws redshift delete-tags \
--resource-name arn:aws:redshift:us-west-2:123456789012:cluster:mycluster \
--tag-keys "clustertagkey" "clustertagvalue"
```
이 명령은 출력을 생성하지 않습니다.
자세한 내용은 *Amazon Redshift 클러스터 관리 안내서*의 [Amazon Redshift에서 리소스 태그 지정](https://docs.aws.amazon.com/redshift/latest/mgmt/amazon-redshift-tagging.html)을 참조하세요.
+ API 세부 정보는 *AWS CLI 명령 참조*의 [DeleteTags](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/delete-tags.html)를 참조하세요.
### `describe-account-attributes`
다음 코드 예시는 `describe-account-attributes`의 사용 방법을 보여 줍니다.
**AWS CLI**
** AWS 계정의 속성을 설명하려면**
다음 `describe-account-attributes` 예제에서는 호출 AWS 계정에 연결된 속성을 표시합니다.
```
aws redshift describe-account-attributes
```
출력:
```
{
"AccountAttributes": [
{
"AttributeName": "max-defer-maintenance-duration",
"AttributeValues": [
{
"AttributeValue": "45"
}
]
}
]
}
```
+ API 세부 정보는 *AWS CLI 명령 참조*의 [DescribeAccountAttributes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/describe-account-attributes.html)를 참조하세요.
### `describe-cluster-db-revisions`
다음 코드 예시에서는 `describe-cluster-db-revisions`의 사용 방법을 보여줍니다.
**AWS CLI**
**클러스터의 DB 개정 설명**
다음 `describe-cluster-db-revisions` 예시에서는 지정된 클러스터의 `ClusterDbRevision` 객체 배열에 대한 세부 정보를 표시합니다.
```
aws redshift describe-cluster-db-revisions \
--cluster-identifier mycluster
```
출력:
```
{
"ClusterDbRevisions": [
{
"ClusterIdentifier": "mycluster",
"CurrentDatabaseRevision": "11420",
"DatabaseRevisionReleaseDate": "2019-11-22T16:43:49.597Z",
"RevisionTargets": []
}
]
}
```
+ API 세부 정보는 *AWS CLI 명령 참조*의 [DescribeClusterDbRevisions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/describe-cluster-db-revisions.html)를 참조하세요.
### `describe-cluster-parameter-groups`
다음 코드 예시에서는 `describe-cluster-parameter-groups`의 사용 방법을 보여줍니다.
**AWS CLI**
모든 클러스터 파라미터 그룹의 설명 가져오기 이 예시에서는 계정의 모든 클러스터 파라미터 그룹에 대한 설명을 열 헤더와 함께 반환합니다. 기본 출력 형식은 JSON입니다. 명령:
```
aws redshift describe-cluster-parameter-groups
```
결과:
```
{
"ParameterGroups": [
{
"ParameterGroupFamily": "redshift-1.0",
"Description": "My first cluster parameter group",
"ParameterGroupName": "myclusterparametergroup"
} ],
"ResponseMetadata": {
"RequestId": "8ceb8f6f-64cc-11e2-bea9-49e0ce183f07"
}
}
```
`--output text` 옵션을 사용하여 텍스트 형식으로 동일한 정보를 얻을 수도 있습니다. 명령:
`--output text` 옵션. 명령:
옵션. 명령:
```
aws redshift describe-cluster-parameter-groups --output text
```
결과:
```
redshift-1.0 My first cluster parameter group myclusterparametergroup
RESPONSEMETADATA 9e665a36-64cc-11e2-8f7d-3b939af52818
```
+ API 세부 정보는 *AWS CLI 명령 참조*의 [DescribeClusterParameterGroups](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/describe-cluster-parameter-groups.html)를 참조하세요.
### `describe-cluster-parameters`
다음 코드 예시에서는 `describe-cluster-parameters`의 사용 방법을 보여줍니다.
**AWS CLI**
지정된 클러스터 파라미터 그룹의 파라미터 가져오기 이 예시에서는 명명된 파라미터 그룹의 파라미터를 가져옵니다. 기본 출력 형식은 JSON입니다. 명령:
```
aws redshift describe-cluster-parameters --parameter-group-name myclusterparametergroup
```
결과:
```
{
"Parameters": [
{
"Description": "Sets the display format for date and time values.",
"DataType": "string",
"IsModifiable": true,
"Source": "engine-default",
"ParameterValue": "ISO, MDY",
"ParameterName": "datestyle"
},
{
"Description": "Sets the number of digits displayed for floating-point values",
"DataType": "integer",
"IsModifiable": true,
"AllowedValues": "-15-2",
"Source": "engine-default",
"ParameterValue": "0",
"ParameterName": "extra_float_digits"
},
(...remaining output omitted...)
]
}
```
`--output text` 옵션을 사용하여 텍스트 형식으로 동일한 정보를 얻을 수도 있습니다. 명령:
`--output text` 옵션. 명령:
옵션. 명령:
```
aws redshift describe-cluster-parameters --parameter-group-name myclusterparametergroup --output text
```
결과:
```
RESPONSEMETADATA cdac40aa-64cc-11e2-9e70-918437dd236d
Sets the display format for date and time values. string True engine-default ISO, MDY datestyle
Sets the number of digits displayed for floating-point values integer True -15-2 engine-default 0 extra_float_digits
This parameter applies a user-defined label to a group of queries that are run during the same session.. string True engine-default default query_group
require ssl for all databaseconnections boolean True true,false engine-default false require_ssl
Sets the schema search order for names that are not schema-qualified. string True engine-default $user, public search_path
Aborts any statement that takes over the specified number of milliseconds. integer True engine-default 0 statement_timeout
wlm json configuration string True engine-default \[{"query_concurrency":5}] wlm_json_configuration
```
+ API 세부 정보는 *AWS CLI 명령 참조*의 [DescribeClusterParameters](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/describe-cluster-parameters.html)를 참조하세요.
### `describe-cluster-security-groups`
다음 코드 예시에서는 `describe-cluster-security-groups`의 사용 방법을 보여줍니다.
**AWS CLI**
모든 클러스터 보안 그룹의 설명 가져오기 이 예시에서는 계정의 모든 클러스터 보안 그룹에 대한 설명을 반환합니다. 기본 출력 형식은 JSON입니다. 명령:
```
aws redshift describe-cluster-security-groups
```
결과:
```
{
"ClusterSecurityGroups": [
{
"OwnerId": "100447751468",
"Description": "default",
"ClusterSecurityGroupName": "default",
"EC2SecurityGroups": \[],
"IPRanges": [
{
"Status": "authorized",
"CIDRIP": "0.0.0.0/0"
}
]
},
{
"OwnerId": "100447751468",
"Description": "This is my cluster security group",
"ClusterSecurityGroupName": "mysecuritygroup",
"EC2SecurityGroups": \[],
"IPRanges": \[]
},
(...remaining output omitted...)
]
}
```
+ API 세부 정보는 *AWS CLI 명령 참조*의 [DescribeClusterSecurityGroups](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/describe-cluster-security-groups.html)를 참조하세요.
### `describe-cluster-snapshots`
다음 코드 예시에서는 `describe-cluster-snapshots`의 사용 방법을 보여줍니다.
**AWS CLI**
모든 클러스터 스냅샷의 설명 가져오기 이 예시에서는 계정의 모든 클러스터 스냅샷에 대한 설명을 반환합니다. 기본 출력 형식은 JSON입니다. 명령:
```
aws redshift describe-cluster-snapshots
```
결과:
```
{
"Snapshots": [
{
"Status": "available",
"SnapshotCreateTime": "2013-07-17T22:02:22.852Z",
"EstimatedSecondsToCompletion": -1,
"AvailabilityZone": "us-east-1a",
"ClusterVersion": "1.0",
"MasterUsername": "adminuser",
"Encrypted": false,
"OwnerAccount": "111122223333",
"BackupProgressInMegabytes": 20.0,
"ElapsedTimeInSeconds": 0,
"DBName": "dev",
"CurrentBackupRateInMegabytesPerSecond: 0.0,
"ClusterCreateTime": "2013-01-22T21:59:29.559Z",
"ActualIncrementalBackupSizeInMegabytes"; 20.0
"SnapshotType": "automated",
"NodeType": "dw.hs1.xlarge",
"ClusterIdentifier": "mycluster",
"Port": 5439,
"TotalBackupSizeInMegabytes": 20.0,
"NumberOfNodes": "2",
"SnapshotIdentifier": "cm:mycluster-2013-01-22-22-04-18"
},
{
"EstimatedSecondsToCompletion": 0,
"OwnerAccount": "111122223333",
"CurrentBackupRateInMegabytesPerSecond: 0.1534,
"ActualIncrementalBackupSizeInMegabytes"; 11.0,
"NumberOfNodes": "2",
"Status": "available",
"ClusterVersion": "1.0",
"MasterUsername": "adminuser",
"AccountsWithRestoreAccess": [
{
"AccountID": "444455556666"
} ],
"TotalBackupSizeInMegabytes": 20.0,
"DBName": "dev",
"BackupProgressInMegabytes": 11.0,
"ClusterCreateTime": "2013-01-22T21:59:29.559Z",
"ElapsedTimeInSeconds": 0,
"ClusterIdentifier": "mycluster",
"SnapshotCreateTime": "2013-07-17T22:04:18.947Z",
"AvailabilityZone": "us-east-1a",
"NodeType": "dw.hs1.xlarge",
"Encrypted": false,
"SnapshotType": "manual",
"Port": 5439,
"SnapshotIdentifier": "my-snapshot-id"
} ]
}
(...remaining output omitted...)
```
+ API 세부 정보는 *AWS CLI 명령 참조*의 [DescribeClusterSnapshots](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/describe-cluster-snapshots.html)를 참조하세요.
### `describe-cluster-subnet-groups`
다음 코드 예시에서는 `describe-cluster-subnet-groups`의 사용 방법을 보여줍니다.
**AWS CLI**
모든 클러스터 서브넷 그룹의 설명 가져오기 이 예시에서는 모든 클러스터 서브넷 그룹의 설명을 반환합니다. 기본 출력 형식은 JSON입니다. 명령:
```
aws redshift describe-cluster-subnet-groups
```
결과:
```
{
"ClusterSubnetGroups": [
{
"Subnets": [
{
"SubnetStatus": "Active",
"SubnetIdentifier": "subnet-763fdd1c",
"SubnetAvailabilityZone": {
"Name": "us-east-1a"
}
}
],
"VpcId": "vpc-7e3fdd14",
"SubnetGroupStatus": "Complete",
"Description": "My subnet group",
"ClusterSubnetGroupName": "mysubnetgroup"
}
],
"ResponseMetadata": {
"RequestId": "37fa8c89-6990-11e2-8f75-ab4018764c77"
}
}
```
+ API 세부 정보는 *AWS CLI 명령 참조*의 [DescribeClusterSubnetGroups](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/describe-cluster-subnet-groups.html)를 참조하세요.
### `describe-cluster-tracks`
다음 코드 예시에서는 `describe-cluster-tracks`의 사용 방법을 보여줍니다.
**AWS CLI**
**클러스터 트랙 설명**
다음 `describe-cluster-tracks` 예시에서는 사용 가능한 유지 관리 트랙의 세부 정보를 표시합니다.
```
aws redshift describe-cluster-tracks \
--maintenance-track-name current
```
출력:
```
{
"MaintenanceTracks": [
{
"MaintenanceTrackName": "current",
"DatabaseVersion": "1.0.11420",
"UpdateTargets": [
{
"MaintenanceTrackName": "preview_features",
"DatabaseVersion": "1.0.11746",
"SupportedOperations": [
{
"OperationName": "restore-from-cluster-snapshot"
}
]
},
{
"MaintenanceTrackName": "trailing",
"DatabaseVersion": "1.0.11116",
"SupportedOperations": [
{
"OperationName": "restore-from-cluster-snapshot"
},
{
"OperationName": "modify-cluster"
}
]
}
]
}
]
}
```
자세한 내용은 *Amazon Redshift 클러스터 관리 안내서*의 [클러스터 유지 관리 트랙 선택](https://docs.aws.amazon.com/redshift/latest/mgmt/working-with-clusters.html#rs-mgmt-maintenance-tracks)을 참조하세요.
+ API 세부 정보는 *AWS CLI 명령 참조*의 [DescribeClusterTracks](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/describe-cluster-tracks.html)를 참조하세요.
### `describe-cluster-versions`
다음 코드 예시에서는 `describe-cluster-versions`의 사용 방법을 보여줍니다.
**AWS CLI**
모든 클러스터 버전에 대한 설명 가져오기 이 예시에서는 모든 클러스터 버전에 대한 설명을 반환합니다. 기본 출력 형식은 JSON입니다. 명령:
```
aws redshift describe-cluster-versions
```
결과:
```
{
"ClusterVersions": [
{
"ClusterVersion": "1.0",
"Description": "Initial release",
"ClusterParameterGroupFamily": "redshift-1.0"
} ],
"ResponseMetadata": {
"RequestId": "16a53de3-64cc-11e2-bec0-17624ad140dd"
}
}
```
+ API 세부 정보는 *AWS CLI 명령 참조*의 [DescribeClusterVersions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/describe-cluster-versions.html)를 참조하세요.
### `describe-clusters`
다음 코드 예시에서는 `describe-clusters`의 사용 방법을 보여줍니다.
**AWS CLI**
모든 클러스터의 설명 가져오기 이 예시에서는 계정의 모든 클러스터에 대한 설명을 반환합니다. 기본 출력 형식은 JSON입니다. 명령:
```
aws redshift describe-clusters
```
결과:
```
{
"Clusters": [
{
"NodeType": "dw.hs1.xlarge",
"Endpoint": {
"Port": 5439,
"Address": "mycluster.coqoarplqhsn.us-east-1.redshift.amazonaws.com"
},
"ClusterVersion": "1.0",
"PubliclyAccessible": "true",
"MasterUsername": "adminuser",
"ClusterParameterGroups": [
{
"ParameterApplyStatus": "in-sync",
"ParameterGroupName": "default.redshift-1.0"
} ],
"ClusterSecurityGroups": [
{
"Status": "active",
"ClusterSecurityGroupName": "default"
} ],
"AllowVersionUpgrade": true,
"VpcSecurityGroups": \[],
"AvailabilityZone": "us-east-1a",
"ClusterCreateTime": "2013-01-22T21:59:29.559Z",
"PreferredMaintenanceWindow": "sat:03:30-sat:04:00",
"AutomatedSnapshotRetentionPeriod": 1,
"ClusterStatus": "available",
"ClusterIdentifier": "mycluster",
"DBName": "dev",
"NumberOfNodes": 2,
"PendingModifiedValues": {}
} ],
"ResponseMetadata": {
"RequestId": "65b71cac-64df-11e2-8f5b-e90bd6c77476"
}
}
```
`--output text` 옵션을 사용하여 텍스트 형식으로 동일한 정보를 얻을 수도 있습니다. 명령:
`--output text` 옵션. 명령:
옵션. 명령:
```
aws redshift describe-clusters --output text
```
결과:
```
dw.hs1.xlarge 1.0 true adminuser True us-east-1a 2013-01-22T21:59:29.559Z sat:03:30-sat:04:00 1 available mycluster dev 2
ENDPOINT 5439 mycluster.coqoarplqhsn.us-east-1.redshift.amazonaws.com
in-sync default.redshift-1.0
active default
PENDINGMODIFIEDVALUES
RESPONSEMETADATA 934281a8-64df-11e2-b07c-f7fbdd006c67
```
+ API 세부 정보는 *AWS CLI 명령 참조*의 [DescribeClusters](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/describe-clusters.html)를 참조하세요.
### `describe-default-cluster-parameters`
다음 코드 예시에서는 `describe-default-cluster-parameters`의 사용 방법을 보여줍니다.
**AWS CLI**
기본 클러스터 파라미터의 설명 가져오기 이 예시에서는 `redshift-1.0` 패밀리의 기본 클러스터 파라미터에 대한 설명을 반환합니다. 기본 출력 형식은 JSON입니다. 명령:
```
aws redshift describe-default-cluster-parameters --parameter-group-family redshift-1.0
```
결과:
```
{
"DefaultClusterParameters": {
"ParameterGroupFamily": "redshift-1.0",
"Parameters": [
{
"Description": "Sets the display format for date and time values.",
"DataType": "string",
"IsModifiable": true,
"Source": "engine-default",
"ParameterValue": "ISO, MDY",
"ParameterName": "datestyle"
},
{
"Description": "Sets the number of digits displayed for floating-point values",
"DataType": "integer",
"IsModifiable": true,
"AllowedValues": "-15-2",
"Source": "engine-default",
"ParameterValue": "0",
"ParameterName": "extra_float_digits"
},
(...remaining output omitted...)
]
}
}
```
유효한 파라미터 그룹 패밀리 목록을 보려면 `describe-cluster-parameter-groups` 명령을 사용합니다.
`describe-cluster-parameter-groups` 명령.
명령.
+ API 세부 정보는 *AWS CLI 명령 참조*의 [DescribeDefaultClusterParameters](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/describe-default-cluster-parameters.html)를 참조하세요.
### `describe-event-categories`
다음 코드 예시에서는 `describe-event-categories`의 사용 방법을 보여줍니다.
**AWS CLI**
**클러스터의 이벤트 범주 설명**
다음 `describe-event-categories` 예시에서는 클러스터의 이벤트 범주에 대한 세부 정보를 표시합니다.
```
aws redshift describe-event-categories \
--source-type cluster
```
출력:
```
{
"EventCategoriesMapList": [
{
"SourceType": "cluster",
"Events": [
{
"EventId": "REDSHIFT-EVENT-2000",
"EventCategories": [
"management"
],
"EventDescription": "Cluster created at