

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Obtener archivos de listas de precios mediante la API AWS Price List Bulk
<a name="using-the-aws-price-list-bulk-api"></a>


|  | 
| --- |
| Para enviarnos comentarios al respecto Lista de precios de AWS, completa esta [breve encuesta](https://amazonmr.au1.qualtrics.com/jfe/form/SV_cO0deTMyKyFeezA). Sus respuestas serán anónimas. **Nota:** Esta encuesta está disponible únicamente en inglés. | 

Le recomendamos que use la API masiva de lista de precios cuando desee llevar a cabo las siguientes tareas:
+ Consumir grandes cantidades de información sobre productos y precios de los Servicios de AWS.
+ Consumir información sobre productos y precios con un alto rendimiento para un Servicio de AWS, como el procesamiento en bloque.

Además, cuando la API de consulta de lista de precios no proporcione un rendimiento y unas cuotas suficientes para su caso de uso, use la API masiva de lista de precios.<a name="using-the-aws-price-list-bulk-api-fetching-price-list-files"></a>

Le recomendamos que utilice la API de listas de AWS precios masivas para buscar y descargar los archivos de listas de precios mediante programación. Para obtener la URL de los archivos de listas de precios, consulte los pasos siguientes.

Si no quieres utilizar la API de listas de AWS precios masivas, puedes descargar los archivos de listas de precios manualmente. Para obtener más información, consulte [Obtención de archivos de listas de precios manualmente](using-the-aws-price-list-bulk-api-fetching-price-list-files-manually.md).

### Paso 1: Búsqueda de los disponibles Servicios de AWS
<a name="price-bulk-api-step-1-find-available-services"></a>

Use la operación de la API `DescribeServices` para encontrar todos los Servicios de AWS disponibles que admite la API masiva de lista de precios. Esta operación de la API devuelve el valor `ServiceCode` de la lista de servicios. Este valor se usará más adelante para buscar archivos de listas de precios pertinentes.

**Example Ejemplo: búsqueda de servicios disponibles**  
El siguiente comando muestra cómo buscar Servicios de AWS disponibles.  

```
aws pricing describe-services --region us-east-1
```
 Región de AWS Es el punto final de la API para la API masiva de listas de precios. Los puntos de conexión no están relacionados con atributos de productos o servicios.  
**Respuesta**  

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

*Para obtener más información sobre el funcionamiento de esta API, consulta [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)el [idioma específico AWS SDKs](https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_pricing_DescribeServices.html#API_pricing_DescribeServices_SeeAlso) en la referencia de la Administración de facturación y costos de AWS API*

**nota**  
Si bien la `DescribeServices` API actualmente no es válida `serviceCodes` para Savings Plans, necesitarás lo siguiente `serviceCodes` para usar Savings Plans en llamadas posteriores a la API:  


| ServiceCode | SavingsPlanCode | 
| --- | --- | 
| ComputeSavingsPlans | AWSComputeSavingsPlan | 
| MachineLearningSavingsPlans | AWSMachineLearningSavingsPlans | 
| DatabaseSavingsPlans | AWSDatabaseSavingsPlans | 
Usa los `ServiceCode` valores cuando trabajes con las operaciones de la `GetPriceListFileUrl` API `ListPriceLists` y la API. Solo `SavingsPlanCode` es necesario si descarga los archivos de la lista de precios manualmente en lugar de utilizarlos APIs.

### Paso 2: Buscar archivos de lista de precios para una oferta disponible Servicio de AWS
<a name="price-list-bulk-api-step-2-find-available-price-list-files"></a>

Use la operación de la API `ListPriceLists` para obtener una lista de referencias de listas de precios que tenga permiso para ver. Para filtrar los resultados, puede especificar los parámetros `ServiceCode`, `CurrencyCode` y `EffectiveDate`.

 Región de AWS Es el punto final de la API para la API de listas de precios masivas. Los puntos de conexión no están relacionados con atributos de productos o servicios.

#### Ejemplos para buscar archivos de listas de precios
<a name="price-list-bulk-api-examples-find-price-list-files"></a>

**Example Ejemplo: busca archivos de listas de precios para todos Regiones de AWS**  
Si no especifica el parámetro `--region-code`, la operación de la API devuelve referencias de archivos de listas de precios de todas las Regiones de AWS disponibles.   

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

```
{
   "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"
      },
      ...
   ]
}
```

**Example Ejemplo: búsqueda de archivos de listas de precios para una región específica**  
Si especifica el parámetro `RegionCode`, la operación de la API devuelve referencias de archivos de listas de precios específicas de esa región. Para buscar archivos de listas de precios históricos, use el parámetro `EffectiveDate`. Por ejemplo, puede especificar una fecha en el pasado para buscar un archivo de lista de precios específico.   
A partir de la respuesta, puede usar el valor de `PriceListArn` con la operación de la API [https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_pricing_GetPriceListFileUrl.html](https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_pricing_GetPriceListFileUrl.html) para obtener los archivos de listas de precios que prefiera.  

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

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

Para obtener más información sobre el funcionamiento de esta API, consulta [https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_pricing_ListPriceLists.html](https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_pricing_ListPriceLists.html)el [idioma específico AWS SDKs](https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_pricing_ListPriceLists.html#API_pricing_ListPriceLists_SeeAlso) en la referencia de la *Administración de facturación y costos de AWS API*.

### Paso 3: obtención de un archivo de lista de precios específico
<a name="price-list-bulk-api-step-3-getting-specific-price-list"></a>

Use la operación de la API `GetPriceListFileUrl` para obtener la URL de un archivo de lista de precios. Esta URL se basa en los valores de `PriceListArn` y `FileFormats` que recuperó de la respuesta de `ListPriceLists` en el [paso 1](#price-bulk-api-step-1-find-available-services) y el [paso 2](#price-list-bulk-api-step-2-find-available-price-list-files) 

**Example Ejemplo: obtención de un archivo de lista de precios específico**  
El siguiente comando obtiene la URL de un archivo de lista de precios específico para 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
```
**Respuesta**  

```
{
    "Url": "https://pricing.us-east-1.amazonaws.com/offers/v1.0/aws/AmazonRDS/20230328234721/us-east-1/index.json"
}
```
Desde la respuesta, puede usar la URL para descargar el archivo de lista de precios.

Para más información sobre esta operación de la API, consulte los siguientes temas:
+  [https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_pricing_GetPriceListFileUrl.html](https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_pricing_GetPriceListFileUrl.html)*y [específico del idioma en la referencia de la API AWS SDKs](https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_pricing_GetPriceListFileUrl.html#API_pricing_GetPriceListFileUrl_SeeAlso)Administración de facturación y costos de AWS *
+ [Lectura de archivos de listas de precios](bulk-api-reading-price-list-files.md)