View a markdown version of this page

CloudWatch exemples utilisant Tools for PowerShell V5 - Outils AWS pour PowerShell (version 5)
Actions

La version 5 (V5) du Outils AWS pour PowerShell est sortie !

Pour plus d'informations sur l'interruption des modifications et la migration de vos applications, consultez la rubrique sur la migration.

Orange button with text "Click here for details".

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.

CloudWatch exemples utilisant Tools for PowerShell V5

Les exemples de code suivants vous montrent comment effectuer des actions et implémenter des scénarios courants à l'aide de la Outils AWS pour PowerShell V5 avec CloudWatch.

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.

Rubriques

Actions

L’exemple de code suivant montre comment utiliser Get-CWDashboard.

Outils pour PowerShell V5

Exemple 1 : renvoie l’ARN dans le corps du tableau de bord spécifié.

Get-CWDashboard -DashboardName Dashboard1

Sortie :

DashboardArn                                          DashboardBody
------------                                          -------------
arn:aws:cloudwatch::123456789012:dashboard/Dashboard1 {...

  • Pour plus de détails sur l'API, consultez GetDashboard la section Outils AWS pour PowerShell Cmdlet Reference (V5).

L’exemple de code suivant montre comment utiliser Get-CWDashboardList.

Outils pour PowerShell V5

Exemple 1 : renvoie la collection de tableaux de bord pour votre compte.

Get-CWDashboardList

Sortie :

DashboardArn DashboardName LastModified        Size
------------ ------------- ------------        ----
arn:...      Dashboard1    7/6/2017 8:14:15 PM 252

Exemple 2 : renvoie la collection de tableaux de bord de votre compte dont le nom commence par le préfixe « dev’.

Get-CWDashboardList -DashboardNamePrefix dev

  • Pour plus de détails sur l'API, consultez ListDashboards la section Outils AWS pour PowerShell Cmdlet Reference (V5).

L’exemple de code suivant montre comment utiliser Remove-CWDashboard.

Outils pour PowerShell V5

Exemple 1 : supprime le tableau de bord spécifié, en le promouvant pour confirmation avant de continuer. Pour contourner la confirmation, ajoutez le commutateur -Force à la commande.

Remove-CWDashboard -DashboardName Dashboard1

  • Pour plus de détails sur l'API, consultez DeleteDashboards la section Outils AWS pour PowerShell Cmdlet Reference (V5).

L’exemple de code suivant montre comment utiliser Write-CWDashboard.

Outils pour PowerShell V5

Exemple 1 : crée ou met à jour le tableau de bord nommé « Dashboard1 » pour y inclure deux widgets de métriques placés côte à côte.

$dashBody = @"
{
    "widgets":[
        {
             "type":"metric",
             "x":0,
             "y":0,
             "width":12,
             "height":6,
             "properties":{
                "metrics":[
                   [
                      "AWS/EC2",
                      "CPUUtilization",
                      "InstanceId",
                      "i-012345"
                   ]
                ],
                "period":300,
                "stat":"Average",
                "region":"us-east-1",
                "title":"EC2 Instance CPU"
             }
        },
        {
             "type":"metric",
             "x":12,
             "y":0,
             "width":12,
             "height":6,
             "properties":{
                "metrics":[
                   [
                      "AWS/S3",
                      "BucketSizeBytes",
                      "BucketName",
                      "amzn-s3-demo-bucket"
                   ]
                ],
                "period":86400,
                "stat":"Maximum",
                "region":"us-east-1",
                "title":"amzn-s3-demo-bucket bytes"
            }
        }
    ]
}
"@

Write-CWDashboard -DashboardName Dashboard1 -DashboardBody $dashBody

Exemple 2 : crée ou met à jour le tableau de bord en transmettant son contenu descriptif à l’applet de commande.

$dashBody = @"
{
...
}
"@
        
$dashBody | Write-CWDashboard -DashboardName Dashboard1

  • Pour plus de détails sur l'API, consultez PutDashboard la section Outils AWS pour PowerShell Cmdlet Reference (V5).

L’exemple de code suivant montre comment utiliser Write-CWMetricData.

Outils pour PowerShell V5

Exemple 1 : crée un nouvel MetricDatum objet et l'écrit dans Amazon Web Services CloudWatch Metrics. 

### Create a MetricDatum .NET object
$Metric = New-Object -TypeName Amazon.CloudWatch.Model.MetricDatum
$Metric.Timestamp = [DateTime]::UtcNow
$Metric.MetricName = 'CPU'
$Metric.Value = 50

### Write the metric data to the CloudWatch service
Write-CWMetricData -Namespace instance1 -MetricData $Metric

  • Pour plus de détails sur l'API, consultez PutMetricData la section Outils AWS pour PowerShell Cmdlet Reference (V5).