Obtenir des informations sur vos subnets

Vous pouvez obtenir des informations à propos d’un ou plusieurs de vos subnets, comme le Virtual Private Cloud (VPC) dans lequel ils sont, leur bloc CIDR ou leur Availability Zone (AZ).

Si vous dépassez le nombre autorisé de requêtes identiques pour une durée configurée, le message d’erreur RequestLimitExceeded est renvoyé.

Cette procédure utilise uniquement AWS CLI. Des informations sur vos subnets sont également disponibles :

Pour obtenir des informations sur un ou plusieurs de vos subnets, utilisez la commande describe-subnets suivant cette syntaxe :

Exemple de requête
$ aws ec2 describe-subnets \
    --profile YOUR_PROFILE \
    [--subnet-ids NOT_SPECIFIED] \
    --filters [
               {
                "Name": "vpc-id",
                "Values": "vpc-12345678"
               },
               {
                "Name": "state",
                "Values": "available"
               }
             ] \
    --endpoint https://fcu.eu-west-2.outscale.com

Cette commande contient les attributs suivants que vous devez spécifier :

  • (optionnel) profile : Le profil nommé que vous voulez utiliser, créé pendant la configuration d’AWS CLI. Pour en savoir plus, voir Utiliser et configurer AWS CLI.

  • (optionnel) subnet-ids : Un ou plusieurs ID de subnets.

    Si vous ne spécifiez aucun ID de subnet, l’ensemble de vos subnets ou tous les subnets correspondant aux filtres que vous avez spécifiés (le cas échéant) sont décrits.

  • (optionnel) filters : Un ou plusieurs filtres, au format "Name=X,Values=Y".

    Vous pouvez spécifier plusieurs valeurs pour un même filtre en utilisant le format "Name=X,Values=Y, Z".

    Les filtres suivants sont disponibles :

    • subnet-id : L’ID du subnet.

    • vpc-id : L’ID du VPC dans lequel est le subnet.

    • state : L’état du subnet (pending | available). Pour en savoir plus, voir À propos des VPC.

    • cidr : Le bloc CIDR exact du subnet (similaire à cidr-block)

    • cidr-block : Le bloc CIDR exact du subnet (similaire à cidr).

    • available-ip-address-count : Le nombre d’IP disponibles dans le subnet.

    • availability-zone : L’AZ dans laquelle le subnet se trouve.

  • endpoint : Le endpoint correspondant à la Région à laquelle vous voulez envoyer la requête.

La commande describe-subnets renvoie les éléments suivants :

  • Subnets : Informations à propos d’un ou plusieurs subnets. Cet élément contient les informations suivantes :

    • VpcId : Le VPC dans lequel est le subnet.

    • CidrBlock : La plage d’IP pour le subnet, en notation CIDR.

    • State : L’état du VPC. Pour en savoir plus, voir À propos des VPC.

    • AvailabilityZone : L’AZ dans laquelle le subnet se trouve.

    • SubnetId : L’ID du subnet.

    • AvailableIpAddressCount : Le nombre d’IP disponibles dans le subnet.

    • MapPublicIpOnLaunch : Indique si une IP est attribuée aux instances lancées dans le subnet.

Exemple de résultat
{
    "Subnets": [
        {
            "VpcId": "vpc-12345678",
            "CidrBlock": "10.0.1.0/24",
            "State": "available",
            "AvailabilityZone": "eu-west-2a",
            "SubnetId": "subnet-1234abcd",
            "AvailableIpAddressCount": 242,
            "MapPublicIpOnLaunch": false
        },
        {
            "VpcId": "vpc-12345678",
            "CidrBlock": "10.0.2.0/24",
            "State": "available",
            "AvailabilityZone": "eu-west-2b",
            "SubnetId": "subnet-4321dcba",
            "AvailableIpAddressCount": 243,
            "MapPublicIpOnLaunch": false
        }
    ]
}

Pages connexes

Méthode API correspondante

AWS™ et Amazon Web Services™ sont des marques de commerce d'Amazon Technologies, Inc. ou de ses affiliées aux États-Unis et/ou dans les autres pays.