

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Recherche de services et de produits à l'aide de l'API AWS Price List Query
<a name="using-price-list-query-api"></a>


|  | 
| --- |
| Pour nous faire part de vos commentaires AWS Price List, répondez à ce [court sondage](https://amazonmr.au1.qualtrics.com/jfe/form/SV_cO0deTMyKyFeezA). Vos réponses seront anonymes. **Remarque :** cette enquête est disponible en anglais uniquement. | 

Nous vous conseillons d'utiliser l'API de requête de liste de prix lorsque vous souhaitez :
+ Rechercher des informations sur la tarification d'un produit.
+ Rechercher les produits et les prix qui correspondent à vos filtres.
+ Rechercher rapidement les produits et les prix dont vous avez besoin lorsque vous développez des applications dont les ressources sont limitées, telles que les environnements frontaux.

Pour trouver Services AWS leurs produits, leurs attributs et leurs prix, consultez les étapes suivantes.

## Étape 1 : Trouver un produit disponible Services AWS
<a name="price-list-query-api-find-services"></a>

Une fois que vous avez trouvé le service, vous pouvez obtenir ses attributs à l'aide de l'opération d'API `DescribeServices`. Si vous connaissez le code du service, vous pouvez également utiliser l'API AWS Price List Query pour obtenir les attributs d'un service. Vous pouvez ensuite utiliser les attributs de service pour rechercher les produits qui répondent à vos exigences en fonction des valeurs d'attribut.

### Exemples : rechercher des services
<a name="examples-cli-price-list-query-api"></a>

Les commandes AWS Command Line Interface (AWS CLI) suivantes indiquent comment rechercher des services.

**Example Exemple : rechercher tous les services**  

```
aws pricing describe-services --region us-east-1
```
**Réponse**  

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

**Example Exemple : rechercher les métadonnées de service pour Amazon Elastic Compute Cloud (Amazon EC2)**  
La commande suivante explique comment rechercher les métadonnées de service pour Amazon EC2.  

```
aws pricing describe-services --region us-east-1 --service-code AmazonEC2
```
**Réponse**  

```
{
    "FormatVersion": "aws_v1", 
    "NextToken": "abcdefg123", 
    "Services": [ 
        {
            "AttributeNames": [ 
                "productFamily", 
                "volumeType", 
                "engineCode", 
                "memory" 
            ], 
            "ServiceCode": "AmazonEC2" 
        }
    ] 
}
```

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

Pour plus d’informations, consultez [https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_pricing_DescribeServices.html](https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_pricing_DescribeServices.html) dans la *Référence d’API AWS Billing and Cost Management *.

## Étape 2 : Recherche des valeurs disponibles pour les attributs
<a name="price-list-query-api-find-attributes"></a>

À [l'étape 1](#price-list-query-api-find-services), vous avez récupéré la liste des attributs d'un Service AWS. Au cours de cette étape, vous allez utiliser ces attributs pour rechercher des produits. À l'étape 3, vous avez besoin des valeurs disponibles pour ces attributs.

Pour rechercher les valeurs d'un attribut, utilisez l'opération d'API `GetAttributeValues`. Pour appeler l'API, spécifiez les paramètres `AttributeName` et `ServiceCode`.

### Exemple : obtenir des valeurs d'attributs
<a name="examples-to-find-attributes"></a>

La commande suivante AWS Command Line Interface (AWS CLI) montre comment obtenir des valeurs d'attribut pour un Service AWS.

**Example Exemple : rechercher des valeurs d'attribut pour Amazon Relational Database Service (Amazon RDS)**  

```
aws pricing get-attribute-values --service-code AmazonRDS --attribute-name operation --region us-east-1
```
**Réponse**  

```
{
    "AttributeValues": [
        {
            "Value": "CreateDBInstance:0002"
        },
        {
            "Value": "CreateDBInstance:0003"
        },
        {
            "Value": "CreateDBInstance:0004"
        },
        {
            "Value": "CreateDBInstance:0005"
        }
    ],
    "NextToken": "abcdefg123"
}
```

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

Pour plus d'informations, consultez [https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_pricing_GetAttributeValues.html](https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_pricing_GetAttributeValues.html)la section [spécifique au langage AWS SDKs dans la référence](https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_pricing_GetAttributeValues.html#API_pricing_GetAttributeValues_SeeAlso) de l'*AWS Billing and Cost Management API*.

## Étape 3 : Recherche de produits à partir d'attributs
<a name="using-the-aws-price-list-query-api-finding-products-from-attributes"></a>

Au cours de cette étape, vous allez utilisez les informations des [étapes 1](#price-list-query-api-find-services) et [2](#price-list-query-api-find-attributes) pour trouver les produits et leurs conditions d'utilisation. Pour obtenir des informations sur les produits, utilisez l'opération d'API `GetProducts`. Vous pouvez spécifier une liste de filtres pour renvoyer les produits que vous souhaitez.

**Note**  
L'API de requête de liste de prix ne prend en charge que la correspondance `"AND"`. La réponse à votre commande contient uniquement les produits qui correspondent à tous les filtres spécifiés.

### Exemples : rechercher des produits à partir d'attributs
<a name="example-cli-filters-for-finding-products-from-attributes"></a>

Les commandes AWS Command Line Interface (AWS CLI) suivantes montrent comment rechercher des produits à l'aide d'attributs.

**Example Exemple : rechercher des produits avec des filtres spécifiés**  
La commande suivante montre comment vous pouvez spécifier des filtres pour Amazon Relational Database Service (Amazon RDS).  

```
aws pricing get-products --service-code AmazonRDS --region us-east-1 --filters Type=TERM_MATCH,Field=operation,Value="CreateDBInstance:0002"
```
**Réponse**  

```
{
    "FormatVersion": "aws_v1",
    "PriceList": ["{
        \"product\":{
            \"productFamily\":\"Database Instance\",
            \"attributes\":{
                \"engineCode\":\"2\",
                \"enhancedNetworkingSupported\":\"Yes\",
                \"memory\":\"64 GiB\",
                \"dedicatedEbsThroughput\":\"2000 Mbps\",
                \"vcpu\":\"16\",
                \"locationType\":\"AWS Region\",
                \"storage\":\"EBS Only\",
                \"instanceFamily\":\"General purpose\",
                \"regionCode\":\"us-east-1\",
                \"operation\":\"CreateDBInstance:0002\",
                ...
            },
            \"sku\":\"22ANV4NNQP3UUCWY\"},
            \"serviceCode\":\"AmazonRDS\",
            \"terms\":{...}"
    ],
    "NextToken": "abcd1234"
}
```

**Example Exemple : utiliser le fichier `filters.json` pour spécifier des filtres**  
La commande suivante montre comment vous pouvez spécifier un fichier JSON contenant tous les filtres.  

```
aws pricing get-products --service-code AmazonRDS --region us-east-1 --filters file://filters.json
```
Par exemple, le fichier `filters.json` peut inclure les filtres suivants.  

```
[
  {
    "Type": "TERM_MATCH",
    "Field": "operation",
    "Value": "CreateDBInstance:0002"
  }
]
```
L'exemple suivant montre comment vous pouvez spécifier plusieurs filtres.  

```
[
  {
    "Type": "TERM_MATCH",
    "Field": "AttributeName1",
    "Value": "AttributeValue1"
  },
  {
    "Type": "TERM_MATCH",
    "Field": "AttributeName2",
    "Value": "AttributeValue2"
  },
  ...
]
```
**Réponse**  

```
{
    "FormatVersion": "aws_v1",
    "PriceList": ["{
        \"product\":{
            \"productFamily\":\"Database Instance\",
            \"attributes\":{
                \"engineCode\":\"2\",
                \"enhancedNetworkingSupported\":\"Yes\",
                \"memory\":\"64 GiB\",
                \"dedicatedEbsThroughput\":\"2000 Mbps\",
                \"vcpu\":\"16\",
                \"locationType\":\"AWS Region\",
                \"storage\":\"EBS Only\",
                \"instanceFamily\":\"General purpose\",
                \"regionCode\":\"us-east-1\",
                \"operation\":\"CreateDBInstance:0002\",
                ...
            },
            \"sku\":\"22ANV4NNQP3UUCWY\"},
            \"serviceCode\":\"AmazonRDS\",
            \"terms\":{...}"
    ],
    "NextToken": "abcd1234"
}
```

Pour plus d’informations, consultez les rubriques suivantes :
+ [https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_pricing_GetProducts.html](https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_pricing_GetProducts.html)*et [spécifiques au langage dans la référence AWS SDKs](https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_pricing_GetProducts.html#API_pricing_GetProducts_SeeAlso) de l'API AWS Billing and Cost Management *
+ [Consulter les fichiers de liste de prix des services](reading-service-price-list-files.md)
+ [Recherche de prix dans le fichier de liste de prix des services](finding-prices-in-service-price-list-files.md)