As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá. # Obter arquivos de lista de preços usando a API AWS Price List Bulk | | | --- | | Para fornecer feedback sobre AWS Price List, preencha esta [breve pesquisa](https://amazonmr.au1.qualtrics.com/jfe/form/SV_cO0deTMyKyFeezA). Suas respostas serão anônimas. **Observação:** essa pesquisa só está disponível em inglês. | Recomendamos que você use a API Price List Bulk quando quiser realizar as seguintes tarefas: + Consumir grandes quantidades de informações sobre produtos e preços de Serviços da AWS. + Consumir informações sobre produtos e preços com alto throughput para um AWS service (Serviço da AWS), como processamento em massa. Além disso, quando a API Price List Query não fornecer níveis suficientes de throughput e cotas para seu caso de uso, use a API Price List Bulk. Recomendamos que você use a API AWS Price List Bulk para encontrar e baixar arquivos da lista de preços de forma programática. Para obter o URL dos arquivos de lista de preços, consulte as etapas a seguir. Se você não quiser usar a API AWS Price List Bulk, você pode baixar os arquivos da lista de preços manualmente. Para obter mais informações, consulte [Obtenção manual de arquivos de lista de preços](using-the-aws-price-list-bulk-api-fetching-price-list-files-manually.md). ### Etapa 1: Encontrar o disponível Serviços da AWS Use a operação `DescribeServices` da API para encontrar todas as opções de Serviços da AWS disponíveis com os quais a API Price List Bulk é compatível. Essa operação de API retorna o valor `ServiceCode` da lista de serviços. Você usa esse valor posteriormente para encontrar arquivos relevantes da lista de preços. **Example Exemplo: encontrar serviços disponíveis** O comando a seguir mostra como encontrar os Serviços da AWS disponíveis. ``` aws pricing describe-services --region us-east-1 ``` Esse Região da AWS é o endpoint da API Price List Bulk. Os endpoints não estão relacionados aos atributos do produto ou serviço. **Resposta** ``` { "FormatVersion": "aws_v1", "NextToken": "abcdefg123", "Services": [ { "AttributeNames": [ "volumeType", "maxIopsvolume", "instanceCapacity10xlarge", "locationType", "operation" ], "ServiceCode": "AmazonEC2" }, { "AttributeNames": [ "productFamily", "volumeType", "engineCode", "memory" ], "ServiceCode": "AmazonRDS" }, {...} ] } ``` *Para obter mais informações sobre essa operação de API, consulte [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)um [idioma específico AWS SDKs na Referência](https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_pricing_DescribeServices.html#API_pricing_DescribeServices_SeeAlso) da Gerenciamento de Faturamento e Custos da AWS API* **nota** Embora a `DescribeServices` API atualmente não retorne `serviceCodes` para os Savings Plans, você precisará do seguinte `serviceCodes` para usar os Savings Plans em chamadas de API subsequentes: | ServiceCode | SavingsPlanCode | | --- | --- | | ComputeSavingsPlans | AWSComputeSavingsPlan | | MachineLearningSavingsPlans | AWSMachineLearningSavingsPlans | | DatabaseSavingsPlans | AWSDatabaseSavingsPlans | Use os `ServiceCode` valores ao trabalhar com as operações da `GetPriceListFileUrl` API `ListPriceLists` e. Isso só `SavingsPlanCode` é necessário se você estiver baixando os arquivos da lista de preços manualmente em vez de usar APIs o. ### Etapa 2: Localizar arquivos de lista de preços para um arquivo disponível AWS service (Serviço da AWS) Use a operação `ListPriceLists` da API para obter uma lista de referências de listas de preços para as quais você tem permissão de visualização. Para filtrar seus resultados, é possível especificar os parâmetros `ServiceCode`, `CurrencyCode` e `EffectiveDate`. Esse Região da AWS é o endpoint da API Price List Bulk. Os endpoints não estão relacionados aos atributos do produto ou serviço. #### Exemplos para encontrar arquivos de lista de preços **Example Exemplo: Encontre arquivos de listas de preços para todos Regiões da AWS** Se você não especificar o parâmetro `--region-code`, a operação de API retornará as referências do arquivo de lista de preços de todas as Regiões da AWS disponíveis. ``` aws pricing list-price-lists --service-code AmazonRDS --currency-code USD --effective-date "2023-04-03 00:00" ``` **Resposta** ``` { "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 Exemplo: encontrar arquivos de lista de preços para uma região específica** Se você especificar o parâmetro `RegionCode`, a operação de API retornará as referências do arquivo de lista de preços específicas dessa região. Para encontrar arquivos históricos de lista de preços, use o parâmetro `EffectiveDate`. Por exemplo, você pode especificar uma data no passado para encontrar um arquivo específico de lista de preços. Com base na resposta, você poderá usar o valor `PriceListArn` com a operação [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) da API para obter os arquivos de lista de preços da sua preferência. ``` aws pricing list-price-lists --service-code AmazonRDS --currency-code USD --region-code us-west-2 --effective-date "2023-04-03 00:00" ``` **Resposta** ``` { "PriceLists": [ { "CurrencyCode": "USD", "FileFormats": [ "json", "csv" ], "PriceListArn": "arn:aws:pricing:::price-list/aws/AmazonRDS/USD/20230328234721/us-west-2", "RegionCode": "us-west-2" } ] } ``` Para obter mais informações sobre essa operação de API, consulte [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)um [idioma específico AWS SDKs na Referência](https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_pricing_ListPriceLists.html#API_pricing_ListPriceLists_SeeAlso) da *Gerenciamento de Faturamento e Custos da AWS API*. ### Etapa 3: obtenção de um arquivo específico de lista de preços Use a operação `GetPriceListFileUrl` da API para obter um URL para um arquivo de lista de preços. Esse URL é baseado nos valores `PriceListArn` e `FileFormats` que você recuperou da resposta `ListPriceLists` na [etapa 1](#price-bulk-api-step-1-find-available-services) e na [etapa 2](#price-list-bulk-api-step-2-find-available-price-list-files). **Example Exemplo: obter um arquivo específico de lista de preços** O comando a seguir obtém o URL de um arquivo de lista de preços específico para o 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 ``` **Resposta** ``` { "Url": "https://pricing.us-east-1.amazonaws.com/offers/v1.0/aws/AmazonRDS/20230328234721/us-east-1/index.json" } ``` Com base na resposta, você poderá usar o URL para baixar o arquivo de lista de preços. Para obter mais informações sobre essa operação de API, consulte os seguintes tópicos: + [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)*e [específico do idioma AWS SDKs na Referência](https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_pricing_GetPriceListFileUrl.html#API_pricing_GetPriceListFileUrl_SeeAlso) da API Gerenciamento de Faturamento e Custos da AWS * + [Leitura dos arquivos de lista de preços](bulk-api-reading-price-list-files.md)