Obter arquivos de lista de preços usando a API AWS Price List Bulk - AWS Faturamento

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. 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.

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.

exemplo 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 DescribeServicese específico do idioma AWS SDKs na referência da API AWS Billing and Cost Management

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

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

A partir da resposta, você pode então usar o PriceListArn valor com o GetPriceListFileUrlOperação de API para obter seus arquivos de lista de preços preferidos.

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 ListPriceListse específico do idioma AWS SDKs na Referência da AWS Billing and Cost Management API.

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 e na etapa 2.

exemplo 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: