Fastly\Api\LoggingAzureblobApi

$apiInstance = new Fastly\Api\LoggingAzureblobApi(
    // 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
createLogAzure()	POST /service/{service_id}/version/{version_id}/logging/azureblob	Create an Azure Blob Storage log endpoint
deleteLogAzure()	DELETE /service/{service_id}/version/{version_id}/logging/azureblob/{logging_azureblob_name}	Delete the Azure Blob Storage log endpoint
getLogAzure()	GET /service/{service_id}/version/{version_id}/logging/azureblob/{logging_azureblob_name}	Get an Azure Blob Storage log endpoint
listLogAzure()	GET /service/{service_id}/version/{version_id}/logging/azureblob	List Azure Blob Storage log endpoints
updateLogAzure()	PUT /service/{service_id}/version/{version_id}/logging/azureblob/{logging_azureblob_name}	Update an Azure Blob Storage log endpoint

`createLogAzure()`

createLogAzure($options): \Fastly\Model\LoggingAzureblobResponse // Create an Azure Blob Storage log endpoint

Create an Azure Blob Storage logging endpoint for a particular service and version.

Example

    $options['service_id'] = 'service_id_example'; // string | Alphanumeric string identifying the service.
$options['version_id'] = 56; // int | Integer identifying a service version.
$options['name'] = 'name_example'; // string | The name for the real-time logging configuration.
$options['placement'] = 'placement_example'; // string | Where in the generated VCL the logging call should be placed. If not set, endpoints with `format_version` of 2 are placed in `vcl_log` and those with `format_version` of 1 are placed in `vcl_deliver`.
$options['response_condition'] = 'response_condition_example'; // string | The name of an existing condition in the configured endpoint, or leave blank to always execute.
$options['format'] = '%h %l %u %t \"%r\" %&gt;s %b'; // string | A Fastly [log format string](https://docs.fastly.com/en/guides/custom-log-formats).
$options['format_version'] = 2; // int | The version of the custom logging format used for the configured endpoint. The logging call gets placed by default in `vcl_log` if `format_version` is set to `2` and in `vcl_deliver` if `format_version` is set to `1`.
$options['message_type'] = 'classic'; // string | How the message should be formatted.
$options['timestamp_format'] = 'timestamp_format_example'; // string | A timestamp format
$options['compression_codec'] = 'compression_codec_example'; // string | The codec used for compressing your logs. Valid values are `zstd`, `snappy`, and `gzip`. Specifying both `compression_codec` and `gzip_level` in the same API request will result in an error.
$options['period'] = 3600; // int | How frequently log files are finalized so they can be available for reading (in seconds).
$options['gzip_level'] = 0; // int | The level of gzip encoding when sending logs (default `0`, no compression). Specifying both `compression_codec` and `gzip_level` in the same API request will result in an error.
$options['path'] = 'null'; // string | The path to upload logs to.
$options['account_name'] = 'account_name_example'; // string | The unique Azure Blob Storage namespace in which your data objects are stored. Required.
$options['container'] = 'container_example'; // string | The name of the Azure Blob Storage container in which to store logs. Required.
$options['sas_token'] = 'sas_token_example'; // string | The Azure shared access signature providing write access to the blob service objects. Be sure to update your token before it expires or the logging functionality will not work. Required.
$options['public_key'] = 'null'; // string | A PGP public key that Fastly will use to encrypt your log files before writing them to disk.
$options['file_max_bytes'] = 56; // int | The maximum number of bytes for each uploaded file. A value of 0 can be used to indicate there is no limit on the size of uploaded files, otherwise the minimum value is 1048576 bytes (1 MiB). Note that Microsoft Azure Storage has [block size limits](https://learn.microsoft.com/en-us/rest/api/storageservices/put-block?tabs=microsoft-entra-id#remarks).

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

Options

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

Name	Type	Description	Notes
service_id	string	Alphanumeric string identifying the service.
version_id	int	Integer identifying a service version.
name	string	The name for the real-time logging configuration.	[optional]
placement	string	Where in the generated VCL the logging call should be placed. If not set, endpoints with `format_version` of 2 are placed in `vcl_log` and those with `format_version` of 1 are placed in `vcl_deliver`.	[optional] [one of: 'none', 'waf_debug', 'null']
response_condition	string	The name of an existing condition in the configured endpoint, or leave blank to always execute.	[optional]
format	string	A Fastly log format string.	[optional] [defaults to '%h %l %u %t "%r" %>s %b']
format_version	int	The version of the custom logging format used for the configured endpoint. The logging call gets placed by default in `vcl_log` if `format_version` is set to `2` and in `vcl_deliver` if `format_version` is set to `1`.	[optional] [one of: 1, 2]
message_type	string	How the message should be formatted.	[optional] [one of: 'classic', 'loggly', 'logplex', 'blank'] [defaults to 'classic']
timestamp_format	string	A timestamp format	[optional]
compression_codec	string	The codec used for compressing your logs. Valid values are `zstd`, `snappy`, and `gzip`. Specifying both `compression_codec` and `gzip_level` in the same API request will result in an error.	[optional] [one of: 'zstd', 'snappy', 'gzip']
period	int	How frequently log files are finalized so they can be available for reading (in seconds).	[optional] [defaults to 3600]
gzip_level	int	The level of gzip encoding when sending logs (default `0`, no compression). Specifying both `compression_codec` and `gzip_level` in the same API request will result in an error.	[optional] [defaults to 0]
path	string	The path to upload logs to.	[optional] [defaults to 'null']
account_name	string	The unique Azure Blob Storage namespace in which your data objects are stored. Required.	[optional]
container	string	The name of the Azure Blob Storage container in which to store logs. Required.	[optional]
sas_token	string	The Azure shared access signature providing write access to the blob service objects. Be sure to update your token before it expires or the logging functionality will not work. Required.	[optional]
public_key	string	A PGP public key that Fastly will use to encrypt your log files before writing them to disk.	[optional] [defaults to 'null']
file_max_bytes	int	The maximum number of bytes for each uploaded file. A value of 0 can be used to indicate there is no limit on the size of uploaded files, otherwise the minimum value is 1048576 bytes (1 MiB). Note that Microsoft Azure Storage has block size limits.	[optional]

Return type

\Fastly\Model\LoggingAzureblobResponse

[Back to top] [Back to API list] [Back to README]

`deleteLogAzure()`

deleteLogAzure($options): \Fastly\Model\InlineResponse200 // Delete the Azure Blob Storage log endpoint

Delete the Azure Blob Storage logging endpoint for a particular service and version.

Example

    $options['service_id'] = 'service_id_example'; // string | Alphanumeric string identifying the service.
$options['version_id'] = 56; // int | Integer identifying a service version.
$options['logging_azureblob_name'] = 'logging_azureblob_name_example'; // string | The name for the real-time logging configuration.

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

Options

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

Name	Type	Description
service_id	string	Alphanumeric string identifying the service.
version_id	int	Integer identifying a service version.
logging_azureblob_name	string	The name for the real-time logging configuration.

Return type

\Fastly\Model\InlineResponse200

[Back to top] [Back to API list] [Back to README]

`getLogAzure()`

getLogAzure($options): \Fastly\Model\LoggingAzureblobResponse // Get an Azure Blob Storage log endpoint

Get the Azure Blob Storage logging endpoint for a particular service and version.

Example

    $options['service_id'] = 'service_id_example'; // string | Alphanumeric string identifying the service.
$options['version_id'] = 56; // int | Integer identifying a service version.
$options['logging_azureblob_name'] = 'logging_azureblob_name_example'; // string | The name for the real-time logging configuration.

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

Options

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

Name	Type	Description
service_id	string	Alphanumeric string identifying the service.
version_id	int	Integer identifying a service version.
logging_azureblob_name	string	The name for the real-time logging configuration.

Return type

\Fastly\Model\LoggingAzureblobResponse

[Back to top] [Back to API list] [Back to README]

`listLogAzure()`

listLogAzure($options): \Fastly\Model\LoggingAzureblobResponse[] // List Azure Blob Storage log endpoints

List all of the Azure Blob Storage logging endpoints for a particular service and version.

Example

    $options['service_id'] = 'service_id_example'; // string | Alphanumeric string identifying the service.
$options['version_id'] = 56; // int | Integer identifying a service version.

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

Options

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

Name	Type	Description	Notes
service_id	string	Alphanumeric string identifying the service.
version_id	int	Integer identifying a service version.

Return type

\Fastly\Model\LoggingAzureblobResponse[]

[Back to top] [Back to API list] [Back to README]

`updateLogAzure()`

updateLogAzure($options): \Fastly\Model\LoggingAzureblobResponse // Update an Azure Blob Storage log endpoint

Update the Azure Blob Storage logging endpoint for a particular service and version.

Example

    $options['service_id'] = 'service_id_example'; // string | Alphanumeric string identifying the service.
$options['version_id'] = 56; // int | Integer identifying a service version.
$options['logging_azureblob_name'] = 'logging_azureblob_name_example'; // string | The name for the real-time logging configuration.
$options['name'] = 'name_example'; // string | The name for the real-time logging configuration.
$options['placement'] = 'placement_example'; // string | Where in the generated VCL the logging call should be placed. If not set, endpoints with `format_version` of 2 are placed in `vcl_log` and those with `format_version` of 1 are placed in `vcl_deliver`.
$options['response_condition'] = 'response_condition_example'; // string | The name of an existing condition in the configured endpoint, or leave blank to always execute.
$options['format'] = '%h %l %u %t \"%r\" %&gt;s %b'; // string | A Fastly [log format string](https://docs.fastly.com/en/guides/custom-log-formats).
$options['format_version'] = self::FORMAT_VERSION_v2; // int | The version of the custom logging format used for the configured endpoint. The logging call gets placed by default in `vcl_log` if `format_version` is set to `2` and in `vcl_deliver` if `format_version` is set to `1`.
$options['message_type'] = 'classic'; // string | How the message should be formatted.
$options['timestamp_format'] = 'timestamp_format_example'; // string | A timestamp format
$options['compression_codec'] = 'compression_codec_example'; // string | The codec used for compressing your logs. Valid values are `zstd`, `snappy`, and `gzip`. Specifying both `compression_codec` and `gzip_level` in the same API request will result in an error.
$options['period'] = 3600; // int | How frequently log files are finalized so they can be available for reading (in seconds).
$options['gzip_level'] = 0; // int | The level of gzip encoding when sending logs (default `0`, no compression). Specifying both `compression_codec` and `gzip_level` in the same API request will result in an error.
$options['path'] = 'null'; // string | The path to upload logs to.
$options['account_name'] = 'account_name_example'; // string | The unique Azure Blob Storage namespace in which your data objects are stored. Required.
$options['container'] = 'container_example'; // string | The name of the Azure Blob Storage container in which to store logs. Required.
$options['sas_token'] = 'sas_token_example'; // string | The Azure shared access signature providing write access to the blob service objects. Be sure to update your token before it expires or the logging functionality will not work. Required.
$options['public_key'] = 'null'; // string | A PGP public key that Fastly will use to encrypt your log files before writing them to disk.
$options['file_max_bytes'] = 56; // int | The maximum number of bytes for each uploaded file. A value of 0 can be used to indicate there is no limit on the size of uploaded files, otherwise the minimum value is 1048576 bytes (1 MiB). Note that Microsoft Azure Storage has [block size limits](https://learn.microsoft.com/en-us/rest/api/storageservices/put-block?tabs=microsoft-entra-id#remarks).

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

Options

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

Name	Type	Description	Notes
service_id	string	Alphanumeric string identifying the service.
version_id	int	Integer identifying a service version.
logging_azureblob_name	string	The name for the real-time logging configuration.
name	string	The name for the real-time logging configuration.	[optional]
placement	string	Where in the generated VCL the logging call should be placed. If not set, endpoints with `format_version` of 2 are placed in `vcl_log` and those with `format_version` of 1 are placed in `vcl_deliver`.	[optional] [one of: 'none', 'waf_debug', 'null']
response_condition	string	The name of an existing condition in the configured endpoint, or leave blank to always execute.	[optional]
format	string	A Fastly log format string.	[optional] [defaults to '%h %l %u %t "%r" %>s %b']
format_version	int	The version of the custom logging format used for the configured endpoint. The logging call gets placed by default in `vcl_log` if `format_version` is set to `2` and in `vcl_deliver` if `format_version` is set to `1`.	[optional] [one of: 1, 2]
message_type	string	How the message should be formatted.	[optional] [one of: 'classic', 'loggly', 'logplex', 'blank'] [defaults to 'classic']
timestamp_format	string	A timestamp format	[optional]
compression_codec	string	The codec used for compressing your logs. Valid values are `zstd`, `snappy`, and `gzip`. Specifying both `compression_codec` and `gzip_level` in the same API request will result in an error.	[optional] [one of: 'zstd', 'snappy', 'gzip']
period	int	How frequently log files are finalized so they can be available for reading (in seconds).	[optional] [defaults to 3600]
gzip_level	int	The level of gzip encoding when sending logs (default `0`, no compression). Specifying both `compression_codec` and `gzip_level` in the same API request will result in an error.	[optional] [defaults to 0]
path	string	The path to upload logs to.	[optional] [defaults to 'null']
account_name	string	The unique Azure Blob Storage namespace in which your data objects are stored. Required.	[optional]
container	string	The name of the Azure Blob Storage container in which to store logs. Required.	[optional]
sas_token	string	The Azure shared access signature providing write access to the blob service objects. Be sure to update your token before it expires or the logging functionality will not work. Required.	[optional]
public_key	string	A PGP public key that Fastly will use to encrypt your log files before writing them to disk.	[optional] [defaults to 'null']
file_max_bytes	int	The maximum number of bytes for each uploaded file. A value of 0 can be used to indicate there is no limit on the size of uploaded files, otherwise the minimum value is 1048576 bytes (1 MiB). Note that Microsoft Azure Storage has block size limits.	[optional]

Return type

\Fastly\Model\LoggingAzureblobResponse

[Back to top] [Back to API list] [Back to README]

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

LoggingAzureblobApi.md

LoggingAzureblobApi.md

Fastly\Api\LoggingAzureblobApi

Methods

`createLogAzure()`

Example

Options

Return type

`deleteLogAzure()`

Example

Options

Return type

`getLogAzure()`

Example

Options

Return type

`listLogAzure()`

Example

Options

Return type

`updateLogAzure()`

Example

Options

Return type

Files

LoggingAzureblobApi.md

Latest commit

History

LoggingAzureblobApi.md

File metadata and controls

Fastly\Api\LoggingAzureblobApi

Methods

createLogAzure()

Example

Options

Return type

deleteLogAzure()

Example

Options

Return type

getLogAzure()

Example

Options

Return type

listLogAzure()

Example

Options

Return type

updateLogAzure()

Example

Options

Return type

`createLogAzure()`

`deleteLogAzure()`

`getLogAzure()`

`listLogAzure()`

`updateLogAzure()`