Obtenir des informations sur vos Subnets

Vous pouvez obtenir des informations à propos d’un ou plusieurs de vos Subnets, comme le Net dans lequel ils sont, leur bloc CIDR ou leur Sous-région.

Des informations sur vos Subnets sont également disponibles depuis les machines virtuelles (VM) elles-mêmes. Pour en savoir plus, voir Accéder aux metadata et user data d’une VM.

Obtenir des informations sur vos Subnets avec Cockpit v2

Voir le dashboard Nets.

Obtenir des informations sur vos Subnets avec OSC CLI

À ce jour, cette section est disponible en anglais uniquement.

The ReadSubnets command lists one or more of your Subnets.
If you do not specify any Subnet ID, this action describes all of your Subnets.

Request sample
$ osc-cli api ReadSubnets --profile "default" \
    --Filters '{
        "NetIds": ["vpc-12345678"],
      }'
Request sample
$ osc-cli api ReadSubnets --profile "default" \
    --Filters '{
        "States": ["available", "pending"],
        "SubregionNames": ["eu-west-2a"],
      }'

This command contains the following attributes that you need to specify:

  • DryRun: (optional) If true, checks whether you have the required permissions to perform the action.

  • Filters: (optional) One or more filters.

  • NextPageToken: (optional) The token to request the next page of results. Each token refers to a specific page.

  • ResultsPerPage: (optional) The maximum number of logs returned in a single response (between 1`and `1000, both included). By default, 100.

The ReadSubnets command returns the following elements:

  • NextPageToken: The token to request the next page of results. Each token refers to a specific page.

  • ResponseContext: Information about the context of the response.

  • Subnets: Information about one or more Subnets.

Result sample
{
  "Subnets": [
    {
      "Tags": [],
      "SubregionName": "eu-west-2a",
      "SubnetId": "subnet-12345678",
      "AvailableIpsCount": 16379,
      "IpRange": "10.0.0.0/18",
      "MapPublicIpOnLaunch": false,
      "State": "available",
      "NetId": "vpc-12345678"
    }
  ],
  "ResponseContext": {
    "RequestId": "0475ca1e-d0c5-441d-712a-da55a4175157"
  }
}

Obtenir des informations sur vos subnets avec AWS CLI

Pour obtenir des informations sur un ou plusieurs de vos subnets, utilisez la commande describe-subnets en 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 Installer 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. Pour en savoir plus, voir À propos des Nets.

    • 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 Nets.

    • 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éthodes API correspondantes

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.

Exporter en PDF