Cluster Settings REST API (2.2)

The storage scheme (provider) to use. Supported values:

• s3 — AWS S3 or an S3-compatible storage service.
• azblob — Azure Blob Storage.
• gs — Google Cloud Storage.

The name of the blob storage bucket (S3) or container (Azure Blob Storage) where Enterprise Analytics will store its data.

The region of the blob storage bucket. Applies only when blobStorageScheme is s3.

Optional. The path prefix within the bucket (S3) or container (Azure Blob Storage) where Enterprise Analytics will store its data. If not specified, the data is stored in the root of the bucket /

Applies when blobStorageScheme is s3 or gs. Not supported when blobStorageScheme is azblob. If true, the storage bucket will be accessed without any credentials (anonymous access). See also blobStorageAccessKeyId and blobStorageSecretAccessKey for static credentials, or omit all credential fields to use the Standard Credential Chain.

(Deprecated) Use blobStoragePathStyleAddressing instead.

Applies only when blobStorageScheme is s3 and a custom blobStorageEndpoint is configured (S3-compatible storage). If true, path-style URLs are used (e.g., https://s3.example.com/bucket-name/key). If false, virtual-hosted-style URLs are used (e.g., https://bucket-name.s3.example.com/key). Some S3-compatible storage services require path-style addressing. Replaces the deprecated blobStorageForcePathStyle.

The endpoint URL for the blob storage service. Required when using S3-compatible storage or Azure Blob Storage.

• For s3 (S3-compatible): the URL of your S3-compatible storage service (e.g., https://my-object-storage:18082).
• For azblob: the Blob service endpoint for your Azure storage account (e.g., https://mycompany.blob.core.windows.net/).

If true, disables certificate verification for SSL/TLS connections to the blob storage endpoint. Useful for testing or when using self-signed certificates, but not recommended for production. Warning: Disabling SSL verification in a production environment is highly insecure and exposes the system to serious risks, including Man-in-the-Middle (MITM) attacks.

Applies only when blobStorageScheme is s3. One or more PEM-encoded certificates to trust when connecting to the blob storage endpoint. Only required if the endpoint is signed by a certificate authority (CA) other than a well-known public CA (e.g., for self-signed or private/internal CA certificates). Multiple certificates can be provided to support certificate rotation.

Available from Enterprise Analytics 2.1.1.

Optional. Applies only when blobStorageScheme is s3. The Access Key ID for static credential authentication. If provided, must be supplied together with blobStorageSecretAccessKey. If omitted, the Standard Credential Chain is used (instance profile, environment variables, etc.) to obtain credentials automatically. See also blobStorageAnonymousAuth for anonymous access.

Available from Enterprise Analytics 2.1.1.

Optional. Applies only when blobStorageScheme is s3. The Secret Access Key for static credential authentication. If provided, must be supplied together with blobStorageAccessKeyId. If omitted, the Standard Credential Chain is used (instance profile, environment variables, etc.) to obtain credentials automatically. On input, supply the actual secret value. In logs and in responses from the API this value is masked as *** for security reasons.

Available from Enterprise Analytics 2.1.1.

Applies only when blobStorageScheme is s3. Controls when the client sends additional integrity checksums on object uploads. Supported values:

• when_required — only send a checksum when the storage service requires one.
• when_supported — send a checksum whenever the storage service supports it.

Useful for S3-compatible storage services that do not fully support the default checksum behavior.

Applies only when blobStorageScheme is azblob. The client ID of the user-assigned managed identity to use when authenticating to Azure Blob Storage. If omitted, the default Azure credential chain is used.

Specifies the number of partitions that will be used when storing the data in the blob storage bucket.