Localização de serviços e produtos usando a API Price List Query da AWS. - 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á.

Localização de serviços e produtos usando a API Price List Query da AWS.

Participe desta breve pesquisa para fornecer feedback sobre o AWS Price List. 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 Query quando quiser:

  • Encontrar informações sobre preços de um produto.

  • Pesquisar produtos e tarifas correspondentes aos seus filtros.

  • Encontrar rapidamente os produtos e os preços de que você precisa ao desenvolver aplicações com recursos limitados, como ambientes front-end.

Para encontrar Serviços da AWS, seus produtos e os atributos e preços dos produtos, veja as etapas a seguir.

Após encontrar o serviço, você poderá obter seus atributos usando a operação DescribeServices da API. Se souber o código do serviço, você também poderá usar a API Price List Query da AWS para obter atributos de um serviço. Em seguida, você pode usar os atributos do serviço para encontrar os produtos que atendem aos seus requisitos com base nos valores dos atributos.

Exemplos: encontrar serviços

Os seguintes comandos da AWS Command Line Interface (AWS CLI) mostram como encontrar serviços.

exemplo Exemplo: encontrar todos os serviços
aws pricing describe-services --region us-east-1

Resposta

{
    "FormatVersion": "aws_v1", 
    "NextToken": "abcdefg123", 
    "Services": [ 
        {
            "AttributeNames": [ 
                "volumeType", 
                "maxIopsvolume", 
                "instanceCapacity10xlarge", 
                "locationType", 
                "operation" 
            ], 
            "ServiceCode": "AmazonEC2" 
        },
        {
            "AttributeNames": [ 
                "productFamily", 
                "volumeType", 
                "engineCode", 
                "memory" 
            ], 
            "ServiceCode": "AmazonRDS" 
        },
        {...} 
    ] 
}
exemplo Exemplo: encontrar metadados de serviço para o Amazon Elastic Compute Cloud (Amazon EC2)

O comando a seguir mostra como encontrar metadados de serviço para o Amazon EC2.

aws pricing describe-services --region us-east-1 --service-code AmazonEC2

Resposta

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

A Região da AWS é o endpoint da API para a API Price List Query. Os endpoints não estão relacionados aos atributos do produto ou serviço.

Para obter mais informações, consulte DescribeServices na Referência de APIs do Gerenciamento de Faturamento e Custos da AWS.

Na etapa 1, você recuperou uma lista de atributos para um AWS service (Serviço da AWS). Nesta etapa, você usará esses atributos para pesquisar produtos. Na etapa 3, você precisará dos valores disponíveis para esses atributos.

Para encontrar os valores de um atributo, use a operação GetAttributeValues da API. Para chamar a API, especifique os parâmetros AttributeName e ServiceCode.

Exemplo: obter valores de atributo

O seguinte comando da AWS Command Line Interface (AWS CLI) mostra como obter valores de atributos para um AWS service (Serviço da AWS).

exemplo Exemplo: encontrar valores de atributos para o Amazon Relational Database Service (Amazon RDS)
aws pricing get-attribute-values --service-code AmazonRDS --attribute-name operation --region us-east-1

Resposta

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

A Região da AWS é o endpoint da API para a API Price List Query. Os endpoints não estão relacionados aos atributos do produto ou serviço.

Para obter mais informações, consulte GetAttributeValues e SDKs da AWS para linguagens específicas na Referência da API Gerenciamento de Faturamento e Custos da AWS.

Nesta etapa, você usa as informações da etapa 1 e da etapa 2 para encontrar os produtos e seus períodos. Para obter informações sobre produtos, use a operação GetProducts da API. Você pode especificar uma lista de filtros para obter os produtos que deseja.

nota

A API Price List Query só é compatível com correspondência "AND". A resposta ao seu comando contém apenas produtos que correspondam a todos os filtros especificados.

Exemplos: encontrar produtos com base em atributos

Os seguintes comandos da AWS Command Line Interface (AWS CLI) mostram como encontrar produtos usando atributos.

exemplo Exemplo: encontrar produtos com filtros específicos

O comando a seguir mostra como você pode especificar filtros para o 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"

Resposta

{
    "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"
}
exemplo Exemplo: usar o arquivo filters.json para especificar filtros

O comando a seguir mostra como você pode especificar um arquivo JSON contendo todos os filtros.

aws pricing get-products --service-code AmazonRDS --region us-east-1 --filters file://filters.json

Por exemplo, o arquivo filters.json pode incluir os filtros a seguir.

[
  {
    "Type": "TERM_MATCH",
    "Field": "operation",
    "Value": "CreateDBInstance:0002"
  }
]

O exemplo a seguir mostra como você pode especificar mais de um filtro.

[
  {
    "Type": "TERM_MATCH",
    "Field": "AttributeName1",
    "Value": "AttributeValue1"
  },
  {
    "Type": "TERM_MATCH",
    "Field": "AttributeName2",
    "Value": "AttributeValue2"
  },
  ...
]

Resposta

{
    "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"
}

Para obter mais informações, consulte os tópicos a seguir.