Skip to content

Commit

Permalink
Generated v5.6.0
Browse files Browse the repository at this point in the history
  • Loading branch information
github-actions committed Aug 5, 2024
1 parent 95baec1 commit c84480a
Show file tree
Hide file tree
Showing 105 changed files with 16,780 additions and 130 deletions.
10 changes: 10 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,15 @@
# Changelog

## [v5.6.0](https://github.com/fastly/fastly-php/releases/tag/release/v5.6.0) (2024-08-04)

**Enhancements:**

- feat(observability): Adds new Observability Custom Dashboards API
- feat(billing-invoices): Adds month-to-date invoice information
- feat(billing-usage-metrics): Adds information on service-level usage.
- feat(tls): Adds an endpoint to get a TLS certificate blob (Limited Availability)
- feat(stats): Add `origin_offload` metric

## [v5.5.0](https://github.com/fastly/fastly-php/releases/tag/release/v5.5.0) (2024-07-01)

**Bug fixes:**
Expand Down
15 changes: 14 additions & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -118,7 +118,10 @@ Class | Method | Description
[*BillingAddressApi*](docs/Api/BillingAddressApi.md) | [**getBillingAddr**](docs/Api/BillingAddressApi.md#getbillingaddr) | Get a billing address
[*BillingAddressApi*](docs/Api/BillingAddressApi.md) | [**updateBillingAddr**](docs/Api/BillingAddressApi.md#updatebillingaddr) | Update a billing address
[*BillingInvoicesApi*](docs/Api/BillingInvoicesApi.md) | [**getInvoiceByInvoiceId**](docs/Api/BillingInvoicesApi.md#getinvoicebyinvoiceid) | Get invoice by ID.
[*BillingInvoicesApi*](docs/Api/BillingInvoicesApi.md) | [**getMonthToDateInvoice**](docs/Api/BillingInvoicesApi.md#getmonthtodateinvoice) | Get month-to-date invoice.
[*BillingInvoicesApi*](docs/Api/BillingInvoicesApi.md) | [**listInvoices**](docs/Api/BillingInvoicesApi.md#listinvoices) | List of invoices.
[*BillingUsageMetricsApi*](docs/Api/BillingUsageMetricsApi.md) | [**getServiceLevelUsage**](docs/Api/BillingUsageMetricsApi.md#getservicelevelusage) | Retrieve service-level usage metrics for a product.
[*BillingUsageMetricsApi*](docs/Api/BillingUsageMetricsApi.md) | [**getServiceLevelUsageTypes**](docs/Api/BillingUsageMetricsApi.md#getservicelevelusagetypes) | Retrieve product usage types for a customer.
[*CacheSettingsApi*](docs/Api/CacheSettingsApi.md) | [**createCacheSettings**](docs/Api/CacheSettingsApi.md#createcachesettings) | Create a cache settings object
[*CacheSettingsApi*](docs/Api/CacheSettingsApi.md) | [**deleteCacheSettings**](docs/Api/CacheSettingsApi.md#deletecachesettings) | Delete a cache settings object
[*CacheSettingsApi*](docs/Api/CacheSettingsApi.md) | [**getCacheSettings**](docs/Api/CacheSettingsApi.md#getcachesettings) | Get a cache settings object
Expand Down Expand Up @@ -430,6 +433,11 @@ Class | Method | Description
[*MutualAuthenticationApi*](docs/Api/MutualAuthenticationApi.md) | [**getMutualAuthentication**](docs/Api/MutualAuthenticationApi.md#getmutualauthentication) | Get a Mutual Authentication
[*MutualAuthenticationApi*](docs/Api/MutualAuthenticationApi.md) | [**listMutualAuthentications**](docs/Api/MutualAuthenticationApi.md#listmutualauthentications) | List Mutual Authentications
[*MutualAuthenticationApi*](docs/Api/MutualAuthenticationApi.md) | [**patchMutualAuthentication**](docs/Api/MutualAuthenticationApi.md#patchmutualauthentication) | Update a Mutual Authentication
[*ObservabilityCustomDashboardsApi*](docs/Api/ObservabilityCustomDashboardsApi.md) | [**createDashboard**](docs/Api/ObservabilityCustomDashboardsApi.md#createdashboard) | Create a new dashboard
[*ObservabilityCustomDashboardsApi*](docs/Api/ObservabilityCustomDashboardsApi.md) | [**deleteDashboard**](docs/Api/ObservabilityCustomDashboardsApi.md#deletedashboard) | Delete an existing dashboard
[*ObservabilityCustomDashboardsApi*](docs/Api/ObservabilityCustomDashboardsApi.md) | [**getDashboard**](docs/Api/ObservabilityCustomDashboardsApi.md#getdashboard) | Retrieve a dashboard by ID
[*ObservabilityCustomDashboardsApi*](docs/Api/ObservabilityCustomDashboardsApi.md) | [**listDashboards**](docs/Api/ObservabilityCustomDashboardsApi.md#listdashboards) | List all custom dashboards
[*ObservabilityCustomDashboardsApi*](docs/Api/ObservabilityCustomDashboardsApi.md) | [**updateDashboard**](docs/Api/ObservabilityCustomDashboardsApi.md#updatedashboard) | Update an existing dashboard
[*OriginInspectorHistoricalApi*](docs/Api/OriginInspectorHistoricalApi.md) | [**getOriginInspectorHistorical**](docs/Api/OriginInspectorHistoricalApi.md#getorigininspectorhistorical) | Get historical origin data for a service
[*OriginInspectorRealtimeApi*](docs/Api/OriginInspectorRealtimeApi.md) | [**getOriginInspectorLast120Seconds**](docs/Api/OriginInspectorRealtimeApi.md#getorigininspectorlast120seconds) | Get real-time origin data for the last 120 seconds
[*OriginInspectorRealtimeApi*](docs/Api/OriginInspectorRealtimeApi.md) | [**getOriginInspectorLastMaxEntries**](docs/Api/OriginInspectorRealtimeApi.md#getorigininspectorlastmaxentries) | Get a limited number of real-time origin data entries
Expand Down Expand Up @@ -531,6 +539,7 @@ Class | Method | Description
[*TlsCertificatesApi*](docs/Api/TlsCertificatesApi.md) | [**createTlsCert**](docs/Api/TlsCertificatesApi.md#createtlscert) | Create a TLS certificate
[*TlsCertificatesApi*](docs/Api/TlsCertificatesApi.md) | [**deleteTlsCert**](docs/Api/TlsCertificatesApi.md#deletetlscert) | Delete a TLS certificate
[*TlsCertificatesApi*](docs/Api/TlsCertificatesApi.md) | [**getTlsCert**](docs/Api/TlsCertificatesApi.md#gettlscert) | Get a TLS certificate
[*TlsCertificatesApi*](docs/Api/TlsCertificatesApi.md) | [**getTlsCertBlob**](docs/Api/TlsCertificatesApi.md#gettlscertblob) | Get a TLS certificate blob (Limited Availability)
[*TlsCertificatesApi*](docs/Api/TlsCertificatesApi.md) | [**listTlsCerts**](docs/Api/TlsCertificatesApi.md#listtlscerts) | List TLS certificates
[*TlsCertificatesApi*](docs/Api/TlsCertificatesApi.md) | [**updateTlsCert**](docs/Api/TlsCertificatesApi.md#updatetlscert) | Update a TLS certificate
[*TlsConfigurationsApi*](docs/Api/TlsConfigurationsApi.md) | [**getTlsConfig**](docs/Api/TlsConfigurationsApi.md#gettlsconfig) | Get a TLS configuration
Expand Down Expand Up @@ -628,6 +637,8 @@ The fastly-php API client currently does not support the following endpoints:
- [`/alerts/definitions/{definition_id}`](https://www.fastly.com/documentation/reference/api/observability/alerts/definitions) (DELETE, GET, PUT)
- [`/alerts/definitions`](https://www.fastly.com/documentation/reference/api/observability/alerts/definitions) (GET, POST)
- [`/alerts/history`](https://www.fastly.com/documentation/reference/api/observability/alerts/history) (GET)
- [`/dns/configurations/{dns_configuration_id}`](https://www.fastly.com/documentation/reference/api/) (DELETE, GET, PATCH)
- [`/dns/configurations`](https://www.fastly.com/documentation/reference/api/) (GET, POST)
- [`/notifications/integration-types`](https://developer.fastly.com/reference/api/observability/notification) (GET)
- [`/notifications/integrations/{integration_id}/rotateSigningKey`](https://developer.fastly.com/reference/api/observability/notification) (POST)
- [`/notifications/integrations/{integration_id}/signingKey`](https://developer.fastly.com/reference/api/observability/notification) (GET)
Expand All @@ -637,7 +648,9 @@ The fastly-php API client currently does not support the following endpoints:
- [`/resources/stores/kv/{store_id}/batch`](https://www.fastly.com/documentation/reference/api/services/resources/kv-store-item) (PUT)
- [`/tls/activations/{tls_activation_id}`](https://www.fastly.com/documentation/reference/api/tls/mutual-tls/activations) (GET, PATCH)
- [`/tls/activations`](https://www.fastly.com/documentation/reference/api/tls/mutual-tls/activations) (GET)
- [`/tls/preview/domains/{tls_preview_domain_id}`](https://www.fastly.com/documentation/reference/api/) (GET, PATCH)
- [`/tls/configurations/{tls_configuration_id}`](https://www.fastly.com/documentation/reference/api/) (DELETE, GET, PATCH)
- [`/tls/configurations`](https://www.fastly.com/documentation/reference/api/) (GET, POST)
- [`/tls/preview/domains/{domain_id}`](https://www.fastly.com/documentation/reference/api/) (GET, PATCH)
- [`/tls/preview/domains`](https://www.fastly.com/documentation/reference/api/) (GET, POST)
- [`/v1/channel/{service_id}/ts/h/limit/{max_entries}`](https://www.fastly.com/documentation/reference/api/metrics-stats/origin-insights) (GET)
- [`/v1/channel/{service_id}/ts/h`](https://www.fastly.com/documentation/reference/api/metrics-stats/origin-insights) (GET)
Expand Down
40 changes: 36 additions & 4 deletions docs/Api/BillingInvoicesApi.md
Original file line number Diff line number Diff line change
Expand Up @@ -18,13 +18,14 @@ $apiInstance = new Fastly\Api\BillingInvoicesApi(
Method | HTTP request | Description
------ | ------------ | -----------
[**getInvoiceByInvoiceId()**](BillingInvoicesApi.md#getInvoiceByInvoiceId) | **GET** /billing/v3/invoices/{invoice_id} | Get invoice by ID.
[**getMonthToDateInvoice()**](BillingInvoicesApi.md#getMonthToDateInvoice) | **GET** /billing/v3/invoices/month-to-date | Get month-to-date invoice.
[**listInvoices()**](BillingInvoicesApi.md#listInvoices) | **GET** /billing/v3/invoices | List of invoices.


## `getInvoiceByInvoiceId()`

```php
getInvoiceByInvoiceId($options): \Fastly\Model\InvoiceResponse // Get invoice by ID.
getInvoiceByInvoiceId($options): \Fastly\Model\EomInvoiceResponse // Get invoice by ID.
```

Returns invoice associated with the invoice id.
Expand All @@ -50,15 +51,46 @@ Name | Type | Description | Notes

### Return type

[**\Fastly\Model\InvoiceResponse**](../Model/InvoiceResponse.md)
[**\Fastly\Model\EomInvoiceResponse**](../Model/EomInvoiceResponse.md)

[[Back to top]](#) [[Back to API list]](../../README.md#endpoints)
[[Back to README]](../../README.md)

## `getMonthToDateInvoice()`

```php
getMonthToDateInvoice($options): \Fastly\Model\MtdInvoiceResponse // Get month-to-date invoice.
```

Returns month-to-date invoice for the current month.

### Example
```php

try {
$result = $apiInstance->getMonthToDateInvoice($options);
} catch (Exception $e) {
echo 'Exception when calling BillingInvoicesApi->getMonthToDateInvoice: ', $e->getMessage(), PHP_EOL;
}
```

### Options

Note: the input parameter is an associative array with the keys listed below.

This endpoint does not need any parameters.

### Return type

[**\Fastly\Model\MtdInvoiceResponse**](../Model/MtdInvoiceResponse.md)

[[Back to top]](#) [[Back to API list]](../../README.md#endpoints)
[[Back to README]](../../README.md)

## `listInvoices()`

```php
listInvoices($options): \Fastly\Model\ListInvoicesResponse // List of invoices.
listInvoices($options): \Fastly\Model\ListEomInvoicesResponse // List of invoices.
```

Returns the list of invoices, sorted by billing start date (newest to oldest).
Expand Down Expand Up @@ -90,7 +122,7 @@ Name | Type | Description | Notes

### Return type

[**\Fastly\Model\ListInvoicesResponse**](../Model/ListInvoicesResponse.md)
[**\Fastly\Model\ListEomInvoicesResponse**](../Model/ListEomInvoicesResponse.md)

[[Back to top]](#) [[Back to API list]](../../README.md#endpoints)
[[Back to README]](../../README.md)
108 changes: 108 additions & 0 deletions docs/Api/BillingUsageMetricsApi.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,108 @@
# Fastly\Api\BillingUsageMetricsApi


```php
$apiInstance = new Fastly\Api\BillingUsageMetricsApi(
// If you want use custom http client, pass your client which implements `GuzzleHttp\ClientInterface`.
// This is optional, `GuzzleHttp\Client` will be used as default.
new GuzzleHttp\Client(),
$config
);
```

## Methods

> [!NOTE]
> All URIs are relative to `https://api.fastly.com`
Method | HTTP request | Description
------ | ------------ | -----------
[**getServiceLevelUsage()**](BillingUsageMetricsApi.md#getServiceLevelUsage) | **GET** /billing/v2/account_customers/{customer_id}/service-usage-metrics | Retrieve service-level usage metrics for a product.
[**getServiceLevelUsageTypes()**](BillingUsageMetricsApi.md#getServiceLevelUsageTypes) | **GET** /billing/v2/account_customers/{customer_id}/service-usage-types | Retrieve product usage types for a customer.


## `getServiceLevelUsage()`

```php
getServiceLevelUsage($options): \Fastly\Model\Serviceusagemetrics // Retrieve service-level usage metrics for a product.
```

Returns product usage, broken down by service.

### Example
```php
$options['customer_id'] = 'customer_id_example'; // string | Alphanumeric string identifying the customer.
$options['product_id'] = 'product_id_example'; // string | The product identifier for the metrics returned (e.g., `cdn_usage`). This field is not required for CSV requests.
$options['usage_type_name'] = 'usage_type_name_example'; // string | The usage type name for the metrics returned (e.g., `North America Requests`). This field is not required for CSV requests.
$options['time_granularity'] = 'time_granularity_example'; // string
$options['start_date'] = 2023-01-01; // string
$options['end_date'] = 2023-01-31; // string
$options['start_month'] = 2023-01; // string
$options['end_month'] = 2023-03; // string
$options['limit'] = '5'; // string | Number of results per page. The maximum is 100.
$options['cursor'] = 'cursor_example'; // string | Cursor value from the `next_cursor` field of a previous response, used to retrieve the next page. To request the first page, this should be empty.

try {
$result = $apiInstance->getServiceLevelUsage($options);
} catch (Exception $e) {
echo 'Exception when calling BillingUsageMetricsApi->getServiceLevelUsage: ', $e->getMessage(), PHP_EOL;
}
```

### Options

Note: the input parameter is an associative array with the keys listed below.

Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**customer_id** | **string** | Alphanumeric string identifying the customer. |
**product_id** | **string** | The product identifier for the metrics returned (e.g., `cdn_usage`). This field is not required for CSV requests. |
**usage_type_name** | **string** | The usage type name for the metrics returned (e.g., `North America Requests`). This field is not required for CSV requests. |
**time_granularity** | **string** | |
**start_date** | **string** | | [optional]
**end_date** | **string** | | [optional]
**start_month** | **string** | | [optional]
**end_month** | **string** | | [optional]
**limit** | **string** | Number of results per page. The maximum is 100. | [optional] [defaults to '5']
**cursor** | **string** | Cursor value from the `next_cursor` field of a previous response, used to retrieve the next page. To request the first page, this should be empty. | [optional]

### Return type

[**\Fastly\Model\Serviceusagemetrics**](../Model/Serviceusagemetrics.md)

[[Back to top]](#) [[Back to API list]](../../README.md#endpoints)
[[Back to README]](../../README.md)

## `getServiceLevelUsageTypes()`

```php
getServiceLevelUsageTypes($options): \Fastly\Model\Serviceusagetypes // Retrieve product usage types for a customer.
```

Returns product usage types reported by the customer's services.

### Example
```php
$options['customer_id'] = 'customer_id_example'; // string | Alphanumeric string identifying the customer.

try {
$result = $apiInstance->getServiceLevelUsageTypes($options);
} catch (Exception $e) {
echo 'Exception when calling BillingUsageMetricsApi->getServiceLevelUsageTypes: ', $e->getMessage(), PHP_EOL;
}
```

### Options

Note: the input parameter is an associative array with the keys listed below.

Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**customer_id** | **string** | Alphanumeric string identifying the customer. |

### Return type

[**\Fastly\Model\Serviceusagetypes**](../Model/Serviceusagetypes.md)

[[Back to top]](#) [[Back to API list]](../../README.md#endpoints)
[[Back to README]](../../README.md)
2 changes: 1 addition & 1 deletion docs/Api/ImageOptimizerDefaultSettingsApi.md
Original file line number Diff line number Diff line change
Expand Up @@ -69,7 +69,7 @@ Update one or more default settings. A minimum of one property is required. The
```php
$options['service_id'] = 'service_id_example'; // string | Alphanumeric string identifying the service.
$options['version_id'] = 56; // int | Integer identifying a service version.
$options['default_settings'] = {"type":"object","properties":{"resize_filter":{"type":"string","enum":["lanczos3","lanczos2","bicubic","bilinear","nearest"],"default":"lanczos3","description":"The type of filter to use while resizing an image.","x-enum-descriptions":["A Lanczos filter with a kernel size of 3. Lanczos filters can detect edges and linear features within an image, providing the best possible reconstruction.","A Lanczos filter with a kernel size of 2.","A filter using an average of a 4x4 environment of pixels, weighing the innermost pixels higher.","A filter using an average of a 2x2 environment of pixels.","A filter using the value of nearby translated pixel values. Preserves hard edges."]},"webp":{"type":"boolean","default":false,"description":"Controls whether or not to default to WebP output when the client supports it. This is equivalent to adding \"auto=webp\" to all image optimizer requests.\n"},"webp_quality":{"type":"integer","minimum":1,"maximum":100,"default":85,"description":"The default quality to use with WebP output. This can be overridden with the second option in the \"quality\" URL parameter on specific image optimizer requests.\n"},"jpeg_type":{"type":"string","enum":["auto","baseline","progressive"],"default":"auto","description":"The default type of JPEG output to use. This can be overridden with \"format=bjpeg\" and \"format=pjpeg\" on specific image optimizer requests.\n","x-enum-descriptions":["Match the input JPEG type, or baseline if transforming from a non-JPEG input.","Output baseline JPEG images","Output progressive JPEG images"]},"jpeg_quality":{"type":"integer","minimum":1,"maximum":100,"default":85,"description":"The default quality to use with JPEG output. This can be overridden with the \"quality\" parameter on specific image optimizer requests.\n"},"upscale":{"type":"boolean","default":false,"description":"Whether or not we should allow output images to render at sizes larger than input.\n"},"allow_video":{"type":"boolean","default":false,"description":"Enables GIF to MP4 transformations on this service."}}}; // \Fastly\Model\DefaultSettings
$options['default_settings'] = new \Fastly\Model\DefaultSettings(); // \Fastly\Model\DefaultSettings

try {
$result = $apiInstance->updateDefaultSettings($options);
Expand Down
Loading

0 comments on commit c84480a

Please sign in to comment.