Obtenir des informations sur les Régions

Vous pouvez obtenir des informations à propos des Régions du Cloud OUTSCALE.

Toutefois, l’API ne renvoie actuellement pas forcément toutes les Régions publiques disponibles. Pour une liste complète, voir À propos des Régions et Sous-régions.

Obtenir des informations sur les Régions avec OSC CLI

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

The ReadRegions command lists one or more Regions of the OUTSCALE Cloud.

For more information, see About Regions and Subregions.

Request sample
$ osc-cli api ReadRegions --profile "default"

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.

The ReadRegions command returns the following elements:

  • Regions: Information about one or more Regions.

    • Endpoint: The hostname of the gateway to access the Region.

    • RegionName: The administrative name of the Region.

  • ResponseContext: Information about the context of the response.

    • RequestId: The ID of the request.

Result sample
{
  "ResponseContext": {
    "RequestId": "0475ca1e-d0c5-441d-712a-da55a4175157"
  },
  "Regions": [
    {
      "RegionName": "eu-west-2",
      "Endpoint": "api.eu-west-2.outscale.com"
    },
    {
      "RegionName": "us-east-2",
      "Endpoint": "api.us-east-2.outscale.com"
    },
    {
      "RegionName": "us-west-1",
      "Endpoint": "api.us-west-1.outscale.com"
    }
  ]
}

Obtenir des informations sur les Régions avec oapi-cli

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

The ReadRegions command lists one or more Regions of the OUTSCALE Cloud.

For more information, see About Regions and Subregions.

Request sample
$ oapi-cli --profile "default" ReadRegions

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.

The ReadRegions command returns the following elements:

  • Regions: Information about one or more Regions.

    • Endpoint: The hostname of the gateway to access the Region.

    • RegionName: The administrative name of the Region.

  • ResponseContext: Information about the context of the response.

    • RequestId: The ID of the request.

Result sample
{
  "ResponseContext": {
    "RequestId": "0475ca1e-d0c5-441d-712a-da55a4175157"
  },
  "Regions": [
    {
      "RegionName": "eu-west-2",
      "Endpoint": "api.eu-west-2.outscale.com"
    },
    {
      "RegionName": "us-east-2",
      "Endpoint": "api.us-east-2.outscale.com"
    },
    {
      "RegionName": "us-west-1",
      "Endpoint": "api.us-west-1.outscale.com"
    }
  ]
}

Obtenir des informations sur les Régions avec AWS CLI

Avant de commencer : Installez et configurez AWS CLI. Pour en savoir plus, voir Installer et configurer AWS CLI.

Pour obtenir des informations sur une ou plusieurs Régions, utilisez la commande describe-regions en suivant cette syntaxe :

Exemple de requête
$ aws ec2 describe-regions \
    --region-names NOT_SPECIFIED \
    --filters Name=X,Values=Y \
    --endpoint https://fcu.eu-west-2.outscale.com

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

  • (optionnel) region-names : Le nom d’une ou plusieurs Régions.

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

    • region-name : Le nom de la Région.

    • endpoint : Le endpoint permettant d’accéder à la Région.

      Si vous ne connaissez qu’une chaîne de caractères du region-name ou du endpoint, vous pouvez les utiliser comme valeur pour les filtres correspondants en suivant cette syntaxe :

      $ aws ec2 describe-regions \
   --filters "Name=region-name,Values=*xx*" \
      $ aws ec2 describe-regions \
   --filters "Name=endpoint,Values=*xx*" \

  • endpoint : Le endpoint correspondant à la Région à laquelle vous voulez envoyer la requête. Pour en savoir plus, voir Installer et configurer AWS CLI.

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

  • Regions : Informations à propos d’une ou plusieurs Régions. Cet élément contient les informations suivantes :

    • Endpoint : L’URL permettant d’accéder à la Région.

    • RegionName : Le nom de la Région.

Exemple de résultat
{
    "Regions": [
        {
            "Endpoint": "fcu.eu-west-2.outscale.com",
            "RegionName": "eu-west-2"
        },
        {
            "Endpoint": "fcu.us-east-2.outscale.com",
            "RegionName": "us-east-2"
        },
        {
            "Endpoint": "fcu.us-west-1.outscale.com",
            "RegionName": "us-west-1"
        }
    ]
}

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