Obtenir des fichiers de listes de prix à l'aide de l'API AWS Price List Bulk

Pour nous faire part de vos commentaires AWS Price List, répondez à ce court sondage. Vos réponses seront anonymes. Remarque : cette enquête est disponible en anglais uniquement.

Nous vous conseillons d'utiliser l'API de liste des prix lorsque vous souhaitez effectuer les tâches suivantes :

• Solliciter de grandes quantités d'informations sur les produits et les prix d'un Services AWS.

• Solliciter des informations sur les produits et les prix d' Service AWS a un haut débit, comme le traitement en masse.

De même, lorsque l'API de requête de liste de prix ne fournit pas un débit et des quotas suffisants pour votre cas d'utilisation, utilisez l'API de liste des prix.

Nous vous recommandons d'utiliser l'API AWS Price List Bulk pour rechercher et télécharger les fichiers des listes de prix par programmation. Pour obtenir l'URL des fichiers de liste de prix, suivez les étapes ci-dessous.

Si vous ne souhaitez pas utiliser l'API AWS Price List Bulk, vous pouvez télécharger les fichiers des listes de prix manuellement. Pour plus d’informations, consultez Obtention manuellement des fichiers des listes de prix.

Étape 1 : Trouver un produit disponible Services AWS

Utilisez l'opération d'API DescribeServices pour rechercher toutes les informations disponibles prises en charge par l'API de liste des prix Services AWS . Cette opération d'API renvoie la valeur ServiceCode dans la liste des services. Vous utiliserez cette valeur ultérieurement pour rechercher les fichiers des listes de prix pertinents.

Exemple : rechercher des services disponibles

La commande suivante explique comment rechercher les Services AWS disponibles.

aws pricing describe-services --region us-east-1

Région AWS Il s'agit du point de terminaison de l'API Price List Bulk. Les points de terminaison ne sont pas liés aux attributs du produit ou du service.

Réponse

{
    "FormatVersion": "aws_v1", 
    "NextToken": "abcdefg123", 
    "Services": [ 
        {
            "AttributeNames": [ 
                "volumeType", 
                "maxIopsvolume", 
                "instanceCapacity10xlarge", 
                "locationType", 
                "operation" 
            ], 
            "ServiceCode": "AmazonEC2" 
        },
        {
            "AttributeNames": [ 
                "productFamily", 
                "volumeType", 
                "engineCode", 
                "memory" 
            ], 
            "ServiceCode": "AmazonRDS" 
        },
        {...} 
    ] 
}

Pour plus d'informations sur cette opération d'API, consultez la section relative DescribeServicesaux AWS SDK spécifiques au langage dans le Guide de référence des API AWS Billing and Cost Management

Étape 2 : Recherche de fichiers de liste de prix pour un produit disponible Service AWS

Utilisez l'opération d'API ListPriceLists pour obtenir la liste des références des listes de prix que vous êtes autorisé à consulter. Pour filtrer vos résultats, vous pouvez spécifier les paramètres ServiceCode, CurrencyCode et EffectiveDate.

Région AWS Il s'agit du point de terminaison de l'API Price List Bulk. Les points de terminaison ne sont pas liés aux attributs du produit ou du service.

Exemples pour rechercher des fichiers des listes de prix

Exemple : trouver des fichiers de listes de prix pour tous Régions AWS

Si vous ne spécifiez pas le paramètre --region-code, l'opération d'API renvoie les références aux fichiers des listes de prix de toutes les Régions AWS disponibles.

aws pricing list-price-lists --service-code AmazonRDS --currency-code USD --effective-date "2023-04-03 00:00"

Réponse

{
   "NextToken": "abcd1234",
   "PriceLists": [ 
      { 
         "CurrencyCode": "USD",
         "FileFormats": [ "json", "csv" ],
         "PriceListArn": "arn:aws:pricing:::price-list/aws/AmazonRDS/USD/20230328234721/us-east-1",
         "RegionCode": "us-east-1"
      },
      { 
         "CurrencyCode": "USD",
         "FileFormats": [ "json", "csv" ],
         "PriceListArn": "arn:aws:pricing:::price-list/aws/AmazonRDS/USD/20230328234721/us-west-2",
         "RegionCode": "us-west-2"
      },
      ...
   ]
}

Exemple : rechercher des fichiers des listes de prix pour une région spécifique

Si vous spécifiez le paramètre RegionCode, l'opération d'API renvoie les références aux fichiers des listes de prix spécifiques à cette région. Pour rechercher les fichiers de listes de prix historiques, utilisez le paramètre EffectiveDate. Par exemple, vous pouvez spécifier une date antérieure pour rechercher un fichier de liste de prix spécifique.

À partir de la réponse, vous pouvez ensuite utiliser la valeur PriceListArn avec l'opération d'API GetPriceListFileUrl pour obtenir vos fichiers de liste de prix préférés.

aws pricing list-price-lists --service-code AmazonRDS --currency-code USD --region-code us-west-2 --effective-date "2023-04-03 00:00"

Réponse

{
   "PriceLists": [ 
      { 
         "CurrencyCode": "USD",
         "FileFormats": [ "json", "csv" ],
         "PriceListArn": "arn:aws:pricing:::price-list/aws/AmazonRDS/USD/20230328234721/us-west-2",
         "RegionCode": "us-west-2"
      }
   ]
}

Pour plus d'informations sur cette opération d'API, consultez la section relative ListPriceListsaux AWS SDK spécifiques au langage dans le AWS Billing and Cost Management Guide de référence des API.

Étape 3 : Obtention d'un fichier de liste de prix spécifique

Utilisez l'opération d'API GetPriceListFileUrl pour obtenir l'URL d'un fichier de liste de prix. Cette URL est basée sur les valeurs PriceListArn et FileFormats que vous avez extraites de la réponse ListPriceLists au cours de l'étape 1 et de l'étape 2

Exemple : obtenir un fichier de liste de prix spécifique

La commande suivante permet d'obtenir l'URL d'un fichier de liste de prix spécifique pour Amazon RDS.

aws pricing get-price-list-file-url --price-list-arn arn:aws:pricing:::price-list/aws/AmazonRDS/USD/20230328234721/us-east-1 --file-format json --region us-east-1

Réponse

{
    "Url": "https://pricing.us-east-1.amazonaws.com/offers/v1.0/aws/AmazonRDS/20230328234721/us-east-1/index.json"
}

À partir de la réponse, vous pouvez utiliser l'URL pour télécharger le fichier de liste de prix.

Pour plus d'informations sur cette opération d'API, consultez les rubriques suivantes :

• GetPriceListFileUrlet des AWS SDK spécifiques au langage dans la référence des API AWS Billing and Cost Management

• Consulter les fichiers de liste de prix