Utilisation de DescribeHosts avec une CLI

Les exemples de code suivants illustrent comment utiliser DescribeHosts.

CLI

AWS CLI

Pour afficher les informations sur des hôtes dédiés

L’exemple describe-hosts suivant affiche les informations sur les hôtes dédiés available dans votre compte AWS.

aws ec2 describe-hosts --filter "Name=state,Values=available"

Sortie :

{
    "Hosts": [
        {
            "HostId": "h-07879acf49EXAMPLE",
            "Tags": [
                {
                    "Value": "production",
                    "Key": "purpose"
                }
            ],
            "HostProperties": {
                "Cores": 48,
                "TotalVCpus": 96,
                "InstanceType": "m5.large",
                "Sockets": 2
            },
            "Instances": [],
            "State": "available",
            "AvailabilityZone": "eu-west-1a",
            "AvailableCapacity": {
                "AvailableInstanceCapacity": [
                    {
                        "AvailableCapacity": 48,
                        "InstanceType": "m5.large",
                        "TotalCapacity": 48
                    }
                ],
                "AvailableVCpus": 96
            },
            "HostRecovery": "on",
            "AllocationTime": "2019-08-19T08:57:44.000Z",
            "AutoPlacement": "off"
        }
    ]
}

Pour plus d’informations, consultez Affichage des hôtes dédiés dans le Guide de l’utilisateur Amazon Elastic Compute Cloud pour les instances Linux.

• Pour plus de détails sur l’API, consultez DescribeHosts dans la Référence des commandes de l’AWS CLI.

PowerShell

Outils pour PowerShell V4

Exemple 1 : cet exemple renvoie les détails de l’hôte EC2

Get-EC2Host

Sortie :

AllocationTime    : 3/23/2019 4:55:22 PM
AutoPlacement     : off
AvailabilityZone  : eu-west-1b
AvailableCapacity : Amazon.EC2.Model.AvailableCapacity
ClientToken       :
HostId            : h-01e23f4cd567890f1
HostProperties    : Amazon.EC2.Model.HostProperties
HostReservationId :
Instances         : {}
ReleaseTime       : 1/1/0001 12:00:00 AM
State             : available
Tags              : {}

Exemple 2 : cet exemple interroge AvailableInstanceCapacity pour l’hôte h-01e23f4cd567899f1

Get-EC2Host -HostId h-01e23f4cd567899f1 | Select-Object -ExpandProperty AvailableCapacity | Select-Object -expand AvailableInstanceCapacity

Sortie :

AvailableCapacity InstanceType TotalCapacity
----------------- ------------ -------------
11                m4.xlarge    11

• Pour plus de détails sur l’API, consultez DescribeHosts dans la Référence des applets de commande pour les Outils AWS pour PowerShell (V4).

Outils pour PowerShell V5

Exemple 1 : cet exemple renvoie les détails de l’hôte EC2

Get-EC2Host

Sortie :

AllocationTime    : 3/23/2019 4:55:22 PM
AutoPlacement     : off
AvailabilityZone  : eu-west-1b
AvailableCapacity : Amazon.EC2.Model.AvailableCapacity
ClientToken       :
HostId            : h-01e23f4cd567890f1
HostProperties    : Amazon.EC2.Model.HostProperties
HostReservationId :
Instances         : {}
ReleaseTime       : 1/1/0001 12:00:00 AM
State             : available
Tags              : {}

Exemple 2 : cet exemple interroge AvailableInstanceCapacity pour l’hôte h-01e23f4cd567899f1

Get-EC2Host -HostId h-01e23f4cd567899f1 | Select-Object -ExpandProperty AvailableCapacity | Select-Object -expand AvailableInstanceCapacity

Sortie :

AvailableCapacity InstanceType TotalCapacity
----------------- ------------ -------------
11                m4.xlarge    11

• Pour plus de détails sur l’API, consultez DescribeHosts dans la Référence des applets de commande pour les Outils AWS pour PowerShell (V5).