Skip to main content

Migrando dos pontos de extremidade usados para a plataforma de cobrança anterior

Se a sua organização utilizava anteriormente uma plataforma de faturamento anterior à cobrança por consumo, este artigo explica como migrar os relatórios de uso existentes para os pontos de extremidade de faturamento atuais.

Quem pode usar esse recurso?

Enterprise owners, organization owners, and billing managers

A nova plataforma de cobrança está disponível para todos os usuários.

Após você fazer a transição para a cobrança limitada, os pontos de extremidade usados para obter dados da plataforma de cobrança anterior não retornarão mais informações de uso precisas.

Você precisará atualizar todas as chamadas que utilizam os /ACCOUNT-TYPE/NAME/settings/billing/PRODUCT pontos de extremidade da API REST anteriores para usar o endpoint equivalente /ACCOUNT-TYPE/NAME/settings/billing/usage.

Alterações na autenticação

Se você usou um fine-grained personal access token para autenticar com os pontos de extremidade anteriores, precisará criar um personal access token (classic) para autenticar com o novo ponto de extremidade.

Além disso, talvez você queira usar os novos parâmetros de consulta para especificar um período ou um centro de custo.

Calculando informações de GitHub Actions dos novos dados de resposta

Exemplo da resposta anterior

{"total_minutes_used": 305, "total_paid_minutes_used": 0, "included_minutes": 3000, "minutes_used_breakdown": { "UBUNTU": 205, "MACOS": 10, "WINDOWS": 90 }  }

Exemplo da nova resposta

{ "usageItems": [ { "date": "2023-08-01", "product": "Actions", "sku": "Actions Linux", "quantity": 100, "unitType": "minutes", "pricePerUnit": 0.008, "grossAmount": 0.8, "discountAmount": 0, "netAmount": 0.8, "organizationName": "GitHub", "repositoryName": "github/example"} ] }

Para obter os mesmos valores a partir dos novos dados de resposta:

Propriedade anteriorCalcular a partir da nova resposta da API
total_minutes_used
  1. Filtrar resultados por "product": "Actions" e "unitType": "minutes"
  2. Soma quantity
total_paid_minutes_usedIsso agora é representado como um valor em dólares através de netAmount.
  1. Filtrar resultados por "product": "Actions" e "unitType": "minutes"
  2. Soma netAmount
included_minutesIsso agora é representado como um valor em dólares através de discountAmount.
  1. Filtrar resultados por "product": "Actions" e "unitType": "minutes"
  2. Soma discountAmount
minutes_used_breakdown
  1. Filtrar resultados por "product": "Actions" e "unitType": "minutes"
  2. Some quantity agrupado por sku

Calculando informações de GitHub Packages dos novos dados de resposta

Exemplo da resposta anterior

{ "total_gigabytes_bandwidth_used": 50, "total_paid_gigabytes_bandwidth_used": 40, "included_gigabytes_bandwidth": 10 }

Exemplo da nova resposta

{ "usageItems": [ { "date": "2023-08-01", "product": "Packages", "sku": "Packages data transfer", "quantity": 100, "unitType": "gigabytes", "pricePerUnit": 0.008, "grossAmount": 0.8, "discountAmount": 0, "netAmount": 0.8, "organizationName": "GitHub", "repositoryName": "github/example" } ] }
Propriedade anteriorCalcular a partir da nova resposta da API
total_gigabytes_bandwidth_used
  1. Filtrar resultados por "product": "Packages" e "unitType": "gigabytes"
  2. Soma quantity
total_paid_gigabytes_bandwidth_usedIsso agora é representado como um valor em dólares através de netAmount.
  1. Filtrar resultados por "product": "Packages" e "unitType": "gigabytes"
  2. Soma netAmount
included_gigabytes_bandwidthIsso agora é representado como um valor em dólares através de discountAmount.
  1. Filtrar resultados por "product": "Packages" e "unitType": "gigabytes"
  2. Soma discountAmount

Calculando informações de armazenamento compartilhado dos novos dados de resposta

Exemplo da resposta anterior

{ "days_left_in_billing_cycle": 20, "estimated_paid_storage_for_month": 15, "estimated_storage_for_month": 40 }

Exemplo da nova resposta

{ "usageItems": [ { "date": "2023-08-01", "product": "Packages", "sku": "Packages storage", "quantity": 100, "unitType": "GigabyteHours", "pricePerUnit": 0.008, "grossAmount": 0.8, "discountAmount": 0, "netAmount": 0.8, "organizationName": "GitHub", "repositoryName": "github/example" } ] }
Propriedade anteriorCalcular a partir da nova resposta da API
days_left_in_billing_cycleNão disponível. Essa informação pode ser inferida subtraindo-se o dia atual do mês do número de dias do mês atual.
estimated_paid_storage_for_monthIsso agora é representado como um valor em dólares através de netAmount.

Pré-requisito: passe os parâmetros de consulta month e year.

Para armazenamento do Actions
  1. Filtrar resultados por "product": "Actions" e "unitType": "GigabyteHours"
  2. Soma netAmount
Para armazenamento de pacotes
  1. Filtrar resultados por "product": "Packages" e "unitType": "GigabyteHours"
  2. Soma netAmount
estimated_storage_for_monthPré-requisito: passe os parâmetros de consulta month e year.

Para armazenamento do Actions
  1. Filtrar resultados por "product": "Actions" e "unitType": "GigabyteHours"
  2. Soma quantity
Para armazenamento de pacotes
  1. Filtrar resultados por "product": "Packages" e "unitType": "GigabyteHours"
  2. Soma quantity