D'autres exemples de AWS SDK sont disponibles dans le référentiel [AWS Doc SDK Examples](https://github.com/awsdocs/aws-doc-sdk-examples) GitHub .
Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
# Exemples d'utilisation d'Amazon Redshift AWS CLI
Les exemples de code suivants vous montrent comment effectuer des actions et implémenter des scénarios courants à l' AWS Command Line Interface aide d'Amazon Redshift.
Les *actions* sont des extraits de code de programmes plus larges et doivent être exécutées dans leur contexte. Alors que les actions vous indiquent comment appeler des fonctions de service individuelles, vous pouvez les voir en contexte dans leurs scénarios associés.
Chaque exemple inclut un lien vers le code source complet, où vous trouverez des instructions sur la configuration et l’exécution du code en contexte.
**Topics**
+ [Actions](#actions)
## Actions
### `accept-reserved-node-exchange`
L'exemple de code suivant montre comment utiliser`accept-reserved-node-exchange`.
**AWS CLI**
**Pour accepter l’échange de nœuds réservés**
L'`accept-reserved-node-exchange`exemple suivant accepte l'échange d'un nœud DC1 réservé contre un nœud DC2 réservé.
```
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
```
Sortie :
```
{
"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"
}
}
```
Pour plus d'informations, consultez la section [Mise à niveau des nœuds réservés avec la AWS CLI](https://docs.aws.amazon.com/redshift/latest/mgmt/purchase-reserved-node-offering-console.html) dans le *manuel Amazon Redshift Cluster Management Guide*.
+ Pour plus de détails sur l'API, reportez-vous [AcceptReservedNodeExchange](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/accept-reserved-node-exchange.html)à la section *Référence des AWS CLI commandes*.
### `authorize-cluster-security-group-ingress`
L'exemple de code suivant montre comment utiliser`authorize-cluster-security-group-ingress`.
**AWS CLI**
Autoriser l'accès à un GroupThis exemple de sécurité EC2 autorise l'accès à un groupe de sécurité Amazon EC2 nommé. Commande :
```
aws redshift authorize-cluster-security-group-ingress --cluster-security-group-name mysecuritygroup --ec2-security-group-name myec2securitygroup --ec2-security-group-owner-id 123445677890
```
Autorisation de l’accès à une plage d’adresses CIDR Cet exemple autorise l’accès à une plage d’adresses CIDR. Commande :
```
aws redshift authorize-cluster-security-group-ingress --cluster-security-group-name mysecuritygroup --cidrip 192.168.100.100/32
```
+ Pour plus de détails sur l'API, reportez-vous [AuthorizeClusterSecurityGroupIngress](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/authorize-cluster-security-group-ingress.html)à la section *Référence des AWS CLI commandes*.
### `authorize-snapshot-access`
L'exemple de code suivant montre comment utiliser`authorize-snapshot-access`.
**AWS CLI**
Autoriser un AWS compte pour restaurer Un SnapshotThis exemple autorise le AWS compte `444455556666` à restaurer le snapshot`my-snapshot-id`. JSON est le format de sortie par défaut. Commande :
```
aws redshift authorize-snapshot-access --snapshot-id my-snapshot-id --account-with-restore-access 444455556666
```
Résultat :
```
{
"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"
}
}
```
+ Pour plus de détails sur l'API, reportez-vous [AuthorizeSnapshotAccess](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/authorize-snapshot-access.html)à la section *Référence des AWS CLI commandes*.
### `batch-delete-cluster-snapshots`
L'exemple de code suivant montre comment utiliser`batch-delete-cluster-snapshots`.
**AWS CLI**
**Pour supprimer un ensemble d’instantanés de cluster**
L’exemple `batch-delete-cluster-snapshots` suivant supprime un ensemble d’instantanés de cluster manuels.
```
aws redshift batch-delete-cluster-snapshots \
--identifiers SnapshotIdentifier=mycluster-2019-11-06-14-12 SnapshotIdentifier=mycluster-2019-11-06-14-20
```
Sortie :
```
{
"Resources": [
"mycluster-2019-11-06-14-12",
"mycluster-2019-11-06-14-20"
]
}
```
Pour plus d’informations, consultez [Instantanés Amazon Redshift](https://docs.aws.amazon.com/redshift/latest/mgmt/working-with-snapshots.html) dans le *Guide de gestion du cluster Amazon Redshift*.
+ Pour plus de détails sur l'API, reportez-vous [BatchDeleteClusterSnapshots](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/batch-delete-cluster-snapshots.html)à la section *Référence des AWS CLI commandes*.
### `batch-modify-cluster-snapshots`
L'exemple de code suivant montre comment utiliser`batch-modify-cluster-snapshots`.
**AWS CLI**
**Pour modifier un ensemble d’instantanés de cluster**
L’exemple `batch-modify-cluster-snapshots` suivant modifie les paramètres d’un ensemble d’instantanés de cluster.
```
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
```
Sortie :
```
{
"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
}
}
```
Pour plus d’informations, consultez [Instantanés Amazon Redshift](https://docs.aws.amazon.com/redshift/latest/mgmt/working-with-snapshots.html) dans le *Guide de gestion du cluster Amazon Redshift*.
+ Pour plus de détails sur l'API, reportez-vous [BatchModifyClusterSnapshots](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/batch-modify-cluster-snapshots.html)à la section *Référence des AWS CLI commandes*.
### `cancel-resize`
L'exemple de code suivant montre comment utiliser`cancel-resize`.
**AWS CLI**
**Pour annuler le redimensionnement d’un cluster**
L’exemple `cancel-resize` suivant annule une opération de redimensionnement classique pour un cluster.
```
aws redshift cancel-resize \
--cluster-identifier mycluster
```
Sortie :
```
{
"TargetNodeType": "dc2.large",
"TargetNumberOfNodes": 2,
"TargetClusterType": "multi-node",
"Status": "CANCELLING",
"ResizeType": "ClassicResize",
"TargetEncryptionType": "NONE"
}
```
Pour plus d’informations sur la gestion des clusters, consultez [Redimensionnement des clusters dans Amazon Redshift](https://docs.aws.amazon.com/redshift/latest/mgmt/rs-resize-tutorial.html) dans le *Guide de gestion du cluster Amazon Redshift*.
+ Pour plus de détails sur l'API, reportez-vous [CancelResize](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/cancel-resize.html)à la section *Référence des AWS CLI commandes*.
### `copy-cluster-snapshot`
L'exemple de code suivant montre comment utiliser`copy-cluster-snapshot`.
**AWS CLI**
L' VersionsThis exemple Get a Description of All Cluster renvoie une description de toutes les versions du cluster. JSON est le format de sortie par défaut. Commande :
```
aws redshift copy-cluster-snapshot --source-snapshot-identifier cm:examplecluster-2013-01-22-19-27-58 --target-snapshot-identifier my-saved-snapshot-copy
```
Résultat :
```
{
"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"
}
}
```
+ Pour plus de détails sur l'API, reportez-vous [CopyClusterSnapshot](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/copy-cluster-snapshot.html)à la section *Référence des AWS CLI commandes*.
### `create-cluster-parameter-group`
L'exemple de code suivant montre comment utiliser`create-cluster-parameter-group`.
**AWS CLI**
L' GroupThis exemple de création d'un paramètre de cluster crée un nouveau groupe de paramètres de cluster.Commande :
```
aws redshift create-cluster-parameter-group --parameter-group-name myclusterparametergroup --parameter-group-family redshift-1.0 --description "My first cluster parameter group"
```
Résultat :
```
{
"ClusterParameterGroup": {
"ParameterGroupFamily": "redshift-1.0",
"Description": "My first cluster parameter group",
"ParameterGroupName": "myclusterparametergroup"
},
"ResponseMetadata": {
"RequestId": "739448f0-64cc-11e2-8f7d-3b939af52818"
}
}
```
+ Pour plus de détails sur l'API, reportez-vous [CreateClusterParameterGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/create-cluster-parameter-group.html)à la section *Référence des AWS CLI commandes*.
### `create-cluster-security-group`
L'exemple de code suivant montre comment utiliser`create-cluster-security-group`.
**AWS CLI**
La création d'un GroupThis exemple de sécurité de cluster crée un nouveau groupe de sécurité de cluster. JSON est le format de sortie par défaut. Commande :
```
aws redshift create-cluster-security-group --cluster-security-group-name mysecuritygroup --description "This is my cluster security group"
```
Résultat :
```
{
"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"
}
}
}
```
Vous pouvez également obtenir les mêmes informations au format texte à l’aide de l’option `--output text`. Commande :
option `--output text`. Commande :
option. Commande :
```
aws redshift create-cluster-security-group --cluster-security-group-name mysecuritygroup --description "This is my cluster security group" --output text
```
Résultat :
```
This is my cluster security group 300454760768 mysecuritygroup
a0c0bfab-343a-11e2-95d2-c3dc9fe8ab57
```
+ Pour plus de détails sur l'API, reportez-vous [CreateClusterSecurityGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/create-cluster-security-group.html)à la section *Référence des AWS CLI commandes*.
### `create-cluster-snapshot`
L'exemple de code suivant montre comment utiliser`create-cluster-snapshot`.
**AWS CLI**
L' SnapshotThis exemple de création d'un cluster crée un nouvel instantané de cluster. JSON est le format de sortie par défaut. Commande :
```
aws redshift create-cluster-snapshot --cluster-identifier mycluster --snapshot-identifier my-snapshot-id
```
Résultat :
```
{
"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"
}
}
```
+ Pour plus de détails sur l'API, reportez-vous [CreateClusterSnapshot](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/create-cluster-snapshot.html)à la section *Référence des AWS CLI commandes*.
### `create-cluster-subnet-group`
L'exemple de code suivant montre comment utiliser`create-cluster-subnet-group`.
**AWS CLI**
L' GroupThis exemple de création d'un sous-réseau de cluster crée un nouveau groupe de sous-réseaux de cluster.Commande :
```
aws redshift create-cluster-subnet-group --cluster-subnet-group-name mysubnetgroup --description "My subnet group" --subnet-ids subnet-763fdd1c
```
Résultat :
```
{
"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"
}
}
```
+ Pour plus de détails sur l'API, reportez-vous [CreateClusterSubnetGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/create-cluster-subnet-group.html)à la section *Référence des AWS CLI commandes*.
### `create-cluster`
L'exemple de code suivant montre comment utiliser`create-cluster`.
**AWS CLI**
L' ParametersThis exemple Create a Cluster with Minimal crée un cluster avec un ensemble minimal de paramètres. JSON est le format de sortie par défaut. Commande :
```
aws redshift create-cluster --node-type dw.hs1.xlarge --number-of-nodes 2 --master-username adminuser --master-user-password TopSecret1 --cluster-identifier mycluster
```
Résultat :
```
{
"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"
}
}
```
+ Pour plus de détails sur l'API, reportez-vous [CreateCluster](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/create-cluster.html)à la section *Référence des AWS CLI commandes*.
### `create-event-subscription`
L'exemple de code suivant montre comment utiliser`create-event-subscription`.
**AWS CLI**
**Pour créer un abonnement aux notifications pour un événement**
L’exemple `create-event-subscription` suivant crée un abonnement aux notifications d’événements.
```
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
```
Sortie :
```
{
"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": []
}
}
```
Pour plus d’informations, consultez [Abonnement à la notification d’événement Amazon Redshift](https://docs.aws.amazon.com/redshift/latest/mgmt/working-with-event-notifications.html) dans le *Guide de gestion du cluster Amazon Redshift*.
+ Pour plus de détails sur l'API, reportez-vous [CreateEventSubscription](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/create-event-subscription.html)à la section *Référence des AWS CLI commandes*.
### `create-hsm-client-certificate`
L'exemple de code suivant montre comment utiliser`create-hsm-client-certificate`.
**AWS CLI**
**Pour créer un certificat de client HSM**
L’exemple `create-hsm-client-certificate` suivant génère un certificat client HSM qu’un cluster peut utiliser pour se connecter à un HSM.
```
aws redshift create-hsm-client-certificate \
--hsm-client-certificate-identifier myhsmclientcert
```
Sortie :
```
{
"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": []
}
}
```
Pour plus d’informations, consultez [Référence des autorisations d’API Amazon Redshift](https://docs.aws.amazon.com/redshift/latest/mgmt/redshift-policy-resources.resource-permissions.html) dans le *Guide de gestion du cluster Amazon Redshift*.
+ Pour plus de détails sur l'API, reportez-vous [CreateHsmClientCertificate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/create-hsm-client-certificate.html)à la section *Référence des AWS CLI commandes*.
### `create-hsm-configuration`
L'exemple de code suivant montre comment utiliser`create-hsm-configuration`.
**AWS CLI**
**Pour créer une configuration HSM**
L’exemple `create-hsm-configuration` suivant crée la configuration HSM spécifiée qui contient les informations requises par un cluster pour stocker et utiliser des clés de chiffrement de base de données dans un module de sécurité matériel (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
```
Sortie :
```
{
"HsmConfiguration": {
"HsmConfigurationIdentifier": "myhsmconnection",
"Description": "My HSM connection",
"HsmIpAddress": "192.0.2.09",
"HsmPartitionName": "myhsmpartition",
"Tags": []
}
}
```
+ Pour plus de détails sur l'API, reportez-vous [CreateHsmConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/create-hsm-configuration.html)à la section *Référence des AWS CLI commandes*.
### `create-snapshot-copy-grant`
L'exemple de code suivant montre comment utiliser`create-snapshot-copy-grant`.
**AWS CLI**
**Pour créer une autorisation de copie d’instantanés**
L'`create-snapshot-copy-grant`exemple suivant crée une autorisation de copie d'instantanés et chiffre les instantanés copiés dans une région de destination AWS .
```
aws redshift create-snapshot-copy-grant \
--snapshot-copy-grant-name mysnapshotcopygrantname
```
Sortie :
```
{
"SnapshotCopyGrant": {
"SnapshotCopyGrantName": "mysnapshotcopygrantname",
"KmsKeyId": "arn:aws:kms:us-west-2:123456789012:key/bPxRfih3yCo8nvbEXAMPLEKEY",
"Tags": []
}
}
```
Pour plus d’informations, consultez [Amazon Redshift Database Encryption](https://docs.aws.amazon.com/redshift/latest/mgmt/working-with-db-encryption.html) dans le *Guide de gestion du cluster Amazon Redshift*.
+ Pour plus de détails sur l'API, reportez-vous [CreateSnapshotCopyGrant](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/create-snapshot-copy-grant.html)à la section *Référence des AWS CLI commandes*.
### `create-snapshot-schedule`
L'exemple de code suivant montre comment utiliser`create-snapshot-schedule`.
**AWS CLI**
**Pour créer une planification d’instantané**
L’exemple `create-snapshot-schedule` suivant crée une planification d’instantané avec la description spécifiée et une fréquence égale à toutes les 12 heures.
```
aws redshift create-snapshot-schedule \
--schedule-definitions "rate(12 hours)" \
--schedule-identifier mysnapshotschedule \
--schedule-description "My schedule description"
```
Sortie :
```
{
"ScheduleDefinitions": [
"rate(12 hours)"
],
"ScheduleIdentifier": "mysnapshotschedule",
"ScheduleDescription": "My schedule description",
"Tags": []
}
```
Pour plus d’informations, consultez [Planifications d’un instantané automatique](https://docs.aws.amazon.com/redshift/latest/mgmt/working-with-snapshots.html#automated-snapshot-schedules) dans le *Guide de gestion du cluster Amazon Redshift*.
+ Pour plus de détails sur l'API, reportez-vous [CreateSnapshotSchedule](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/create-snapshot-schedule.html)à la section *Référence des AWS CLI commandes*.
### `create-tags`
L'exemple de code suivant montre comment utiliser`create-tags`.
**AWS CLI**
**Pour créer des balises pour un cluster**
L'`create-tags`exemple suivant ajoute la key/value paire de balises spécifiée au cluster spécifié.
```
aws redshift create-tags \
--resource-name arn:aws:redshift:us-west-2:123456789012:cluster:mycluster \
--tags "Key"="mytags","Value"="tag1"
```
Cette commande ne génère pas de sortie.
Pour plus d’informations, consultez [Tagging Resources in Amazon Redshift](https://docs.aws.amazon.com/redshift/latest/mgmt/amazon-redshift-tagging.html) dans le *Guide de gestion du cluster Amazon Redshift*.
+ Pour plus de détails sur l'API, reportez-vous [CreateTags](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/create-tags.html)à la section *Référence des AWS CLI commandes*.
### `delete-cluster-parameter-group`
L'exemple de code suivant montre comment utiliser`delete-cluster-parameter-group`.
**AWS CLI**
L' GroupThis exemple de suppression d'un paramètre de cluster supprime un groupe de paramètres de cluster.Commande :
```
aws redshift delete-cluster-parameter-group --parameter-group-name myclusterparametergroup
```
+ Pour plus de détails sur l'API, reportez-vous [DeleteClusterParameterGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/delete-cluster-parameter-group.html)à la section *Référence des AWS CLI commandes*.
### `delete-cluster-security-group`
L'exemple de code suivant montre comment utiliser`delete-cluster-security-group`.
**AWS CLI**
Supprimer un GroupThis exemple de sécurité de cluster supprime un groupe de sécurité de cluster.Commande :
```
aws redshift delete-cluster-security-group --cluster-security-group-name mysecuritygroup
```
+ Pour plus de détails sur l'API, reportez-vous [DeleteClusterSecurityGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/delete-cluster-security-group.html)à la section *Référence des AWS CLI commandes*.
### `delete-cluster-snapshot`
L'exemple de code suivant montre comment utiliser`delete-cluster-snapshot`.
**AWS CLI**
Supprimer un cluster SnapshotThis Exemple de suppression d'un instantané de cluster.Commande :
```
aws redshift delete-cluster-snapshot --snapshot-identifier my-snapshot-id
```
+ Pour plus de détails sur l'API, reportez-vous [DeleteClusterSnapshot](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/delete-cluster-snapshot.html)à la section *Référence des AWS CLI commandes*.
### `delete-cluster-subnet-group`
L'exemple de code suivant montre comment utiliser`delete-cluster-subnet-group`.
**AWS CLI**
Supprimer un sous-réseau de cluster. GroupThis Exemple de suppression d'un groupe de sous-réseaux de cluster.Commande :
```
aws redshift delete-cluster-subnet-group --cluster-subnet-group-name mysubnetgroup
```
Résultat :
```
{
"ResponseMetadata": {
"RequestId": "253fbffd-6993-11e2-bc3a-47431073908a"
}
}
```
+ Pour plus de détails sur l'API, reportez-vous [DeleteClusterSubnetGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/delete-cluster-subnet-group.html)à la section *Référence des AWS CLI commandes*.
### `delete-cluster`
L'exemple de code suivant montre comment utiliser`delete-cluster`.
**AWS CLI**
Supprimer un cluster sans cluster final SnapshotThis Exemple de suppression d'un cluster, forçant ainsi la suppression des données afin qu'aucun instantané final du cluster ne soit créé.Commande :
```
aws redshift delete-cluster --cluster-identifier mycluster --skip-final-cluster-snapshot
```
Supprimer un cluster, autoriser un cluster final, SnapshotThis par exemple, supprime un cluster, mais spécifie un instantané du cluster.Commande :
```
aws redshift delete-cluster --cluster-identifier mycluster --final-cluster-snapshot-identifier myfinalsnapshot
```
+ Pour plus de détails sur l'API, reportez-vous [DeleteCluster](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/delete-cluster.html)à la section *Référence des AWS CLI commandes*.
### `delete-event-subscription`
L'exemple de code suivant montre comment utiliser`delete-event-subscription`.
**AWS CLI**
**Pour supprimer un abonnement à un événement**
L’exemple `delete-event-subscription` suivant supprime l’abonnement aux notifications d’événements spécifié.
```
aws redshift delete-event-subscription \
--subscription-name mysubscription
```
Cette commande ne génère pas de sortie.
Pour plus d’informations, consultez [Abonnement à la notification d’événement Amazon Redshift](https://docs.aws.amazon.com/redshift/latest/mgmt/working-with-event-notifications.html) dans le *Guide de gestion du cluster Amazon Redshift*.
+ Pour plus de détails sur l'API, reportez-vous [DeleteEventSubscription](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/delete-event-subscription.html)à la section *Référence des AWS CLI commandes*.
### `delete-hsm-client-certificate`
L'exemple de code suivant montre comment utiliser`delete-hsm-client-certificate`.
**AWS CLI**
**Pour supprimer un certificat de client HSM**
L’exemple `delete-hsm-client-certificate` suivant supprime un certificat de client HSM.
```
aws redshift delete-hsm-client-certificate \
--hsm-client-certificate-identifier myhsmclientcert
```
Cette commande ne génère pas de sortie.
Pour plus d’informations, consultez [Référence des autorisations d’API Amazon Redshift](https://docs.aws.amazon.com/redshift/latest/mgmt/redshift-policy-resources.resource-permissions.html) dans le *Guide de gestion du cluster Amazon Redshift*.
+ Pour plus de détails sur l'API, reportez-vous [DeleteHsmClientCertificate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/delete-hsm-client-certificate.html)à la section *Référence des AWS CLI commandes*.
### `delete-hsm-configuration`
L'exemple de code suivant montre comment utiliser`delete-hsm-configuration`.
**AWS CLI**
**Pour supprimer une configuration HSM**
L'`delete-hsm-configuration`exemple suivant supprime la configuration HSM spécifiée du compte actuel AWS .
```
aws redshift delete-hsm-configuration /
--hsm-configuration-identifier myhsmconnection
```
Cette commande ne génère pas de sortie.
+ Pour plus de détails sur l'API, reportez-vous [DeleteHsmConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/delete-hsm-configuration.html)à la section *Référence des AWS CLI commandes*.
### `delete-scheduled-action`
L'exemple de code suivant montre comment utiliser`delete-scheduled-action`.
**AWS CLI**
**Pour supprimer une action planifiée**
L’exemple `delete-scheduled-action` suivant supprime une action planifiée spécifique.
```
aws redshift delete-scheduled-action \
--scheduled-action-name myscheduledaction
```
Cette commande ne génère pas de sortie.
+ Pour plus de détails sur l'API, reportez-vous [DeleteScheduledAction](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/delete-scheduled-action.html)à la section *Référence des AWS CLI commandes*.
### `delete-snapshot-copy-grant`
L'exemple de code suivant montre comment utiliser`delete-snapshot-copy-grant`.
**AWS CLI**
**Pour supprimer une autorisation de copie d’instantanés**
L’exemple `delete-snapshot-copy-grant` suivant supprime l’autorisation de copie d’instantanés spécifiée.
```
aws redshift delete-snapshot-copy-grant \
--snapshot-copy-grant-name mysnapshotcopygrantname
```
Cette commande ne génère pas de sortie.
Pour plus d’informations, consultez [Amazon Redshift Database Encryption](https://docs.aws.amazon.com/redshift/latest/mgmt/working-with-db-encryption.html) dans le *Guide de gestion du cluster Amazon Redshift*.
+ Pour plus de détails sur l'API, reportez-vous [DeleteSnapshotCopyGrant](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/delete-snapshot-copy-grant.html)à la section *Référence des AWS CLI commandes*.
### `delete-snapshot-schedule`
L'exemple de code suivant montre comment utiliser`delete-snapshot-schedule`.
**AWS CLI**
**Pour supprimer une planification d’instantané**
L’exemple `delete-snapshot-schedule` suivant supprime la planification d’instantané spécifiée. Vous devez dissocier les clusters avant de supprimer la planification.
```
aws redshift delete-snapshot-schedule \
--schedule-identifier mysnapshotschedule
```
Cette commande ne génère pas de sortie.
Pour plus d’informations, consultez [Planifications d’un instantané automatique](https://docs.aws.amazon.com/redshift/latest/mgmt/working-with-snapshots.html#automated-snapshot-schedules) dans le *Guide de gestion du cluster Amazon Redshift*.
+ Pour plus de détails sur l'API, reportez-vous [DeleteSnapshotSchedule](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/delete-snapshot-schedule.html)à la section *Référence des AWS CLI commandes*.
### `delete-tags`
L'exemple de code suivant montre comment utiliser`delete-tags`.
**AWS CLI**
**Pour supprimer les balises d’un cluster**
L’exemple `delete-tags` suivant supprime les balises portant les noms de clé spécifiés du cluster spécifié.
```
aws redshift delete-tags \
--resource-name arn:aws:redshift:us-west-2:123456789012:cluster:mycluster \
--tag-keys "clustertagkey" "clustertagvalue"
```
Cette commande ne génère pas de sortie.
Pour plus d’informations, consultez [Tagging Resources in Amazon Redshift](https://docs.aws.amazon.com/redshift/latest/mgmt/amazon-redshift-tagging.html) dans le *Guide de gestion du cluster Amazon Redshift*.
+ Pour plus de détails sur l'API, reportez-vous [DeleteTags](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/delete-tags.html)à la section *Référence des AWS CLI commandes*.
### `describe-account-attributes`
L'exemple de code suivant montre comment utiliser`describe-account-attributes`.
**AWS CLI**
**Pour décrire les attributs d'un AWS compte**
L'`describe-account-attributes`exemple suivant affiche les attributs associés au AWS compte d'appel.
```
aws redshift describe-account-attributes
```
Sortie :
```
{
"AccountAttributes": [
{
"AttributeName": "max-defer-maintenance-duration",
"AttributeValues": [
{
"AttributeValue": "45"
}
]
}
]
}
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeAccountAttributes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/describe-account-attributes.html)à la section *Référence des AWS CLI commandes*.
### `describe-cluster-db-revisions`
L'exemple de code suivant montre comment utiliser`describe-cluster-db-revisions`.
**AWS CLI**
**Pour décrire les révisions de base de données pour un cluster**
L’exemple `describe-cluster-db-revisions` suivant affiche les détails d’un tableau d’objets `ClusterDbRevision` pour le cluster spécifié.
```
aws redshift describe-cluster-db-revisions \
--cluster-identifier mycluster
```
Sortie :
```
{
"ClusterDbRevisions": [
{
"ClusterIdentifier": "mycluster",
"CurrentDatabaseRevision": "11420",
"DatabaseRevisionReleaseDate": "2019-11-22T16:43:49.597Z",
"RevisionTargets": []
}
]
}
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeClusterDbRevisions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/describe-cluster-db-revisions.html)à la section *Référence des AWS CLI commandes*.
### `describe-cluster-parameter-groups`
L'exemple de code suivant montre comment utiliser`describe-cluster-parameter-groups`.
**AWS CLI**
L' GroupsThis exemple Obtenir une description de tous les paramètres de cluster renvoie une description de tous les groupes de paramètres de cluster pour le compte, avec des en-têtes de colonne. JSON est le format de sortie par défaut. Commande :
```
aws redshift describe-cluster-parameter-groups
```
Résultat :
```
{
"ParameterGroups": [
{
"ParameterGroupFamily": "redshift-1.0",
"Description": "My first cluster parameter group",
"ParameterGroupName": "myclusterparametergroup"
} ],
"ResponseMetadata": {
"RequestId": "8ceb8f6f-64cc-11e2-bea9-49e0ce183f07"
}
}
```
Vous pouvez également obtenir les mêmes informations au format texte à l’aide de l’option `--output text`. Commande :
option `--output text`. Commande :
option. Commande :
```
aws redshift describe-cluster-parameter-groups --output text
```
Résultat :
```
redshift-1.0 My first cluster parameter group myclusterparametergroup
RESPONSEMETADATA 9e665a36-64cc-11e2-8f7d-3b939af52818
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeClusterParameterGroups](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/describe-cluster-parameter-groups.html)à la section *Référence des AWS CLI commandes*.
### `describe-cluster-parameters`
L'exemple de code suivant montre comment utiliser`describe-cluster-parameters`.
**AWS CLI**
L' GroupThis exemple de récupération des paramètres d'un paramètre de cluster spécifié permet de récupérer les paramètres du groupe de paramètres nommé. JSON est le format de sortie par défaut. Commande :
```
aws redshift describe-cluster-parameters --parameter-group-name myclusterparametergroup
```
Résultat :
```
{
"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...)
]
}
```
Vous pouvez également obtenir les mêmes informations au format texte à l’aide de l’option `--output text`. Commande :
option `--output text`. Commande :
option. Commande :
```
aws redshift describe-cluster-parameters --parameter-group-name myclusterparametergroup --output text
```
Résultat :
```
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
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeClusterParameters](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/describe-cluster-parameters.html)à la section *Référence des AWS CLI commandes*.
### `describe-cluster-security-groups`
L'exemple de code suivant montre comment utiliser`describe-cluster-security-groups`.
**AWS CLI**
L' GroupsThis exemple Get a Description of All Cluster Security renvoie une description de tous les groupes de sécurité du cluster pour le compte. JSON est le format de sortie par défaut. Commande :
```
aws redshift describe-cluster-security-groups
```
Résultat :
```
{
"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...)
]
}
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeClusterSecurityGroups](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/describe-cluster-security-groups.html)à la section *Référence des AWS CLI commandes*.
### `describe-cluster-snapshots`
L'exemple de code suivant montre comment utiliser`describe-cluster-snapshots`.
**AWS CLI**
L' SnapshotsThis exemple Get a Description of All Cluster renvoie une description de tous les instantanés du cluster pour le compte. JSON est le format de sortie par défaut. Commande :
```
aws redshift describe-cluster-snapshots
```
Résultat :
```
{
"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...)
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeClusterSnapshots](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/describe-cluster-snapshots.html)à la section *Référence des AWS CLI commandes*.
### `describe-cluster-subnet-groups`
L'exemple de code suivant montre comment utiliser`describe-cluster-subnet-groups`.
**AWS CLI**
L' GroupsThis exemple Obtenir une description de tous les sous-réseaux du cluster renvoie une description de tous les groupes de sous-réseaux du cluster. JSON est le format de sortie par défaut. Commande :
```
aws redshift describe-cluster-subnet-groups
```
Résultat :
```
{
"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"
}
}
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeClusterSubnetGroups](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/describe-cluster-subnet-groups.html)à la section *Référence des AWS CLI commandes*.
### `describe-cluster-tracks`
L'exemple de code suivant montre comment utiliser`describe-cluster-tracks`.
**AWS CLI**
**Pour décrire les suivis de cluster**
L’exemple `describe-cluster-tracks` suivant affiche les détails des suivis de maintenance disponibles.
```
aws redshift describe-cluster-tracks \
--maintenance-track-name current
```
Sortie :
```
{
"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"
}
]
}
]
}
]
}
```
Pour plus d’informations, consultez [Sélection du suivi de maintenance des clusters](https://docs.aws.amazon.com/redshift/latest/mgmt/working-with-clusters.html#rs-mgmt-maintenance-tracks) dans le *Guide de gestion du cluster Amazon Redshift*.
+ Pour plus de détails sur l'API, reportez-vous [DescribeClusterTracks](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/describe-cluster-tracks.html)à la section *Référence des AWS CLI commandes*.
### `describe-cluster-versions`
L'exemple de code suivant montre comment utiliser`describe-cluster-versions`.
**AWS CLI**
L' VersionsThis exemple Get a Description of All Cluster renvoie une description de toutes les versions du cluster. JSON est le format de sortie par défaut. Commande :
```
aws redshift describe-cluster-versions
```
Résultat :
```
{
"ClusterVersions": [
{
"ClusterVersion": "1.0",
"Description": "Initial release",
"ClusterParameterGroupFamily": "redshift-1.0"
} ],
"ResponseMetadata": {
"RequestId": "16a53de3-64cc-11e2-bec0-17624ad140dd"
}
}
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeClusterVersions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/describe-cluster-versions.html)à la section *Référence des AWS CLI commandes*.
### `describe-clusters`
L'exemple de code suivant montre comment utiliser`describe-clusters`.
**AWS CLI**
L' ClustersThis exemple Get a Description of All renvoie une description de tous les clusters du compte. JSON est le format de sortie par défaut. Commande :
```
aws redshift describe-clusters
```
Résultat :
```
{
"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"
}
}
```
Vous pouvez également obtenir les mêmes informations au format texte à l’aide de l’option `--output text`. Commande :
option `--output text`. Commande :
option. Commande :
```
aws redshift describe-clusters --output text
```
Résultat :
```
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
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeClusters](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/describe-clusters.html)à la section *Référence des AWS CLI commandes*.
### `describe-default-cluster-parameters`
L'exemple de code suivant montre comment utiliser`describe-default-cluster-parameters`.
**AWS CLI**
L' ParametersThis exemple Get a Description of Default Cluster renvoie une description des paramètres de cluster par défaut pour la `redshift-1.0` famille. JSON est le format de sortie par défaut. Commande :
```
aws redshift describe-default-cluster-parameters --parameter-group-family redshift-1.0
```
Résultat :
```
{
"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...)
]
}
}
```
Pour afficher la liste des familles de groupes de paramètres valides, utilisez la commande `describe-cluster-parameter-groups`.
Commande `describe-cluster-parameter-groups`.
commande.
+ Pour plus de détails sur l'API, reportez-vous [DescribeDefaultClusterParameters](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/describe-default-cluster-parameters.html)à la section *Référence des AWS CLI commandes*.
### `describe-event-categories`
L'exemple de code suivant montre comment utiliser`describe-event-categories`.
**AWS CLI**
**Pour décrire les catégories d’événement d’un cluster**
L’exemple `describe-event-categories` suivant affiche les détails sur les catégories d’événement d’un cluster.
```
aws redshift describe-event-categories \
--source-type cluster
```
Sortie :
```
{
"EventCategoriesMapList": [
{
"SourceType": "cluster",
"Events": [
{
"EventId": "REDSHIFT-EVENT-2000",
"EventCategories": [
"management"
],
"EventDescription": "Cluster created at