Obtenir des informations sur vos VPC peering connections

Vous pouvez obtenir des informations sur une ou plusieurs VPC peering connections.

Par défaut, cette action décrit toutes vos VPC peering connections. Les connexions dont l’état est failed, expired ou deleted restent visibles pendant 1 heure. Pour en savoir plus, voir À propos des VPC peering connections > Cycle de vie.

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 ces ressources sont également disponibles dans Cockpit. Pour en savoir plus, voir Interface utilisateur des VPC.

Pour obtenir des informations sur une ou plusieurs VPC peering connections, utilisez la commande describe-vpc-peering-connections suivant cette syntaxe :

Exemple de requête
$ aws ec2 describe-vpc-peering-connections \
    --profile YOUR_PROFILE \
    --vpc-peering-connection-ids pcx-111aaa11 \
    --filters Name=status-code,Values=pending-acceptance \
    --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-peering-connection-ids : Un ou plusieurs ID de VPC peering connections pour lesquelles vous voulez obtenir des informations.

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

    • accepter-vpc-info.cidr-block : La plage d’IP du VPC accepteur, en notation CIDR.

    • accepter-vpc-info.owner-id : L’ID du compte du propriétaire du VPC accepteur.

    • accepter-vpc-info.vpc-id : L’ID du VPC accepteur.

    • expiration-time : La date d’expiration de la requête de connexion (par exemple, 2016-01-23T18:45:30.000Z).

    • requester-vpc-info.cidr-block : La plage d’IP du VPC requêteur, en notation CIDR.

    • requester-vpc-info.owner-id : L’ID du compte du propriétaire du VPC requêteur.

    • requester-vpc-info.vpc-id : L’ID du VPC requêteur.

    • status-code : L’état de la VPC peering connection (pending-acceptance | active | rejected | failed | expired | deleted).

      Pour voir toutes les requêtes de VPC peering connections dont l’état est pending-acceptance pour vos VPC, utilisez le filtre status-code avec la valeur pending-acceptance.

    • status-message : Informations supplémentaires sur l’état de la VPC peering connection.

    • vpc-peering-connection-id : L’ID de la VPC peering connection.

    • 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-vpc-peering-connections renvoie les éléments suivants :

  • VpcPeeringConnections : Informations à propos d’une ou plusieurs VPC peering connections. Cet élément contient les informations suivantes :

    • AccepterVpcInfo : Informations à propos du VPC accepteur. Cet élément contient les informations suivantes :

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

      • OwnerID : L’ID du compte du propriétaire du VPC.

      • VpcId : L’ID du VPC.

    • ExpirationTime : La date d’expiration d’une VPC peering connection à l’état pending-acceptance.

    • RequesterVpcInfo : Informations à propos du VPC requêteur. Cet élément contient les informations suivantes :

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

      • OwnerID : L’ID du compte du propriétaire du VPC.

      • VpcId : L’ID du VPC.

    • Status : Informations à propos de l’état de la VPC peering connection. Cet élément contient les informations suivantes :

      • Code : L’état de la VPC peering connection (pending-acceptance | active | rejected | failed | expired | deleted).

      • Message : Informations supplémentaires à propos de la VPC peering connection.

    • Tags : Un ou plusieurs tags associés à la VPC peering connection. Cet élément contient les informations suivantes :

      • Key : La clé du tag.

      • Value : La valeur du tag.

    • VpcPeeringConnectionId : L’ID de la VPC peering connection.

Exemple de résultat
{
    "VpcPeeringConnections": [
        {
            "AccepterVpcInfo": {
                "CidrBlock": "175.0.0.0/28",
                "OwnerId": "888877776666",
                "VpcId": "vpc-11122233"
            },
            "RequesterVpcInfo": {
                "CidrBlock": "10.0.0.0/28",
                "OwnerId": "444455556666",
                "VpcId": "vpc-1a2b3c4d"
            }
            "Status": {
                "Code": "pending-acceptance",
                "Message": "Pending acceptance by 888877776666"
            },
            "Tags": [],
            "VpcPeeringConnectionId": "pcx-111aaa11"
        }
    ]
}

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.