Installer et configurer AWS CLI

Vous pouvez gérer vos ressources du Cloud OUTSCALE avec AWS CLI, une interface en ligne de commande (CLI) développée par Amazon Web Services™.

AWS CLI est compatible avec toutes nos API AWS-compliant. Pour une utilisation avancée d’AWS CLI, voir Installer et configurer AWS CLI.

Le 16 janvier 2025, Amazon Web Services (AWS) a introduit de nouveaux algorithmes de protection de l’intégrité par défaut lors du chargement et du téléchargement de données à l’aide de l’API S3. Pour en savoir plus, voir Avertissement sur la compatibilité des SDK et de la CLI AWS.

Installer et configurer AWS CLI

  1. Installez AWS CLI. Pour en savoir plus, voir la documentation officielle d’AWS CLI.

  2. Tapez la commande suivante dans votre terminal :

    $ aws configure
  3. Spécifiez les éléments de configuration :

    • AWS Access Key ID : Votre access key OUTSCALE.

    • AWS Secret Access Key : Votre secret key OUTSCALE. Pour en savoir plus, voir Obtenir des informations sur vos access keys.

    • Default region name : Le nom de la Région du Cloud OUTSCALE que vous souhaitez utiliser. Pour en savoir plus, voir À propos des Régions et Sous-régions.

    • Default output format : Cet attribut doit être paramétré sur json.

      Cette commande définit un profil par défaut, sans nom. Pour définir un profil nommé, pour chaque Région que vous pouvez utiliser, utilisez l’option --profile en suivant cette syntaxe :

      $ aws configure --profile VOTRE_PROFIL

Utiliser AWS CLI

Envoyer une requête

Pour envoyer une requête à une API AWS-compliant, spécifiez dans votre commande :

  • Le nom d’une API AWS qui est compatible.

    Les API AWS suivantes sont compatibles avec les services OUTSCALE :

    • ec2 pour FCU

    • elb pour LBU

    • iam pour EIM

    • directconnect pour DirectLink

    • s3api pour OOS

  • Le nom de la commande.

  • (optionnel) Le profil nommé avec l’option --profile.

  • L’endpoint avec l’option --endpoint. Pour en savoir plus, voir Référence des endpoints d’API.

  • Toute autre option requis par la commande.

Exemple de requête
$ aws ec2 describe-instances \
    --profile YOUR_PROFILE \
    --endpoint https://fcu.eu-west-2.outscale.com

Configurer l’attribut endpoint

Si vous souhaitez exploiter le Cloud OUTSCALE avec AWS CLI sans devoir spécifier à chaque fois les différents endpoints, vous pouvez rendre l’attribut optionnel en procédant comme suit :

Assurez-vous de mettre à jour les endpoints à chaque nouvelle sortie d’une Région ou d’un service par 3DS OUTSCALE. Pour en savoir plus, voir À propos des Régions et Sous-régions.

~/.aws/models/endpoints.json
{
  "partitions": [
    {
      "defaults": {
        "hostname": "{service}.{region}.{dnsSuffix}",
        "protocols": [
          "https"
        ],
        "signatureVersions": [
          "v4"
        ]
      },
      "dnsSuffix": "outscale.com",
      "partition": "osc",
      "partitionName": "Outscale",
      "regionRegex": "^(cloudgouv|us|eu|ap)\\-\\w+\\-\\d+$",
      "regions": {
        "eu-west-2": {
          "description": "EU (Paris)"
        },
        "cloudgouv-eu-west-1": {
          "description": "CloudGouv EU (Paris)"
        },
        "us-east-2": {
          "description": "US East (NY)"
        },
        "us-west-1": {
          "description": "US West (California)"
        },
        "ap-northeast-1": {
          "description": "Japan (Tokyo)"
        }
      },
      "services": {
        "ec2": {
          "endpoints": {
            "eu-west-2": {"hostname": "fcu.eu-west-2.outscale.com"},
            "cloudgouv-eu-west-1": {"hostname": "fcu.cloudgouv-eu-west-1.outscale.com"},
            "us-east-2": {"hostname": "fcu.us-east-2.outscale.com"},
            "us-west-1": {"hostname": "fcu.us-west-1.outscale.com"},
            "ap-northeast-1": {"hostname": "fcu.ap-northeast-1.outscale.com"}
          }
        },
       "elasticloadbalancing": {
          "endpoints": {
            "eu-west-2": {"hostname": "lbu.eu-west-2.outscale.com"},
            "cloudgouv-eu-west-1": {"hostname": "lbu.cloudgouv-eu-west-1.outscale.com"},
            "us-east-2": {"hostname": "lbu.us-east-2.outscale.com"},
            "us-west-1": {"hostname": "lbu.us-west-1.outscale.com"},
            "ap-northeast-1": {"hostname": "lbu.ap-northeast-1.outscale.com"}
          }
        },
        "iam": {
          "endpoints": {
            "eu-west-2": {"hostname": "eim.eu-west-2.outscale.com"},
            "cloudgouv-eu-west-1": {"hostname": "eim.cloudgouv-eu-west-1.outscale.com"},
            "us-east-2": {"hostname": "eim.us-east-2.outscale.com"},
            "us-west-1": {"hostname": "eim.us-west-1.outscale.com"},
            "ap-northeast-1": {"hostname": "eim.ap-northeast-1.outscale.com"}
          }
        },
        "directconnect": {
          "endpoints": {
            "eu-west-2": {"hostname": "directlink.eu-west-2.outscale.com"},
            "cloudgouv-eu-west-1": {"hostname": "directlink.cloudgouv-eu-west-1.outscale.com"},
            "us-east-2": {"hostname": "directlink.us-east-2.outscale.com"},
            "us-west-1": {"hostname": "directlink.us-west-1.outscale.com"}
          }
        },
        "s3": {
          "endpoints": {
            "eu-west-2": {"hostname": "oos.eu-west-2.outscale.com"},
            "cloudgouv-eu-west-1": {"hostname": "oos.cloudgouv-eu-west-1.outscale.com"},
            "us-east-2": {"hostname": "oos.us-east-2.outscale.com"},
            "us-west-1": {"hostname": "oos.us-west-1.outscale.com"}
          }
        }
      }
    }
  ],
  "version": 3
}

Utiliser ce nouveau modèle change la syntaxe de votre requête AWS CLI :

Avant
$ aws ec2 describe-instances --instance-ids i-12345678 i-87654321 i-12348765 i-56784321 --endpoint https://fcu.eu-west-2.outscale.com
Après
$ aws ec2 describe-instances --instance-ids i-12345678 i-87654321 i-12348765 i-56784321

Vous devrez utiliser le paramètre region pour basculer d’une Région à une autre.

Pour en savoir plus sur les lignes de commande d’AWS CLI, voir la référence AWS des lignes de commande (en anglais).

Pages connexes

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.