Obtenir des informations sur vos VPC

Vous pouvez obtenir des informations à propos d’un ou plusieurs de vos VPC, comme leur bloc CIDR ou leur option d’allocation.

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 VPC sont également disponibles :

Obtenir des informations générales sur vos VPC

Pour obtenir des informations générales sur un ou plusieurs de vos VPC, utilisez la commande describe-vpcs suivant cette syntaxe :

Exemple de requête
$ aws ec2 describe-vpcs \
    --profile YOUR_PROFILE \
    --vpc-ids vpc-12345678 \
    [--filters NOT_SPECIFIED] \
    --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) vpc-ids : Un ou plusieurs ID de VPC.

  • (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 :

    • vpc-id : L’ID du VPC.

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

    • cidr : Le bloc CIDR exact du VPC.

    • cidr-block : Le bloc CIDR exact du VPC (similaire à cidr et cidrBlock).

    • cidrBlock : Le bloc CIDR exact du VPC (similaire à cidr et cidr-block).

    • dhcp-options-id : L’ID d’un groupe d’options DHCP associé au VPC. Pour en savoir plus, voir À propos des options DHCP.

    • is-default : Indique si le VPC est celui par défaut (toujours false, car 3DS OUTSCALE ne fournit pas de VPC par défaut).

    • isDefault : Alias de is-default.

    • tag-key : La clé d’un tag associé à la ressource.

    • tag-value : La valeur d’un tag associé à la ressource.

    • tag:XXXX : La valeur d’un tag associé à la ressource, où XXXX est la clé du tag.

      Pour filtrer un tag dont la clé est XXXX et la valeur est YYYY, vous pouvez donc utiliser un des deux formats suivants :

      • --filters Name=tag-key,Values=XXXX Name=tag-value,Values=YYYY

      • --filters Name=tag:XXXX,Values=YYYY

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

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

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

    • VpcId : L’ID du VPC.

    • InstanceTenancy : L’option d’allocation pour les instances lancées dans le VPC. Pour en savoir plus, voir À propos des instances > Allocation des instances et instances dédiées.

    • Tags : Un ou plusieurs tags associés avec le VPC. Cet élément contient les informations suivantes :

      • Value : La valeur du tag.

      • Key : La clé du tag.

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

    • DhcpOptionsId : L’ID du groupe d’options DHCP associé au VPC. Pour en savoir plus, voir À propos des options DHCP.

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

    • IsDefault : Toujours false, car 3DS OUTSCALE ne fournit pas de VPC par défaut.

Exemple de résultat
     "Vpcs": [
        {
            "VpcId": "vpc-12345678",
            "InstanceTenancy": "default",
            "Tags": [
                {
                    "Value": "VPC1",
                    "Key": "Name"
                }
            ],
            "State": "available",
            "DhcpOptionsId": "dopt-1234abcd",
            "CidrBlock": "10.0.0.0/16",
            "IsDefault": false
        }
    ]
}

Obtenir des informations sur un attribut d’un VPC

Pour obtenir des informations à propos d’un attribut d’un VPC, utilisez la commande describe-vpc-attribute suivant cette syntaxe :

Exemple de requête
$ aws ec2 describe-vpc-attribute \
    --profile YOUR_PROFILE \
    --vpc-id vpc-123456789 \
    --attribute \
    --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.

  • vpc-id : L’ID du VPC.

  • attribute : Le nom de l’attribut (enableDnsSupport | enableDnsHostnames).

    Vous ne pouvez spécifier qu’un attribut à la fois.

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

La commande describe-vpc-attribute renvoie les éléments suivants :

  • VpcId : L’ID du VPC.

  • EnableDnsSupport, si vous l’avez spécifié comme attribut à décrire. Cet élément contient l’information suivante :

    • Value : Si true, les serveurs DNS du VPC résolvent les noms d’hôtes DNS de vos instances en IP correspondantes. Si false, il ne l’est pas.

  • EnableDnsHostName, si vous l’avez spécifié comme attribut à décrire. Cet élément contient l’information suivante :

    • Value : Si true, les instances lancées dans le VPC obtiennent des noms d’hôtes DNS. Si false, il ne l’est pas.

Exemple de résultat
{
    "VpcId": "vpc-a01106c2",
    "EnableDnsSupport": {
        "Value": true
    }
}

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.