Skip to content

Commit

Permalink
Generated v5.1.0
Browse files Browse the repository at this point in the history
  • Loading branch information
github-actions committed Feb 28, 2024
1 parent a5365f3 commit 074173c
Show file tree
Hide file tree
Showing 118 changed files with 8,383 additions and 226 deletions.
26 changes: 22 additions & 4 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,23 @@
# Changelog

## [v5.1.0](https://github.com/fastly/fastly-php/releases/tag/release/v5.1.0) (2024-02-28)

**Enhancements:**

- feat(billing): add 'get invoice by invoice ID' endpoint.
- feat(billing): add 'list invoices' endpoint.
- feat(image_opto): add 'shield' and 'transform' methods and fields.
- feat(secret_store): add 'name' filter.
- feat(tls): add 'create CSR' endpoint.
- feat(tls_subscription): add 'active order' methods and fields.

**Documentation:**

- doc(backend) fix openssl link.
- doc(director,domain_inspector,pool,realtime) fix POPs link.
- doc(service) fix service version link.
- doc(tls) fix activation link.

## [v5.0.1](https://github.com/fastly/fastly-php/releases/tag/release/v5.0.1) (2024-02-19)

**Bug fixes:**
Expand Down Expand Up @@ -284,7 +302,7 @@ Substantial changes were made to the underlying OpenAPI specification that produ

**Enhancements:**

* New interface from code-generated API client [#43](https://github.com/fastly/fastly-php/pull/43)
* [Blog post: Better Fastly API clients with OpenAPI Generator](https://dev.to/fastly/better-fastly-api-clients-with-openapi-generator-3lno)
* [Documentation](https://github.com/fastly/fastly-php#documentation-for-api-endpoints)
* [Unsupported API endpoints](https://github.com/fastly/fastly-php#issues)
- New interface from code-generated API client [#43](https://github.com/fastly/fastly-php/pull/43)
- [Blog post: Better Fastly API clients with OpenAPI Generator](https://dev.to/fastly/better-fastly-api-clients-with-openapi-generator-3lno)
- [Documentation](https://github.com/fastly/fastly-php#documentation-for-api-endpoints)
- [Unsupported API endpoints](https://github.com/fastly/fastly-php#issues)
18 changes: 12 additions & 6 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -110,6 +110,8 @@ Class | Method | Description
[*BillingAddressApi*](docs/Api/BillingAddressApi.md) | [**deleteBillingAddr**](docs/Api/BillingAddressApi.md#deletebillingaddr) | Delete a billing address
[*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) | [**listInvoices**](docs/Api/BillingInvoicesApi.md#listinvoices) | List of invoices.
[*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 @@ -525,6 +527,7 @@ Class | Method | Description
[*TlsConfigurationsApi*](docs/Api/TlsConfigurationsApi.md) | [**getTlsConfig**](docs/Api/TlsConfigurationsApi.md#gettlsconfig) | Get a TLS configuration
[*TlsConfigurationsApi*](docs/Api/TlsConfigurationsApi.md) | [**listTlsConfigs**](docs/Api/TlsConfigurationsApi.md#listtlsconfigs) | List TLS configurations
[*TlsConfigurationsApi*](docs/Api/TlsConfigurationsApi.md) | [**updateTlsConfig**](docs/Api/TlsConfigurationsApi.md#updatetlsconfig) | Update a TLS configuration
[*TlsCsrsApi*](docs/Api/TlsCsrsApi.md) | [**createCsr**](docs/Api/TlsCsrsApi.md#createcsr) | Create CSR
[*TlsDomainsApi*](docs/Api/TlsDomainsApi.md) | [**listTlsDomains**](docs/Api/TlsDomainsApi.md#listtlsdomains) | List TLS domains
[*TlsPrivateKeysApi*](docs/Api/TlsPrivateKeysApi.md) | [**createTlsKey**](docs/Api/TlsPrivateKeysApi.md#createtlskey) | Create a TLS private key
[*TlsPrivateKeysApi*](docs/Api/TlsPrivateKeysApi.md) | [**deleteTlsKey**](docs/Api/TlsPrivateKeysApi.md#deletetlskey) | Delete a TLS private key
Expand Down Expand Up @@ -611,12 +614,15 @@ Class | Method | Description

The fastly-php API client currently does not support the following endpoints:

- [`/resources/stores/kv/{store_id}/batch`](https://developer.fastly.com/reference/api/services/resources/kv-store-item) (PUT)
- [`/tls/activations/{tls_activation_id}`](https://developer.fastly.com/reference/api/tls/mutual-tls/activations) (GET, PATCH)
- [`/tls/activations`](https://developer.fastly.com/reference/api/tls/mutual-tls/activations) (GET)
- [`/v1/channel/{service_id}/ts/h/limit/{max_entries}`](https://developer.fastly.com/reference/api/metrics-stats/origin-insights) (GET)
- [`/v1/channel/{service_id}/ts/h`](https://developer.fastly.com/reference/api/metrics-stats/origin-insights) (GET)
- [`/v1/channel/{service_id}/ts/{start_timestamp}`](https://developer.fastly.com/reference/api/metrics-stats/origin-insights) (GET)
- [`/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)
- [`/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)
- [`/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)
- [`/v1/channel/{service_id}/ts/{start_timestamp}`](https://www.fastly.com/documentation/reference/api/metrics-stats/origin-insights) (GET)


If you encounter any non-security-related bug or unexpected behavior, please [file an issue][bug]
Expand Down
4 changes: 2 additions & 2 deletions docs/Api/AutomationTokensApi.md
Original file line number Diff line number Diff line change
Expand Up @@ -166,7 +166,7 @@ Name | Type | Description | Notes
## `revokeAutomationTokenId()`

```php
revokeAutomationTokenId($options): \Fastly\Model\ErrorResponse // Revoke an Automation Token by ID
revokeAutomationTokenId($options): \Fastly\Model\AutomationTokenErrorResponse // Revoke an Automation Token by ID
```

Revoke an automation token by ID.
Expand All @@ -192,7 +192,7 @@ Name | Type | Description | Notes

### Return type

[**\Fastly\Model\ErrorResponse**](../Model/ErrorResponse.md)
[**\Fastly\Model\AutomationTokenErrorResponse**](../Model/AutomationTokenErrorResponse.md)

[[Back to top]](#) [[Back to API list]](../../README.md#endpoints)
[[Back to README]](../../README.md)
8 changes: 4 additions & 4 deletions docs/Api/BackendApi.md
Original file line number Diff line number Diff line change
Expand Up @@ -57,7 +57,7 @@ $options['shield'] = 'shield_example'; // string | Identifier of the POP to use
$options['ssl_ca_cert'] = 'ssl_ca_cert_example'; // string | CA certificate attached to origin.
$options['ssl_cert_hostname'] = 'ssl_cert_hostname_example'; // string | Overrides `ssl_hostname`, but only for cert verification. Does not affect SNI at all.
$options['ssl_check_cert'] = true; // bool | Be strict on checking SSL certs.
$options['ssl_ciphers'] = 'ssl_ciphers_example'; // string | List of [OpenSSL ciphers](https://www.openssl.org/docs/manmaster/man1/ciphers.html) to support for connections to this origin. If your backend server is not able to negotiate a connection meeting this constraint, a synthetic `503` error response will be generated.
$options['ssl_ciphers'] = 'ssl_ciphers_example'; // string | List of [OpenSSL ciphers](https://www.openssl.org/docs/man1.1.1/man1/ciphers.html) to support for connections to this origin. If your backend server is not able to negotiate a connection meeting this constraint, a synthetic `503` error response will be generated.
$options['ssl_client_cert'] = 'ssl_client_cert_example'; // string | Client certificate attached to origin.
$options['ssl_client_key'] = 'ssl_client_key_example'; // string | Client key attached to origin.
$options['ssl_hostname'] = 'ssl_hostname_example'; // string | Use `ssl_cert_hostname` and `ssl_sni_hostname` to configure certificate validation.
Expand Down Expand Up @@ -104,7 +104,7 @@ Name | Type | Description | Notes
**ssl_ca_cert** | **string** | CA certificate attached to origin. | [optional]
**ssl_cert_hostname** | **string** | Overrides `ssl_hostname`, but only for cert verification. Does not affect SNI at all. | [optional]
**ssl_check_cert** | **bool** | Be strict on checking SSL certs. | [optional] [defaults to true]
**ssl_ciphers** | **string** | List of [OpenSSL ciphers](https://www.openssl.org/docs/manmaster/man1/ciphers.html) to support for connections to this origin. If your backend server is not able to negotiate a connection meeting this constraint, a synthetic `503` error response will be generated. | [optional]
**ssl_ciphers** | **string** | List of [OpenSSL ciphers](https://www.openssl.org/docs/man1.1.1/man1/ciphers.html) to support for connections to this origin. If your backend server is not able to negotiate a connection meeting this constraint, a synthetic `503` error response will be generated. | [optional]
**ssl_client_cert** | **string** | Client certificate attached to origin. | [optional]
**ssl_client_key** | **string** | Client key attached to origin. | [optional]
**ssl_hostname** | **string** | Use `ssl_cert_hostname` and `ssl_sni_hostname` to configure certificate validation. | [optional]
Expand Down Expand Up @@ -268,7 +268,7 @@ $options['shield'] = 'shield_example'; // string | Identifier of the POP to use
$options['ssl_ca_cert'] = 'ssl_ca_cert_example'; // string | CA certificate attached to origin.
$options['ssl_cert_hostname'] = 'ssl_cert_hostname_example'; // string | Overrides `ssl_hostname`, but only for cert verification. Does not affect SNI at all.
$options['ssl_check_cert'] = true; // bool | Be strict on checking SSL certs.
$options['ssl_ciphers'] = 'ssl_ciphers_example'; // string | List of [OpenSSL ciphers](https://www.openssl.org/docs/manmaster/man1/ciphers.html) to support for connections to this origin. If your backend server is not able to negotiate a connection meeting this constraint, a synthetic `503` error response will be generated.
$options['ssl_ciphers'] = 'ssl_ciphers_example'; // string | List of [OpenSSL ciphers](https://www.openssl.org/docs/man1.1.1/man1/ciphers.html) to support for connections to this origin. If your backend server is not able to negotiate a connection meeting this constraint, a synthetic `503` error response will be generated.
$options['ssl_client_cert'] = 'ssl_client_cert_example'; // string | Client certificate attached to origin.
$options['ssl_client_key'] = 'ssl_client_key_example'; // string | Client key attached to origin.
$options['ssl_hostname'] = 'ssl_hostname_example'; // string | Use `ssl_cert_hostname` and `ssl_sni_hostname` to configure certificate validation.
Expand Down Expand Up @@ -316,7 +316,7 @@ Name | Type | Description | Notes
**ssl_ca_cert** | **string** | CA certificate attached to origin. | [optional]
**ssl_cert_hostname** | **string** | Overrides `ssl_hostname`, but only for cert verification. Does not affect SNI at all. | [optional]
**ssl_check_cert** | **bool** | Be strict on checking SSL certs. | [optional] [defaults to true]
**ssl_ciphers** | **string** | List of [OpenSSL ciphers](https://www.openssl.org/docs/manmaster/man1/ciphers.html) to support for connections to this origin. If your backend server is not able to negotiate a connection meeting this constraint, a synthetic `503` error response will be generated. | [optional]
**ssl_ciphers** | **string** | List of [OpenSSL ciphers](https://www.openssl.org/docs/man1.1.1/man1/ciphers.html) to support for connections to this origin. If your backend server is not able to negotiate a connection meeting this constraint, a synthetic `503` error response will be generated. | [optional]
**ssl_client_cert** | **string** | Client certificate attached to origin. | [optional]
**ssl_client_key** | **string** | Client key attached to origin. | [optional]
**ssl_hostname** | **string** | Use `ssl_cert_hostname` and `ssl_sni_hostname` to configure certificate validation. | [optional]
Expand Down
93 changes: 93 additions & 0 deletions docs/Api/BillingInvoicesApi.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,93 @@
# Fastly\Api\BillingInvoicesApi


```php
$apiInstance = new Fastly\Api\BillingInvoicesApi(
// 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

Method | Fastly API endpoint | Description
------------- | ------------- | -------------
[**getInvoiceByInvoiceId()**](BillingInvoicesApi.md#getInvoiceByInvoiceId) | **GET** /billing/v3/invoices/{invoice_id} | Get invoice by ID.
[**listInvoices()**](BillingInvoicesApi.md#listInvoices) | **GET** /billing/v3/invoices | List of invoices.


## `getInvoiceByInvoiceId()`

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

Returns invoice associated with the invoice id.

### Example
```php
$options['invoice_id'] = 'invoice_id_example'; // string | Alphanumeric string identifying the invoice.

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

### Options

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

Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**invoice_id** | **string** | Alphanumeric string identifying the invoice. |

### Return type

[**\Fastly\Model\InvoiceResponse**](../Model/InvoiceResponse.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.
```

Returns the list of invoices, sorted by billing start date (newest to oldest).

### Example
```php
$options['billing_start_date'] = 2023-01-01T00:00:00Z; // string
$options['billing_end_date'] = 2023-01-31T00:00:00Z; // string
$options['limit'] = '100'; // string | Number of results per page. The maximum is 200.
$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->listInvoices($options);
} catch (Exception $e) {
echo 'Exception when calling BillingInvoicesApi->listInvoices: ', $e->getMessage(), PHP_EOL;
}
```

### Options

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

Name | Type | Description | Notes
------------- | ------------- | ------------- | -------------
**billing_start_date** | **string** | | [optional]
**billing_end_date** | **string** | | [optional]
**limit** | **string** | Number of results per page. The maximum is 200. | [optional] [defaults to '100']
**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\ListInvoicesResponse**](../Model/ListInvoicesResponse.md)

[[Back to top]](#) [[Back to API list]](../../README.md#endpoints)
[[Back to README]](../../README.md)
4 changes: 2 additions & 2 deletions docs/Api/DirectorApi.md
Original file line number Diff line number Diff line change
Expand Up @@ -38,7 +38,7 @@ $options['capacity'] = 56; // int | Unused.
$options['comment'] = 'comment_example'; // string | A freeform descriptive note.
$options['name'] = 'name_example'; // string | Name for the Director.
$options['quorum'] = 75; // int | The percentage of capacity that needs to be up for a director to be considered up. `0` to `100`.
$options['shield'] = 'null'; // string | Selected POP to serve as a shield for the backends. Defaults to `null` meaning no origin shielding if not set. Refer to the [POPs API endpoint](/reference/api/utils/pops/) to get a list of available POPs used for shielding.
$options['shield'] = 'null'; // string | Selected POP to serve as a shield for the backends. Defaults to `null` meaning no origin shielding if not set. Refer to the [POPs API endpoint](https://www.fastly.com/documentation/reference/api/utils/pops/) to get a list of available POPs used for shielding.
$options['type'] = 1; // int | What type of load balance group to use.
$options['retries'] = 5; // int | How many backends to search if it fails.

Expand All @@ -62,7 +62,7 @@ Name | Type | Description | Notes
**comment** | **string** | A freeform descriptive note. | [optional]
**name** | **string** | Name for the Director. | [optional]
**quorum** | **int** | The percentage of capacity that needs to be up for a director to be considered up. `0` to `100`. | [optional] [defaults to 75]
**shield** | **string** | Selected POP to serve as a shield for the backends. Defaults to `null` meaning no origin shielding if not set. Refer to the [POPs API endpoint](/reference/api/utils/pops/) to get a list of available POPs used for shielding. | [optional] [defaults to 'null']
**shield** | **string** | Selected POP to serve as a shield for the backends. Defaults to `null` meaning no origin shielding if not set. Refer to the [POPs API endpoint](https://www.fastly.com/documentation/reference/api/utils/pops/) to get a list of available POPs used for shielding. | [optional] [defaults to 'null']
**type** | **int** | What type of load balance group to use. | [optional] [one of: 1, 3, 4]
**retries** | **int** | How many backends to search if it fails. | [optional] [defaults to 5]

Expand Down
Loading

0 comments on commit 074173c

Please sign in to comment.