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'Elastic Beanstalk 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'Elastic Beanstalk.
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
### `abort-environment-update`
L'exemple de code suivant montre comment utiliser`abort-environment-update`.
**AWS CLI**
**Pour annuler un déploiement**
La commande suivante annule le déploiement d’une version d’application en cours d’exécution pour un environnement nommé `my-env` :
```
aws elasticbeanstalk abort-environment-update --environment-name my-env
```
+ Pour plus de détails sur l'API, reportez-vous [AbortEnvironmentUpdate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elasticbeanstalk/abort-environment-update.html)à la section *Référence des AWS CLI commandes*.
### `check-dns-availability`
L'exemple de code suivant montre comment utiliser`check-dns-availability`.
**AWS CLI**
**Pour vérifier la disponibilité d’un CNAME**
La commande suivante vérifie la disponibilité du sous-domaine `my-cname.elasticbeanstalk.com` :
```
aws elasticbeanstalk check-dns-availability --cname-prefix my-cname
```
Sortie :
```
{
"Available": true,
"FullyQualifiedCNAME": "my-cname.elasticbeanstalk.com"
}
```
+ Pour plus de détails sur l'API, reportez-vous [CheckDnsAvailability](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elasticbeanstalk/check-dns-availability.html)à la section *Référence des AWS CLI commandes*.
### `create-application-version`
L'exemple de code suivant montre comment utiliser`create-application-version`.
**AWS CLI**
**Pour créer une version d’application**
La commande suivante crée une nouvelle version, « v1 », d'une application nommée MyApp « » :
```
aws elasticbeanstalk create-application-version --application-name MyApp --version-label v1 --description MyAppv1 --source-bundle S3Bucket="amzn-s3-demo-bucket",S3Key="sample.war" --auto-create-application
```
L'application sera créée automatiquement si elle n'existe pas déjà, grâce à auto-create-application cette option. Le groupe source est un fichier .war stocké dans un compartiment S3 nommé « amzn-s3-demo-bucket » qui contient l’exemple d’application Apache Tomcat.
Sortie :
```
{
"ApplicationVersion": {
"ApplicationName": "MyApp",
"VersionLabel": "v1",
"Description": "MyAppv1",
"DateCreated": "2015-02-03T23:01:25.412Z",
"DateUpdated": "2015-02-03T23:01:25.412Z",
"SourceBundle": {
"S3Bucket": "amzn-s3-demo-bucket",
"S3Key": "sample.war"
}
}
}
```
+ Pour plus de détails sur l'API, reportez-vous [CreateApplicationVersion](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elasticbeanstalk/create-application-version.html)à la section *Référence des AWS CLI commandes*.
### `create-application`
L'exemple de code suivant montre comment utiliser`create-application`.
**AWS CLI**
**Pour créer une application**
La commande suivante crée une nouvelle application nommée MyApp « » :
```
aws elasticbeanstalk create-application --application-name MyApp --description "my application"
```
La commande `create-application` configure uniquement le nom et la description de l’application. Pour télécharger le code source de l’application, créez une version initiale de l’application à l’aide de`create-application-version`. `create-application-version` dispose également d’une option `auto-create-application` qui vous permet de créer l’application et la version de l’application en une seule étape.
Sortie :
```
{
"Application": {
"ApplicationName": "MyApp",
"ConfigurationTemplates": [],
"DateUpdated": "2015-02-12T18:32:21.181Z",
"Description": "my application",
"DateCreated": "2015-02-12T18:32:21.181Z"
}
}
```
+ Pour plus de détails sur l'API, reportez-vous [CreateApplication](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elasticbeanstalk/create-application.html)à la section *Référence des AWS CLI commandes*.
### `create-configuration-template`
L'exemple de code suivant montre comment utiliser`create-configuration-template`.
**AWS CLI**
**Pour créer un modèle de configuration**
La commande suivante crée un modèle de configuration nommé `my-app-v1` à partir des paramètres appliqués à un environnement portant l’ID `e-rpqsewtp2j` :
```
aws elasticbeanstalk create-configuration-template --application-name my-app --template-name my-app-v1 --environment-id e-rpqsewtp2j
```
Sortie :
```
{
"ApplicationName": "my-app",
"TemplateName": "my-app-v1",
"DateCreated": "2015-08-12T18:40:39Z",
"DateUpdated": "2015-08-12T18:40:39Z",
"SolutionStackName": "64bit Amazon Linux 2015.03 v2.0.0 running Tomcat 8 Java 8"
}
```
+ Pour plus de détails sur l'API, reportez-vous [CreateConfigurationTemplate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elasticbeanstalk/create-configuration-template.html)à la section *Référence des AWS CLI commandes*.
### `create-environment`
L'exemple de code suivant montre comment utiliser`create-environment`.
**AWS CLI**
**Pour créer un nouvel environnement pour une application**
La commande suivante crée un nouvel environnement pour la version « v1 » d’une application Java nommée « my-app » :
```
aws elasticbeanstalk create-environment --application-name my-app --environment-name my-env --cname-prefix my-app --version-label v1 --solution-stack-name "64bit Amazon Linux 2015.03 v2.0.0 running Tomcat 8 Java 8"
```
Sortie :
```
{
"ApplicationName": "my-app",
"EnvironmentName": "my-env",
"VersionLabel": "v1",
"Status": "Launching",
"EnvironmentId": "e-izqpassy4h",
"SolutionStackName": "64bit Amazon Linux 2015.03 v2.0.0 running Tomcat 8 Java 8",
"CNAME": "my-app.elasticbeanstalk.com",
"Health": "Grey",
"Tier": {
"Type": "Standard",
"Name": "WebServer",
"Version": " "
},
"DateUpdated": "2015-02-03T23:04:54.479Z",
"DateCreated": "2015-02-03T23:04:54.479Z"
}
```
`v1`est l'étiquette d'une version d'application précédemment téléchargée avec create-application-version.
**Pour spécifier un fichier JSON afin de définir les options de configuration de l’environnement**
La commande `create-environment` suivante indique qu’un fichier JSON portant le nom `myoptions.json` doit être utilisé pour remplacer les valeurs obtenues à partir de la pile de solutions ou du modèle de configuration :
```
aws elasticbeanstalk create-environment --environment-name sample-env --application-name sampleapp --option-settings file://myoptions.json
```
`myoptions.json` est un objet JSON définissant plusieurs paramètres :
```
[
{
"Namespace": "aws:elb:healthcheck",
"OptionName": "Interval",
"Value": "15"
},
{
"Namespace": "aws:elb:healthcheck",
"OptionName": "Timeout",
"Value": "8"
},
{
"Namespace": "aws:elb:healthcheck",
"OptionName": "HealthyThreshold",
"Value": "2"
},
{
"Namespace": "aws:elb:healthcheck",
"OptionName": "UnhealthyThreshold",
"Value": "3"
}
]
```
Pour plus d’informations, consultez Valeurs des options dans le *Guide du développeur AWS Elastic Beanstalk*.
+ Pour plus de détails sur l'API, reportez-vous [CreateEnvironment](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elasticbeanstalk/create-environment.html)à la section *Référence des AWS CLI commandes*.
### `create-storage-location`
L'exemple de code suivant montre comment utiliser`create-storage-location`.
**AWS CLI**
**Pour créer un emplacement de stockage**
La commande suivante crée un emplacement de stockage dans Amazon S3 :
```
aws elasticbeanstalk create-storage-location
```
Sortie :
```
{
"S3Bucket": "elasticbeanstalk-us-west-2-0123456789012"
}
```
+ Pour plus de détails sur l'API, reportez-vous [CreateStorageLocation](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elasticbeanstalk/create-storage-location.html)à la section *Référence des AWS CLI commandes*.
### `delete-application-version`
L'exemple de code suivant montre comment utiliser`delete-application-version`.
**AWS CLI**
**Pour supprimer une version d’application**
La commande suivante supprime une version d’application nommée `22a0-stage-150819_182129` pour une application nommée `my-app` :
```
aws elasticbeanstalk delete-application-version --version-label 22a0-stage-150819_182129 --application-name my-app
```
+ Pour plus de détails sur l'API, reportez-vous [DeleteApplicationVersion](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elasticbeanstalk/delete-application-version.html)à la section *Référence des AWS CLI commandes*.
### `delete-application`
L'exemple de code suivant montre comment utiliser`delete-application`.
**AWS CLI**
**Pour supprimer une application**
La commande suivante supprime une application nommée `my-app` :
```
aws elasticbeanstalk delete-application --application-name my-app
```
+ Pour plus de détails sur l'API, reportez-vous [DeleteApplication](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elasticbeanstalk/delete-application.html)à la section *Référence des AWS CLI commandes*.
### `delete-configuration-template`
L'exemple de code suivant montre comment utiliser`delete-configuration-template`.
**AWS CLI**
**Pour supprimer un modèle de configuration**
La commande suivante supprime un modèle de configuration nommé `my-template` pour une application nommée `my-app` :
```
aws elasticbeanstalk delete-configuration-template --template-name my-template --application-name my-app
```
+ Pour plus de détails sur l'API, reportez-vous [DeleteConfigurationTemplate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elasticbeanstalk/delete-configuration-template.html)à la section *Référence des AWS CLI commandes*.
### `delete-environment-configuration`
L'exemple de code suivant montre comment utiliser`delete-environment-configuration`.
**AWS CLI**
**Pour supprimer un brouillon de configuration**
La commande suivante permet de supprimer un projet de configuration pour un environnement nommé `my-env` :
```
aws elasticbeanstalk delete-environment-configuration --environment-name my-env --application-name my-app
```
+ Pour plus de détails sur l'API, reportez-vous [DeleteEnvironmentConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elasticbeanstalk/delete-environment-configuration.html)à la section *Référence des AWS CLI commandes*.
### `describe-application-versions`
L'exemple de code suivant montre comment utiliser`describe-application-versions`.
**AWS CLI**
**Pour afficher des informations sur une version d’application**
La commande suivante extrait des informations relatives à une version d’application intitulée `v2` :
```
aws elasticbeanstalk describe-application-versions --application-name my-app --version-label "v2"
```
Sortie :
```
{
"ApplicationVersions": [
{
"ApplicationName": "my-app",
"VersionLabel": "v2",
"Description": "update cover page",
"DateCreated": "2015-07-23T01:32:26.079Z",
"DateUpdated": "2015-07-23T01:32:26.079Z",
"SourceBundle": {
"S3Bucket": "elasticbeanstalk-us-west-2-015321684451",
"S3Key": "my-app/5026-stage-150723_224258.war"
}
},
{
"ApplicationName": "my-app",
"VersionLabel": "v1",
"Description": "initial version",
"DateCreated": "2015-07-23T22:26:10.816Z",
"DateUpdated": "2015-07-23T22:26:10.816Z",
"SourceBundle": {
"S3Bucket": "elasticbeanstalk-us-west-2-015321684451",
"S3Key": "my-app/5026-stage-150723_222618.war"
}
}
]
}
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeApplicationVersions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elasticbeanstalk/describe-application-versions.html)à la section *Référence des AWS CLI commandes*.
### `describe-applications`
L'exemple de code suivant montre comment utiliser`describe-applications`.
**AWS CLI**
**Pour afficher une liste des applications**
La commande suivante extrait des informations sur les applications de la région actuelle :
```
aws elasticbeanstalk describe-applications
```
Sortie :
```
{
"Applications": [
{
"ApplicationName": "ruby",
"ConfigurationTemplates": [],
"DateUpdated": "2015-08-13T21:05:44.376Z",
"Versions": [
"Sample Application"
],
"DateCreated": "2015-08-13T21:05:44.376Z"
},
{
"ApplicationName": "pythonsample",
"Description": "Application created from the EB CLI using \"eb init\"",
"Versions": [
"Sample Application"
],
"DateCreated": "2015-08-13T19:05:43.637Z",
"ConfigurationTemplates": [],
"DateUpdated": "2015-08-13T19:05:43.637Z"
},
{
"ApplicationName": "nodejs-example",
"ConfigurationTemplates": [],
"DateUpdated": "2015-08-06T17:50:02.486Z",
"Versions": [
"add elasticache",
"First Release"
],
"DateCreated": "2015-08-06T17:50:02.486Z"
}
]
}
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeApplications](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elasticbeanstalk/describe-applications.html)à la section *Référence des AWS CLI commandes*.
### `describe-configuration-options`
L'exemple de code suivant montre comment utiliser`describe-configuration-options`.
**AWS CLI**
**Pour afficher les options de configuration d’un environnement**
La commande suivante extrait des descriptions de toutes les options de configuration disponibles pour un environnement nommé `my-env` :
```
aws elasticbeanstalk describe-configuration-options --environment-name my-env --application-name my-app
```
Sortie (abrégée) :
```
{
"Options": [
{
"Name": "JVMOptions",
"UserDefined": false,
"DefaultValue": "Xms=256m,Xmx=256m,XX:MaxPermSize=64m,JVM Options=",
"ChangeSeverity": "RestartApplicationServer",
"Namespace": "aws:cloudformation:template:parameter",
"ValueType": "KeyValueList"
},
{
"Name": "Interval",
"UserDefined": false,
"DefaultValue": "30",
"ChangeSeverity": "NoInterruption",
"Namespace": "aws:elb:healthcheck",
"MaxValue": 300,
"MinValue": 5,
"ValueType": "Scalar"
},
...
{
"Name": "LowerThreshold",
"UserDefined": false,
"DefaultValue": "2000000",
"ChangeSeverity": "NoInterruption",
"Namespace": "aws:autoscaling:trigger",
"MinValue": 0,
"ValueType": "Scalar"
},
{
"Name": "ListenerEnabled",
"UserDefined": false,
"DefaultValue": "true",
"ChangeSeverity": "Unknown",
"Namespace": "aws:elb:listener",
"ValueType": "Boolean"
}
]
}
```
Les options de configuration disponibles varient en fonction de la plateforme et de la version de configuration. Pour plus d’informations sur les espaces de noms et les options prises en charge, consultez Option Values dans le *Guide du développeur AWS Elastic Beanstalk*.
+ Pour plus de détails sur l'API, reportez-vous [DescribeConfigurationOptions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elasticbeanstalk/describe-configuration-options.html)à la section *Référence des AWS CLI commandes*.
### `describe-configuration-settings`
L'exemple de code suivant montre comment utiliser`describe-configuration-settings`.
**AWS CLI**
**Pour afficher les paramètres de configuration d’un environnement**
La commande suivante extrait des paramètres de configuration d’un environnement nommé `my-env` :
```
aws elasticbeanstalk describe-configuration-settings --environment-name my-env --application-name my-app
```
Sortie (abrégée) :
```
{
"ConfigurationSettings": [
{
"ApplicationName": "my-app",
"EnvironmentName": "my-env",
"Description": "Environment created from the EB CLI using \"eb create\"",
"DeploymentStatus": "deployed",
"DateCreated": "2015-08-13T19:16:25Z",
"OptionSettings": [
{
"OptionName": "Availability Zones",
"ResourceName": "AWSEBAutoScalingGroup",
"Namespace": "aws:autoscaling:asg",
"Value": "Any"
},
{
"OptionName": "Cooldown",
"ResourceName": "AWSEBAutoScalingGroup",
"Namespace": "aws:autoscaling:asg",
"Value": "360"
},
...
{
"OptionName": "ConnectionDrainingTimeout",
"ResourceName": "AWSEBLoadBalancer",
"Namespace": "aws:elb:policies",
"Value": "20"
},
{
"OptionName": "ConnectionSettingIdleTimeout",
"ResourceName": "AWSEBLoadBalancer",
"Namespace": "aws:elb:policies",
"Value": "60"
}
],
"DateUpdated": "2015-08-13T23:30:07Z",
"SolutionStackName": "64bit Amazon Linux 2015.03 v2.0.0 running Tomcat 8 Java 8"
}
]
}
```
Pour plus d’informations sur les espaces de noms et les options prises en charge, consultez Option Values dans le *Guide du développeur AWS Elastic Beanstalk*.
+ Pour plus de détails sur l'API, reportez-vous [DescribeConfigurationSettings](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elasticbeanstalk/describe-configuration-settings.html)à la section *Référence des AWS CLI commandes*.
### `describe-environment-health`
L'exemple de code suivant montre comment utiliser`describe-environment-health`.
**AWS CLI**
**Pour consulter l’état de l’environnement**
La commande suivante extrait des informations sur l’état général d’un environnement nommé `my-env` :
```
aws elasticbeanstalk describe-environment-health --environment-name my-env --attribute-names All
```
Sortie :
```
{
"Status": "Ready",
"EnvironmentName": "my-env",
"Color": "Green",
"ApplicationMetrics": {
"Duration": 10,
"Latency": {
"P99": 0.004,
"P75": 0.002,
"P90": 0.003,
"P95": 0.004,
"P85": 0.003,
"P10": 0.001,
"P999": 0.004,
"P50": 0.001
},
"RequestCount": 45,
"StatusCodes": {
"Status3xx": 0,
"Status2xx": 45,
"Status5xx": 0,
"Status4xx": 0
}
},
"RefreshedAt": "2015-08-20T21:09:18Z",
"HealthStatus": "Ok",
"InstancesHealth": {
"Info": 0,
"Ok": 1,
"Unknown": 0,
"Severe": 0,
"Warning": 0,
"Degraded": 0,
"NoData": 0,
"Pending": 0
},
"Causes": []
}
```
Les informations sur l’état ne sont disponibles que pour les environnements dans lesquels les rapports améliorés sur l’état sont activés. Pour plus d’informations, consultez Surveillance et création de rapports d’intégrité améliorée dans le *Guide du développeur AWS Elastic Beanstalk*.
+ Pour plus de détails sur l'API, reportez-vous [DescribeEnvironmentHealth](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elasticbeanstalk/describe-environment-health.html)à la section *Référence des AWS CLI commandes*.
### `describe-environment-resources`
L'exemple de code suivant montre comment utiliser`describe-environment-resources`.
**AWS CLI**
**Pour consulter les informations relatives aux AWS ressources de votre environnement**
La commande suivante extrait des informations sur les ressources d’un environnement nommé `my-env` :
```
aws elasticbeanstalk describe-environment-resources --environment-name my-env
```
Sortie :
```
{
"EnvironmentResources": {
"EnvironmentName": "my-env",
"AutoScalingGroups": [
{
"Name": "awseb-e-qu3fyyjyjs-stack-AWSEBAutoScalingGroup-QSB2ZO88SXZT"
}
],
"Triggers": [],
"LoadBalancers": [
{
"Name": "awseb-e-q-AWSEBLoa-1EEPZ0K98BIF0"
}
],
"Queues": [],
"Instances": [
{
"Id": "i-0c91c786"
}
],
"LaunchConfigurations": [
{
"Name": "awseb-e-qu3fyyjyjs-stack-AWSEBAutoScalingLaunchConfiguration-1UUVQIBC96TQ2"
}
]
}
}
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeEnvironmentResources](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elasticbeanstalk/describe-environment-resources.html)à la section *Référence des AWS CLI commandes*.
### `describe-environments`
L'exemple de code suivant montre comment utiliser`describe-environments`.
**AWS CLI**
**Pour afficher des informations sur un environnement**
La commande suivante extrait des informations sur un environnement nommé `my-env` :
```
aws elasticbeanstalk describe-environments --environment-names my-env
```
Sortie :
```
{
"Environments": [
{
"ApplicationName": "my-app",
"EnvironmentName": "my-env",
"VersionLabel": "7f58-stage-150812_025409",
"Status": "Ready",
"EnvironmentId": "e-rpqsewtp2j",
"EndpointURL": "awseb-e-w-AWSEBLoa-1483140XB0Q4L-109QXY8121.us-west-2.elb.amazonaws.com",
"SolutionStackName": "64bit Amazon Linux 2015.03 v2.0.0 running Tomcat 8 Java 8",
"CNAME": "my-env.elasticbeanstalk.com",
"Health": "Green",
"AbortableOperationInProgress": false,
"Tier": {
"Version": " ",
"Type": "Standard",
"Name": "WebServer"
},
"DateUpdated": "2015-08-12T18:16:55.019Z",
"DateCreated": "2015-08-07T20:48:49.599Z"
}
]
}
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeEnvironments](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elasticbeanstalk/describe-environments.html)à la section *Référence des AWS CLI commandes*.
### `describe-events`
L'exemple de code suivant montre comment utiliser`describe-events`.
**AWS CLI**
**Pour afficher les événements relatifs à un environnement**
La commande suivante extrait des événements pour un environnement nommé `my-env` :
```
aws elasticbeanstalk describe-events --environment-name my-env
```
Sortie (abrégée) :
```
{
"Events": [
{
"ApplicationName": "my-app",
"EnvironmentName": "my-env",
"Message": "Environment health has transitioned from Info to Ok.",
"EventDate": "2015-08-20T07:06:53.535Z",
"Severity": "INFO"
},
{
"ApplicationName": "my-app",
"EnvironmentName": "my-env",
"Severity": "INFO",
"RequestId": "b7f3960b-4709-11e5-ba1e-07e16200da41",
"Message": "Environment update completed successfully.",
"EventDate": "2015-08-20T07:06:02.049Z"
},
...
{
"ApplicationName": "my-app",
"EnvironmentName": "my-env",
"Severity": "INFO",
"RequestId": "ca8dfbf6-41ef-11e5-988b-651aa638f46b",
"Message": "Using elasticbeanstalk-us-west-2-012445113685 as Amazon S3 storage bucket for environment data.",
"EventDate": "2015-08-13T19:16:27.561Z"
},
{
"ApplicationName": "my-app",
"EnvironmentName": "my-env",
"Severity": "INFO",
"RequestId": "cdfba8f6-41ef-11e5-988b-65638f41aa6b",
"Message": "createEnvironment is starting.",
"EventDate": "2015-08-13T19:16:26.581Z"
}
]
}
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeEvents](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elasticbeanstalk/describe-events.html)à la section *Référence des AWS CLI commandes*.
### `describe-instances-health`
L'exemple de code suivant montre comment utiliser`describe-instances-health`.
**AWS CLI**
**Pour consulter l’état de l’environnement**
La commande suivante extrait des informations sur l’état d’instances dans un environnement nommé `my-env` :
```
aws elasticbeanstalk describe-instances-health --environment-name my-env --attribute-names All
```
Sortie :
```
{
"InstanceHealthList": [
{
"InstanceId": "i-08691cc7",
"ApplicationMetrics": {
"Duration": 10,
"Latency": {
"P99": 0.006,
"P75": 0.002,
"P90": 0.004,
"P95": 0.005,
"P85": 0.003,
"P10": 0.0,
"P999": 0.006,
"P50": 0.001
},
"RequestCount": 48,
"StatusCodes": {
"Status3xx": 0,
"Status2xx": 47,
"Status5xx": 0,
"Status4xx": 1
}
},
"System": {
"LoadAverage": [
0.0,
0.02,
0.05
],
"CPUUtilization": {
"SoftIRQ": 0.1,
"IOWait": 0.2,
"System": 0.3,
"Idle": 97.8,
"User": 1.5,
"IRQ": 0.0,
"Nice": 0.1
}
},
"Color": "Green",
"HealthStatus": "Ok",
"LaunchedAt": "2015-08-13T19:17:09Z",
"Causes": []
}
],
"RefreshedAt": "2015-08-20T21:09:08Z"
}
```
Les informations sur l’état ne sont disponibles que pour les environnements dans lesquels les rapports améliorés sur l’état sont activés. Pour plus d’informations, consultez Surveillance et création de rapports d’intégrité améliorée dans le *Guide du développeur AWS Elastic Beanstalk*.
+ Pour plus de détails sur l'API, reportez-vous [DescribeInstancesHealth](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elasticbeanstalk/describe-instances-health.html)à la section *Référence des AWS CLI commandes*.
### `list-available-solution-stacks`
L'exemple de code suivant montre comment utiliser`list-available-solution-stacks`.
**AWS CLI**
**Pour afficher les piles de solutions**
La commande suivante répertorie les piles de solutions pour toutes les configurations de plateforme actuellement disponibles et celles que vous avez utilisées dans le passé :
```
aws elasticbeanstalk list-available-solution-stacks
```
Sortie (abrégée) :
```
{
"SolutionStacks": [
"64bit Amazon Linux 2015.03 v2.0.0 running Node.js",
"64bit Amazon Linux 2015.03 v2.0.0 running PHP 5.6",
"64bit Amazon Linux 2015.03 v2.0.0 running PHP 5.5",
"64bit Amazon Linux 2015.03 v2.0.0 running PHP 5.4",
"64bit Amazon Linux 2015.03 v2.0.0 running Python 3.4",
"64bit Amazon Linux 2015.03 v2.0.0 running Python 2.7",
"64bit Amazon Linux 2015.03 v2.0.0 running Python",
"64bit Amazon Linux 2015.03 v2.0.0 running Ruby 2.2 (Puma)",
"64bit Amazon Linux 2015.03 v2.0.0 running Ruby 2.2 (Passenger Standalone)",
"64bit Amazon Linux 2015.03 v2.0.0 running Ruby 2.1 (Puma)",
"64bit Amazon Linux 2015.03 v2.0.0 running Ruby 2.1 (Passenger Standalone)",
"64bit Amazon Linux 2015.03 v2.0.0 running Ruby 2.0 (Puma)",
"64bit Amazon Linux 2015.03 v2.0.0 running Ruby 2.0 (Passenger Standalone)",
"64bit Amazon Linux 2015.03 v2.0.0 running Ruby 1.9.3",
"64bit Amazon Linux 2015.03 v2.0.0 running Tomcat 8 Java 8",
"64bit Amazon Linux 2015.03 v2.0.0 running Tomcat 7 Java 7",
"64bit Amazon Linux 2015.03 v2.0.0 running Tomcat 7 Java 6",
"64bit Windows Server Core 2012 R2 running IIS 8.5",
"64bit Windows Server 2012 R2 running IIS 8.5",
"64bit Windows Server 2012 running IIS 8",
"64bit Windows Server 2008 R2 running IIS 7.5",
"64bit Amazon Linux 2015.03 v2.0.0 running Docker 1.6.2",
"64bit Amazon Linux 2015.03 v2.0.0 running Multi-container Docker 1.6.2 (Generic)",
"64bit Debian jessie v2.0.0 running GlassFish 4.1 Java 8 (Preconfigured - Docker)",
"64bit Debian jessie v2.0.0 running GlassFish 4.0 Java 7 (Preconfigured - Docker)",
"64bit Debian jessie v2.0.0 running Go 1.4 (Preconfigured - Docker)",
"64bit Debian jessie v2.0.0 running Go 1.3 (Preconfigured - Docker)",
"64bit Debian jessie v2.0.0 running Python 3.4 (Preconfigured - Docker)",
],
"SolutionStackDetails": [
{
"PermittedFileTypes": [
"zip"
],
"SolutionStackName": "64bit Amazon Linux 2015.03 v2.0.0 running Node.js"
},
...
]
}
```
+ Pour plus de détails sur l'API, reportez-vous [ListAvailableSolutionStacks](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elasticbeanstalk/list-available-solution-stacks.html)à la section *Référence des AWS CLI commandes*.
### `rebuild-environment`
L'exemple de code suivant montre comment utiliser`rebuild-environment`.
**AWS CLI**
**Pour reconstruire un environnement**
La commande suivante résilie et recrée les ressources dans un environnement nommé `my-env` :
```
aws elasticbeanstalk rebuild-environment --environment-name my-env
```
+ Pour plus de détails sur l'API, reportez-vous [RebuildEnvironment](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elasticbeanstalk/rebuild-environment.html)à la section *Référence des AWS CLI commandes*.
### `request-environment-info`
L'exemple de code suivant montre comment utiliser`request-environment-info`.
**AWS CLI**
**Pour demander des journaux suivis**
La commande suivante demande des journaux d’un environnement nommé `my-env` :
```
aws elasticbeanstalk request-environment-info --environment-name my-env --info-type tail
```
Après avoir demandé les journaux, récupérez leur emplacement avec retrieve-environment-info.
+ Pour plus de détails sur l'API, voir [RequestEnvironmentInfo](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elasticbeanstalk/request-environment-info.html)la section *Référence des AWS CLI commandes*.
### `restart-app-server`
L'exemple de code suivant montre comment utiliser`restart-app-server`.
**AWS CLI**
**Pour redémarrer les serveurs d’applications**
La commande suivante redémarre les serveurs d’applications sur toutes les instances d’un environnement nommé `my-env` :
```
aws elasticbeanstalk restart-app-server --environment-name my-env
```
+ Pour plus de détails sur l'API, voir [RestartAppServer](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elasticbeanstalk/restart-app-server.html)la section *Référence des AWS CLI commandes*.
### `retrieve-environment-info`
L'exemple de code suivant montre comment utiliser`retrieve-environment-info`.
**AWS CLI**
**Pour extraire des journaux suivis**
La commande suivante extrait un lien vers les journaux d’un environnement nommé `my-env` :
```
aws elasticbeanstalk retrieve-environment-info --environment-name my-env --info-type tail
```
Sortie :
```
{
"EnvironmentInfo": [
{
"SampleTimestamp": "2015-08-20T22:23:17.703Z",
"Message": "https://elasticbeanstalk-us-west-2-0123456789012.s3.amazonaws.com/resources/environments/logs/tail/e-fyqyju3yjs/i-09c1c867/TailLogs-1440109397703.out?AWSAccessKeyId=AKGPT4J56IAJ2EUBL5CQ&Expires=1440195891&Signature=n%2BEalOV6A2HIOx4Rcfb7LT16bBM%3D",
"InfoType": "tail",
"Ec2InstanceId": "i-09c1c867"
}
]
}
```
Affichez le lien dans un navigateur. Avant de les récupérer, les journaux doivent être demandés auprès request-environment-info de.
+ Pour plus de détails sur l'API, voir [RetrieveEnvironmentInfo](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elasticbeanstalk/retrieve-environment-info.html)la section *Référence des AWS CLI commandes*.
### `swap-environment-cnames`
L'exemple de code suivant montre comment utiliser`swap-environment-cnames`.
**AWS CLI**
**Pour échanger des CNAME d’environnement**
La commande suivante échange les sous-domaines assignés de deux environnements :
```
aws elasticbeanstalk swap-environment-cnames --source-environment-name my-env-blue --destination-environment-name my-env-green
```
+ Pour plus de détails sur l'API, voir [SwapEnvironmentCnames](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elasticbeanstalk/swap-environment-cnames.html)la section *Référence des AWS CLI commandes*.
### `terminate-environment`
L'exemple de code suivant montre comment utiliser`terminate-environment`.
**AWS CLI**
**Pour mettre fin à un environnement**
La commande suivante résilie un environnement Elastic Beanstalk nommé `my-env` :
```
aws elasticbeanstalk terminate-environment --environment-name my-env
```
Sortie :
```
{
"ApplicationName": "my-app",
"EnvironmentName": "my-env",
"Status": "Terminating",
"EnvironmentId": "e-fh2eravpns",
"EndpointURL": "awseb-e-f-AWSEBLoa-1I9XUMP4-8492WNUP202574.us-west-2.elb.amazonaws.com",
"SolutionStackName": "64bit Amazon Linux 2015.03 v2.0.0 running Tomcat 8 Java 8",
"CNAME": "my-env.elasticbeanstalk.com",
"Health": "Grey",
"AbortableOperationInProgress": false,
"Tier": {
"Version": " ",
"Type": "Standard",
"Name": "WebServer"
},
"DateUpdated": "2015-08-12T19:05:54.744Z",
"DateCreated": "2015-08-12T18:52:53.622Z"
}
```
+ Pour plus de détails sur l'API, voir [TerminateEnvironment](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elasticbeanstalk/terminate-environment.html)la section *Référence des AWS CLI commandes*.
### `update-application-version`
L'exemple de code suivant montre comment utiliser`update-application-version`.
**AWS CLI**
**Pour modifier la description de la version d’une application**
La commande suivante met à jour la description d’une version d’application nommée `22a0-stage-150819_185942` :
```
aws elasticbeanstalk update-application-version --version-label 22a0-stage-150819_185942 --application-name my-app --description "new description"
```
Sortie :
```
{
"ApplicationVersion": {
"ApplicationName": "my-app",
"VersionLabel": "22a0-stage-150819_185942",
"Description": "new description",
"DateCreated": "2015-08-19T18:59:17.646Z",
"DateUpdated": "2015-08-20T22:53:28.871Z",
"SourceBundle": {
"S3Bucket": "elasticbeanstalk-us-west-2-0123456789012",
"S3Key": "my-app/22a0-stage-150819_185942.war"
}
}
}
```
+ Pour plus de détails sur l'API, voir [UpdateApplicationVersion](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elasticbeanstalk/update-application-version.html)la section *Référence des AWS CLI commandes*.
### `update-application`
L'exemple de code suivant montre comment utiliser`update-application`.
**AWS CLI**
**Pour modifier la description d’une application**
La commande suivante met à jour la description d’une application nommée `my-app` :
```
aws elasticbeanstalk update-application --application-name my-app --description "my Elastic Beanstalk application"
```
Sortie :
```
{
"Application": {
"ApplicationName": "my-app",
"Description": "my Elastic Beanstalk application",
"Versions": [
"2fba-stage-150819_234450",
"bf07-stage-150820_214945",
"93f8",
"fd7c-stage-150820_000431",
"22a0-stage-150819_185942"
],
"DateCreated": "2015-08-13T19:15:50.449Z",
"ConfigurationTemplates": [],
"DateUpdated": "2015-08-20T22:34:56.195Z"
}
}
```
+ Pour plus de détails sur l'API, voir [UpdateApplication](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elasticbeanstalk/update-application.html)la section *Référence des AWS CLI commandes*.
### `update-configuration-template`
L'exemple de code suivant montre comment utiliser`update-configuration-template`.
**AWS CLI**
**Pour mettre à jour un modèle de configuration**
La commande suivante supprime la configuration des métriques de santé CloudWatch personnalisées configurée `ConfigDocument` d'un modèle de configuration enregistré nommé `my-template` :
```
aws elasticbeanstalk update-configuration-template --template-name my-template --application-name my-app --options-to-remove Namespace=aws:elasticbeanstalk:healthreporting:system,OptionName=ConfigDocument
```
Sortie :
```
{
"ApplicationName": "my-app",
"TemplateName": "my-template",
"DateCreated": "2015-08-20T22:39:31Z",
"DateUpdated": "2015-08-20T22:43:11Z",
"SolutionStackName": "64bit Amazon Linux 2015.03 v2.0.0 running Tomcat 8 Java 8"
}
```
Pour plus d’informations sur les espaces de noms et les options prises en charge, consultez Option Values dans le *Guide du développeur AWS Elastic Beanstalk*.
+ Pour plus de détails sur l'API, voir [UpdateConfigurationTemplate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elasticbeanstalk/update-configuration-template.html)la section *Référence des AWS CLI commandes*.
### `update-environment`
L'exemple de code suivant montre comment utiliser`update-environment`.
**AWS CLI**
**Pour mettre à jour un environnement vers une nouvelle version**
La commande suivante met à jour un environnement nommé « my-env » vers la version « v2 » de l’application à laquelle il appartient :
```
aws elasticbeanstalk update-environment --environment-name my-env --version-label v2
```
Cette commande nécessite que l’environnement « my-env » existe déjà et appartienne à une application dont la version d’application est valide et porte l’étiquette « v2 ».
Sortie :
```
{
"ApplicationName": "my-app",
"EnvironmentName": "my-env",
"VersionLabel": "v2",
"Status": "Updating",
"EnvironmentId": "e-szqipays4h",
"EndpointURL": "awseb-e-i-AWSEBLoa-1RDLX6TC9VUAO-0123456789.us-west-2.elb.amazonaws.com",
"SolutionStackName": "64bit Amazon Linux running Tomcat 7",
"CNAME": "my-env.elasticbeanstalk.com",
"Health": "Grey",
"Tier": {
"Version": " ",
"Type": "Standard",
"Name": "WebServer"
},
"DateUpdated": "2015-02-03T23:12:29.119Z",
"DateCreated": "2015-02-03T23:04:54.453Z"
}
```
**Pour définir une variable d’environnement**
La commande suivante définit la valeur de la variable « PARAM1 » dans l'environnement « my-env » sur « » : ParamValue
```
aws elasticbeanstalk update-environment --environment-name my-env --option-settings Namespace=aws:elasticbeanstalk:application:environment,OptionName=PARAM1,Value=ParamValue
```
Le paramètre `option-settings` prend un espace de noms en plus du nom et de la valeur de la variable. Elastic Beanstalk prend en charge plusieurs espaces de noms pour les options en plus des variables d’environnement.
**Pour configurer les paramètres d’option à partir d’un fichier**
La commande suivante configure plusieurs options dans l’espace de noms `aws:elb:loadbalancer` à partir d’un fichier :
```
aws elasticbeanstalk update-environment --environment-name my-env --option-settings file://options.json
```
`options.json` est un objet JSON définissant plusieurs paramètres :
```
[
{
"Namespace": "aws:elb:healthcheck",
"OptionName": "Interval",
"Value": "15"
},
{
"Namespace": "aws:elb:healthcheck",
"OptionName": "Timeout",
"Value": "8"
},
{
"Namespace": "aws:elb:healthcheck",
"OptionName": "HealthyThreshold",
"Value": "2"
},
{
"Namespace": "aws:elb:healthcheck",
"OptionName": "UnhealthyThreshold",
"Value": "3"
}
]
```
Sortie :
```
{
"ApplicationName": "my-app",
"EnvironmentName": "my-env",
"VersionLabel": "7f58-stage-150812_025409",
"Status": "Updating",
"EnvironmentId": "e-wtp2rpqsej",
"EndpointURL": "awseb-e-w-AWSEBLoa-14XB83101Q4L-104QXY80921.sa-east-1.elb.amazonaws.com",
"SolutionStackName": "64bit Amazon Linux 2015.03 v2.0.0 running Tomcat 8 Java 8",
"CNAME": "my-env.elasticbeanstalk.com",
"Health": "Grey",
"AbortableOperationInProgress": true,
"Tier": {
"Version": " ",
"Type": "Standard",
"Name": "WebServer"
},
"DateUpdated": "2015-08-12T18:15:23.804Z",
"DateCreated": "2015-08-07T20:48:49.599Z"
}
```
Pour plus d’informations sur les espaces de noms et les options prises en charge, consultez Option Values dans le *Guide du développeur AWS Elastic Beanstalk*.
+ Pour plus de détails sur l'API, voir [UpdateEnvironment](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elasticbeanstalk/update-environment.html)la section *Référence des AWS CLI commandes*.
### `validate-configuration-settings`
L'exemple de code suivant montre comment utiliser`validate-configuration-settings`.
**AWS CLI**
**Pour valider les paramètres de configuration**
La commande suivante valide un document de configuration de métriques CloudWatch personnalisé :
```
aws elasticbeanstalk validate-configuration-settings --application-name my-app --environment-name my-env --option-settings file://options.json
```
`options.json` est un document JSON qui inclut un ou plusieurs paramètres de configuration à valider :
```
[
{
"Namespace": "aws:elasticbeanstalk:healthreporting:system",
"OptionName": "ConfigDocument",
"Value": "{\"CloudWatchMetrics\": {\"Environment\": {\"ApplicationLatencyP99.9\": null,\"InstancesSevere\": 60,\"ApplicationLatencyP90\": 60,\"ApplicationLatencyP99\": null,\"ApplicationLatencyP95\": 60,\"InstancesUnknown\": 60,\"ApplicationLatencyP85\": 60,\"InstancesInfo\": null,\"ApplicationRequests2xx\": null,\"InstancesDegraded\": null,\"InstancesWarning\": 60,\"ApplicationLatencyP50\": 60,\"ApplicationRequestsTotal\": null,\"InstancesNoData\": null,\"InstancesPending\": 60,\"ApplicationLatencyP10\": null,\"ApplicationRequests5xx\": null,\"ApplicationLatencyP75\": null,\"InstancesOk\": 60,\"ApplicationRequests3xx\": null,\"ApplicationRequests4xx\": null},\"Instance\": {\"ApplicationLatencyP99.9\": null,\"ApplicationLatencyP90\": 60,\"ApplicationLatencyP99\": null,\"ApplicationLatencyP95\": null,\"ApplicationLatencyP85\": null,\"CPUUser\": 60,\"ApplicationRequests2xx\": null,\"CPUIdle\": null,\"ApplicationLatencyP50\": null,\"ApplicationRequestsTotal\": 60,\"RootFilesystemUtil\": null,\"LoadAverage1min\": null,\"CPUIrq\": null,\"CPUNice\": 60,\"CPUIowait\": 60,\"ApplicationLatencyP10\": null,\"LoadAverage5min\": null,\"ApplicationRequests5xx\": null,\"ApplicationLatencyP75\": 60,\"CPUSystem\": 60,\"ApplicationRequests3xx\": 60,\"ApplicationRequests4xx\": null,\"InstanceHealth\": null,\"CPUSoftirq\": 60}},\"Version\": 1}"
}
]
```
Si les options que vous spécifiez sont valides pour l’environnement spécifié, Elastic Beanstalk renvoie un tableau de messages vide :
```
{
"Messages": []
}
```
Si la validation échoue, la réponse inclura des informations sur l’erreur :
```
{
"Messages": [
{
"OptionName": "ConfigDocumet",
"Message": "Invalid option specification (Namespace: 'aws:elasticbeanstalk:healthreporting:system', OptionName: 'ConfigDocumet'): Unknown configuration setting.",
"Namespace": "aws:elasticbeanstalk:healthreporting:system",
"Severity": "error"
}
]
}
```
Pour plus d’informations sur les espaces de noms et les options prises en charge, consultez Option Values dans le *Guide du développeur AWS Elastic Beanstalk*.
+ Pour plus de détails sur l'API, voir [ValidateConfigurationSettings](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elasticbeanstalk/validate-configuration-settings.html)la section *Référence des AWS CLI commandes*.