diff --git a/apps/docs/src/content/docs/en/pages/devtools/azion-edge-runtime/api-reference/ai/ai.mdx b/apps/docs/src/content/docs/en/pages/devtools/azion-edge-runtime/api-reference/ai/ai.mdx
index 6fb2a2eee6..be50e9292d 100644
--- a/apps/docs/src/content/docs/en/pages/devtools/azion-edge-runtime/api-reference/ai/ai.mdx
+++ b/apps/docs/src/content/docs/en/pages/devtools/azion-edge-runtime/api-reference/ai/ai.mdx
@@ -52,7 +52,7 @@ return modelResponse
## Return value
-The resolved value is the object the model returns: a `chat.completion` object from a chat model, a `list` of embeddings from an embedding model, and the ranked results from a reranking model. The generated text of a chat model sits at `modelResponse?.choices?.[0]?.message?.content`, which is the content of the first entry in `choices`. Every field of the three shapes is listed in [Model invocation](/en/documentation/platform/ai-inference/model-invocation/#response-fields).
+The resolved value is the object the model returns. A chat model returns a `chat.completion` object, an embedding model returns a `list` of embeddings, and a reranking model returns the ranked results. The generated text of a chat model sits at `modelResponse?.choices?.[0]?.message?.content`, which is the content of the first entry in `choices`. Every field of the three shapes is listed in [Model invocation](/en/documentation/platform/ai-inference/model-invocation/#response-fields).
---
diff --git a/apps/docs/src/content/docs/en/pages/devtools/azion-edge-runtime/api-reference/kv-store/kv-store.mdx b/apps/docs/src/content/docs/en/pages/devtools/azion-edge-runtime/api-reference/kv-store/kv-store.mdx
index d64776604a..61589de6be 100644
--- a/apps/docs/src/content/docs/en/pages/devtools/azion-edge-runtime/api-reference/kv-store/kv-store.mdx
+++ b/apps/docs/src/content/docs/en/pages/devtools/azion-edge-runtime/api-reference/kv-store/kv-store.mdx
@@ -271,7 +271,7 @@ The third argument of `get` and `getWithMetadata` is an object, and it carries o
| --- | --- | --- |
| `cacheTtl` | number | Caches the result of the read for that many seconds, so a later read of the same key is served from the cache |
-For example, a configuration object that every request reads and a deploy rewrites once a day is read with `cacheTtl` set to 300, so repeated reads within five minutes come from the cache instead of the store.
+For example, every request reads a configuration object, and a deploy rewrites it once a day. When the function reads that object with `cacheTtl` set to 300, repeated reads within five minutes come from the cache instead of the store.
This handler reads a configuration key with a cached result:
diff --git a/apps/docs/src/content/docs/en/pages/devtools/azion-edge-runtime/api-reference/metadata/metadata.mdx b/apps/docs/src/content/docs/en/pages/devtools/azion-edge-runtime/api-reference/metadata/metadata.mdx
index 4e89c8e2d9..349d7fa3ce 100644
--- a/apps/docs/src/content/docs/en/pages/devtools/azion-edge-runtime/api-reference/metadata/metadata.mdx
+++ b/apps/docs/src/content/docs/en/pages/devtools/azion-edge-runtime/api-reference/metadata/metadata.mdx
@@ -14,7 +14,7 @@ import FrameBox from '@aziontech/webkit/frame-box'
import ItemList from '@aziontech/webkit/item-list'
import DocItem from '@aziontech/webkit/doc-item'
-The Azion Runtime Metadata API gives a function a set of values about each request: the GeoIP location of the client, its address and port, the protocol, the TLS session, fingerprints, and identifiers. Functions that run on an Application or on a Firewall can read it. Use it to filter and manage access to your application, or to apply different logic for each scenario.
+The Azion Runtime Metadata API gives a function a set of values about each request. These values cover the GeoIP location of the client, its address and port, the protocol, the TLS session, fingerprints, and identifiers. Functions that run on an Application or on a Firewall can read it. Use it to filter and manage access to your application, or to apply different logic for each scenario.
:::note
Under `azion dev`, the metadata object is `undefined`. Test metadata reads on a deployed function.
diff --git a/apps/docs/src/content/docs/en/pages/devtools/azion-edge-runtime/api-reference/object-storage/object-storage.mdx b/apps/docs/src/content/docs/en/pages/devtools/azion-edge-runtime/api-reference/object-storage/object-storage.mdx
index 493a201f1b..375917353f 100644
--- a/apps/docs/src/content/docs/en/pages/devtools/azion-edge-runtime/api-reference/object-storage/object-storage.mdx
+++ b/apps/docs/src/content/docs/en/pages/devtools/azion-edge-runtime/api-reference/object-storage/object-storage.mdx
@@ -15,7 +15,7 @@ import DocItem from '@aziontech/webkit/doc-item'
The Azion Runtime Object Storage API gives a function from [Functions](/en/documentation/platform/functions/) read and write access to the objects of an [Object Storage](/en/documentation/platform/object-storage/) bucket. The function imports the `Storage` class from the `azion:storage` module, names a bucket, and calls `put`, `get`, `delete`, and `list` on it. No token is involved: the constructor takes the bucket name and nothing else.
:::note
-Under `azion dev`, the module stores objects on the local disk and behaves differently: `put` without an `options` object fails with `TypeError: Cannot read properties of undefined (reading 'content-length')`, a number in `metadata` is accepted, a missing key throws `ENOENT` instead of `StorageError: Object not found`, and `list` returns keys without the leading slash and without `content_length`. Test storage calls on a deployed function.
+Under `azion dev`, the module stores objects on the local disk and behaves differently. Without an `options` object, `put` fails with `TypeError: Cannot read properties of undefined (reading 'content-length')`. The module accepts a number in `metadata`. A missing key throws `ENOENT` instead of `StorageError: Object not found`. The `list` method returns keys without the leading slash and without `content_length`. Test storage calls on a deployed function.
:::
---
diff --git a/apps/docs/src/content/docs/en/pages/devtools/azion-edge-runtime/how-it-works.mdx b/apps/docs/src/content/docs/en/pages/devtools/azion-edge-runtime/how-it-works.mdx
index 9d0c43c46a..12178b05aa 100644
--- a/apps/docs/src/content/docs/en/pages/devtools/azion-edge-runtime/how-it-works.mdx
+++ b/apps/docs/src/content/docs/en/pages/devtools/azion-edge-runtime/how-it-works.mdx
@@ -13,7 +13,7 @@ A serverless JavaScript runtime runs your code once per request, inside a sandbo
Azion Runtime is that environment for [Functions](/en/documentation/platform/functions/). It runs JavaScript built on Web standards, calls the handler your function exports, and gives the handler the APIs of the platform. Your project reaches it through Azion Bundler, which builds the code and resolves Node.js APIs with polyfills at build time.
-The sections cover the execution model, the request lifecycle, handler shapes, the bundler and polyfills, strict mode, time inside a request, environment variables and secrets, and how `azion dev` differs from a deployed function. What decides when a function runs, the rule and the function instance, is on [How Functions works](/en/documentation/platform/functions/how-it-works/).
+The sections cover the execution model, the request lifecycle, handler shapes, the bundler and polyfills, and strict mode. They then cover time inside a request, environment variables and secrets, and how `azion dev` differs from a deployed function. What decides when a function runs, the rule and the function instance, is on [How Functions works](/en/documentation/platform/functions/how-it-works/).
---
@@ -123,7 +123,7 @@ Strict mode changes the normal semantics of JavaScript in three ways:
- It removes mistakes that keep JavaScript engines from optimizing code, so strict-mode code can sometimes run faster than the same code outside strict mode.
- It prohibits some syntax that later versions of ECMAScript are likely to define.
-The first change has a cost for code written without strict mode. A mistake that JavaScript outside strict mode ignores throws in a function, and the error surfaces on the request, so an older library that relies on silent failures needs a test before you deploy it.
+The first change has a cost for code written without strict mode. A mistake that JavaScript outside strict mode ignores throws in a function, and the error surfaces on the request. As a result, an older library that relies on silent failures needs a test before you deploy it.
---
diff --git a/apps/docs/src/content/docs/en/pages/devtools/azion-edge-runtime/javascript-examples/hello-world/hello-world.mdx b/apps/docs/src/content/docs/en/pages/devtools/azion-edge-runtime/javascript-examples/hello-world/hello-world.mdx
index 961f34e711..15b76abe16 100644
--- a/apps/docs/src/content/docs/en/pages/devtools/azion-edge-runtime/javascript-examples/hello-world/hello-world.mdx
+++ b/apps/docs/src/content/docs/en/pages/devtools/azion-edge-runtime/javascript-examples/hello-world/hello-world.mdx
@@ -12,7 +12,7 @@ import FrameBox from '@aziontech/webkit/frame-box'
import ItemList from '@aziontech/webkit/item-list'
import DocItem from '@aziontech/webkit/doc-item'
-Return a fixed string directly from a function, without contacting an origin server. This is the smallest form of the pattern every function follows, which makes it a useful check that a function is deployed and serving traffic before you add logic to it.
+Return a fixed string directly from a function, without contacting an origin server. This is the smallest form of the pattern every function follows. That makes it a useful check that a function is deployed and serving traffic before you add logic to it.
```js
async function handleRequest(request) {
diff --git a/apps/docs/src/content/docs/en/pages/devtools/azion-edge-runtime/javascript-examples/index.mdx b/apps/docs/src/content/docs/en/pages/devtools/azion-edge-runtime/javascript-examples/index.mdx
index dcb1e664d6..3bcb520823 100644
--- a/apps/docs/src/content/docs/en/pages/devtools/azion-edge-runtime/javascript-examples/index.mdx
+++ b/apps/docs/src/content/docs/en/pages/devtools/azion-edge-runtime/javascript-examples/index.mdx
@@ -14,7 +14,7 @@ import DocItem from '@aziontech/webkit/doc-item'
Copy any of these JavaScript snippets into a function as a starting point for your own code. The examples cover the patterns functions are most often used for: returning a response or a JSON payload, redirecting traffic, reading cookies, running an A/B test, and denying a request by country. They are grouped by where the function runs: Applications, for functions that handle the `fetch` event on an application, and Firewall, for functions that handle the `firewall` event on a firewall.
-Most handlers in this collection are written in the Service Worker pattern, which registers the handler with `addEventListener`. New code uses ES Modules, and [Process a request body](/en/documentation/platform/functions/process-request-body/) is written that way: refer to [Best practices](/en/documentation/platform/functions/best-practices/) for the current pattern, and to [Migrate handler patterns in Functions](/en/documentation/guides/application-development/functions-and-runtime/migrate-handler-patterns/) for the before-and-after of each handler.
+Most handlers in this collection are written in the Service Worker pattern, which registers the handler with `addEventListener`. New code uses ES Modules, and [Process a request body](/en/documentation/platform/functions/process-request-body/) is written that way. Refer to [Best practices](/en/documentation/platform/functions/best-practices/) for the current pattern, and to [Migrate handler patterns in Functions](/en/documentation/guides/application-development/functions-and-runtime/migrate-handler-patterns/) for the before-and-after of each handler.
---
diff --git a/apps/docs/src/content/docs/en/pages/devtools/azion-edge-runtime/javascript-examples/process-request-body/process-request-body.mdx b/apps/docs/src/content/docs/en/pages/devtools/azion-edge-runtime/javascript-examples/process-request-body/process-request-body.mdx
index 353c44c7a0..9855dd4ad0 100644
--- a/apps/docs/src/content/docs/en/pages/devtools/azion-edge-runtime/javascript-examples/process-request-body/process-request-body.mdx
+++ b/apps/docs/src/content/docs/en/pages/devtools/azion-edge-runtime/javascript-examples/process-request-body/process-request-body.mdx
@@ -105,7 +105,7 @@ When there is a body, the handler reads the `Content-Type` header and routes to
| `application/octet-stream` | `request.blob()` | Reads the body as binary and returns its text |
| Anything else | `request.body.getReader()` | Reads the stream chunk by chunk, decoding each chunk as UTF-8 |
-The stream branch is the fallback, so an unrecognized content type is still read rather than dropped. It is also the branch to use when the body is large enough that holding the whole payload in memory matters: the reader hands over one chunk at a time, and the loop ends when `done` is true.
+The stream branch is the fallback, so an unrecognized content type is still read rather than dropped. It is also the branch to use when the body is large enough that holding the whole payload in memory matters. The reader hands over one chunk at a time, and the loop ends when `done` is true.
A body can be read only once. Calling two parsing methods on the same request throws, which is why the handler picks exactly one branch and returns it.
diff --git a/apps/docs/src/content/docs/en/pages/devtools/azion-edge-runtime/javascript-examples/rest-apis/rest-apis.mdx b/apps/docs/src/content/docs/en/pages/devtools/azion-edge-runtime/javascript-examples/rest-apis/rest-apis.mdx
index 7be4283fae..decafecf4f 100644
--- a/apps/docs/src/content/docs/en/pages/devtools/azion-edge-runtime/javascript-examples/rest-apis/rest-apis.mdx
+++ b/apps/docs/src/content/docs/en/pages/devtools/azion-edge-runtime/javascript-examples/rest-apis/rest-apis.mdx
@@ -150,7 +150,9 @@ export default {
## How it works
-Each example is a complete function in the ES Modules pattern. The `fetch` handler calls `fetch()` with the URL of the API and an options object: `method` selects the HTTP verb, `headers` carries the `Content-Type` and the authorization token, and `body` carries the JSON string that `JSON.stringify()` produces. The token comes from the `API_TOKEN` [environment variable](/en/documentation/devtools/runtime/api-reference/environment-variables/) through `Azion.env.get()`, so it stays out of the code. `await fetch()` resolves to a `Response`. The GET example reads it with `response.json()`, and the other examples return the status and body of the API to the client. Replace `https://api.example.com/items` and the sample values with the ones of your API.
+Each example is a complete function in the ES Modules pattern. The `fetch` handler calls `fetch()` with the URL of the API and an options object. In that object, `method` selects the HTTP verb, and `headers` carries the `Content-Type` and the authorization token. The `body` field carries the JSON string that `JSON.stringify()` produces.
+
+The token comes from the `API_TOKEN` [environment variable](/en/documentation/devtools/runtime/api-reference/environment-variables/) through `Azion.env.get()`, so it stays out of the code. `await fetch()` resolves to a `Response`. The GET example reads it with `response.json()`, and the other examples return the status and body of the API to the client. Replace `https://api.example.com/items` and the sample values with the ones of your API.
## Related resources
diff --git a/apps/docs/src/content/docs/en/pages/devtools/azion-edge-runtime/javascript-examples/return-html/return-html.mdx b/apps/docs/src/content/docs/en/pages/devtools/azion-edge-runtime/javascript-examples/return-html/return-html.mdx
index 65e0472c1c..1e8fcf1ee5 100644
--- a/apps/docs/src/content/docs/en/pages/devtools/azion-edge-runtime/javascript-examples/return-html/return-html.mdx
+++ b/apps/docs/src/content/docs/en/pages/devtools/azion-edge-runtime/javascript-examples/return-html/return-html.mdx
@@ -36,7 +36,7 @@ Generate a complete HTML page from a string and return it directly from a functi
## How it works
-The markup is stored in a template literal assigned to the `html` constant, so the whole page lives inside the function. When the `fetch` event fires, `handleRequest` builds a new `Response` with that string as the body and sets the `content-type` header to `text/html;charset=UTF-8`, which tells the browser to render the payload as a web page instead of plain text. `event.respondWith()` then returns the page to the client, with no request to an origin.
+The markup is stored in a template literal assigned to the `html` constant, so the whole page lives inside the function. When the `fetch` event fires, `handleRequest` builds a new `Response` with that string as the body. It also sets the `content-type` header to `text/html;charset=UTF-8`. That header tells the browser to render the payload as a web page instead of plain text. `event.respondWith()` then returns the page to the client, with no request to an origin.
The `content-type` header is the part that matters most here. Without it, the browser has no instruction to render the body as a page, so keep it set whenever a function returns HTML.
diff --git a/apps/docs/src/content/docs/en/pages/devtools/azion-edge-runtime/javascript-examples/return-json/return-json.mdx b/apps/docs/src/content/docs/en/pages/devtools/azion-edge-runtime/javascript-examples/return-json/return-json.mdx
index 23f25c26a5..7abd1e5b80 100644
--- a/apps/docs/src/content/docs/en/pages/devtools/azion-edge-runtime/javascript-examples/return-json/return-json.mdx
+++ b/apps/docs/src/content/docs/en/pages/devtools/azion-edge-runtime/javascript-examples/return-json/return-json.mdx
@@ -12,7 +12,7 @@ import FrameBox from '@aziontech/webkit/frame-box'
import ItemList from '@aziontech/webkit/item-list'
import DocItem from '@aziontech/webkit/doc-item'
-Return a JSON payload directly from a function, without forwarding the request to an origin. Use this pattern for lightweight APIs and middleware, such as API mocks, feature flags, configuration endpoints, and health checks, where the response is structured data and no backend service has to be involved.
+Return a JSON payload directly from a function, without forwarding the request to an origin. Use this pattern for lightweight APIs and middleware, such as API mocks, feature flags, configuration endpoints, and health checks. In these cases, the response is structured data and no backend service has to be involved.
```js
addEventListener("fetch", event => {
@@ -36,9 +36,9 @@ Return a JSON payload directly from a function, without forwarding the request t
When the `fetch` event fires, the handler defines a plain JavaScript object and serializes it with `JSON.stringify(data, null, 2)`, where the `2` adds indentation so the output is easy to read. It then creates a new `Response` with that string as the body and sets the `content-type` header to `application/json;charset=UTF-8`, which tells the client the payload is JSON. `event.respondWith()` returns the response, with no request to an origin.
-The same shape covers richer responses. Set a status code or add CORS and cache-control headers in the second argument to `Response`, and build the object from request data, such as query string parameters, cookies, or headers, instead of hardcoding it.
+The same shape covers richer responses. Set a status code or add CORS and cache-control headers in the second argument to `Response`. Build the object from request data, such as query string parameters, cookies, or headers, instead of hardcoding it.
-The object can also be assembled from data the function fetches. A handler that calls `fetch()` for each of several URLs, parses each response with `response.json()`, and awaits them together with `Promise.all()` returns one JSON body built from all of them. For a worked example, refer to [Example: Async event handlers](/en/documentation/devtools/runtime/node/events/#async-event-handlers).
+The object can also be assembled from data the function fetches. In that case, the handler calls `fetch()` for each of several URLs and parses each response with `response.json()`. It awaits them together with `Promise.all()` and returns one JSON body built from all of them. For a worked example, refer to [Example: Async event handlers](/en/documentation/devtools/runtime/node/events/#async-event-handlers).
## Related resources
diff --git a/apps/docs/src/content/docs/en/pages/devtools/azion-edge-runtime/javascript-examples/using-args/using-args.mdx b/apps/docs/src/content/docs/en/pages/devtools/azion-edge-runtime/javascript-examples/using-args/using-args.mdx
index c622d3e8a5..a462e9fbbc 100644
--- a/apps/docs/src/content/docs/en/pages/devtools/azion-edge-runtime/javascript-examples/using-args/using-args.mdx
+++ b/apps/docs/src/content/docs/en/pages/devtools/azion-edge-runtime/javascript-examples/using-args/using-args.mdx
@@ -42,7 +42,7 @@ The Args set on the function instance that runs this code:
The `fetch` handler reads `event.args.value` and passes it to `handleRequest`, which returns that value in the body of a new `Response`, along with a custom header set through `new Headers([...])` and an explicit `status: 200`. The `value` key comes from the JSON object above, so changing that object changes what the function returns.
-Args are not part of the code. You set them on the [function instance](/en/documentation/platform/applications/functions-instances/) that binds the function to an application or a firewall, which is why the same function can behave differently on each instance without being edited or redeployed. [How it works](/en/documentation/platform/functions/how-it-works/) covers the rest of the chain, from the function to the instance to the Rules Engine rule that runs it.
+Args are not part of the code. You set them on the [function instance](/en/documentation/platform/applications/functions-instances/) that binds the function to an application or a firewall. That is why the same function can behave differently on each instance without being edited or redeployed. [How it works](/en/documentation/platform/functions/how-it-works/) covers the rest of the chain, from the function to the instance to the Rules Engine rule that runs it.
## Related resources
diff --git a/apps/docs/src/content/docs/en/pages/devtools/cli/azion-cli/commands/config/config.mdx b/apps/docs/src/content/docs/en/pages/devtools/cli/azion-cli/commands/config/config.mdx
index 9b1166a0e5..02cd545848 100644
--- a/apps/docs/src/content/docs/en/pages/devtools/cli/azion-cli/commands/config/config.mdx
+++ b/apps/docs/src/content/docs/en/pages/devtools/cli/azion-cli/commands/config/config.mdx
@@ -10,7 +10,7 @@ import FrameBox from '@aziontech/webkit/frame-box'
import ItemList from '@aziontech/webkit/item-list'
import DocItem from '@aziontech/webkit/doc-item'
-The Azion CLI `config` commands manage Azion resources from manifest files: `init` creates an empty `azion.json` file, `apply` creates or updates the resources that an [azion.config](/en/documentation/devtools/cli/azion-config-js/) file declares, and `delete` deletes the resources that `azion.json` lists. The options every command accepts, such as `--format`, `--out`, and `-y`, are on [Global options](/en/documentation/devtools/cli/globals/).
+The Azion CLI `config` commands manage Azion resources from manifest files. The `init` command creates an empty `azion.json` file. The `apply` command creates or updates the resources that an [azion.config](/en/documentation/devtools/cli/azion-config-js/) file declares. The `delete` command deletes the resources that `azion.json` lists. The options every command accepts, such as `--format`, `--out`, and `-y`, are on [Global options](/en/documentation/devtools/cli/globals/).
---
diff --git a/apps/docs/src/content/docs/en/pages/devtools/cli/azion-cli/commands/dev-command/dev.mdx b/apps/docs/src/content/docs/en/pages/devtools/cli/azion-cli/commands/dev-command/dev.mdx
index a72ca765eb..0cf14267e5 100644
--- a/apps/docs/src/content/docs/en/pages/devtools/cli/azion-cli/commands/dev-command/dev.mdx
+++ b/apps/docs/src/content/docs/en/pages/devtools/cli/azion-cli/commands/dev-command/dev.mdx
@@ -10,7 +10,7 @@ import FrameBox from '@aziontech/webkit/frame-box'
import ItemList from '@aziontech/webkit/item-list'
import DocItem from '@aziontech/webkit/doc-item'
-The Azion CLI `dev` command builds the project in the current directory and starts a local development server, so you can test an application or a function on your machine before you deploy it. Run it from the root folder of a project that [Azion CLI init](/en/documentation/devtools/cli/init/) created or that [Azion CLI link](/en/documentation/devtools/cli/link-command/) set up. For an existing project that is not set up for Azion, run `azion link` first. The options every command accepts, such as `--debug`, `--format`, and `-y`, are on [Global options](/en/documentation/devtools/cli/globals/).
+The Azion CLI `dev` command builds the project in the current directory and starts a local development server. With that server, you can test an application or a function on your machine before you deploy it. Run it from the root folder of a project that [Azion CLI init](/en/documentation/devtools/cli/init/) created or that [Azion CLI link](/en/documentation/devtools/cli/link-command/) set up. For an existing project that is not set up for Azion, run `azion link` first. The options every command accepts, such as `--debug`, `--format`, and `-y`, are on [Global options](/en/documentation/devtools/cli/globals/).
---
diff --git a/apps/docs/src/content/docs/en/pages/devtools/cli/azion-cli/commands/globals/globals.mdx b/apps/docs/src/content/docs/en/pages/devtools/cli/azion-cli/commands/globals/globals.mdx
index 3cb4a72e5e..49ae3c863a 100644
--- a/apps/docs/src/content/docs/en/pages/devtools/cli/azion-cli/commands/globals/globals.mdx
+++ b/apps/docs/src/content/docs/en/pages/devtools/cli/azion-cli/commands/globals/globals.mdx
@@ -10,7 +10,7 @@ import FrameBox from '@aziontech/webkit/frame-box'
import ItemList from '@aziontech/webkit/item-list'
import DocItem from '@aziontech/webkit/doc-item'
-Global options are the flags that the [Azion CLI](/en/documentation/devtools/cli/) commands share. They go after the command and its subcommand, as in `azion list application --debug`, and set the configuration folder, the token, the log level, the request timeout, the output format, and the answers to yes/no questions.
+Global options are the flags that the [Azion CLI](/en/documentation/devtools/cli/) commands share. They go after the command and its subcommand, as in `azion list application --debug`. They set the configuration folder, the token, the log level, the request timeout, the output format, and the answers to yes/no questions.
---
diff --git a/apps/docs/src/content/docs/en/pages/devtools/cli/resources/csr.mdx b/apps/docs/src/content/docs/en/pages/devtools/cli/resources/csr.mdx
index e5d30121d4..c63d276093 100644
--- a/apps/docs/src/content/docs/en/pages/devtools/cli/resources/csr.mdx
+++ b/apps/docs/src/content/docs/en/pages/devtools/cli/resources/csr.mdx
@@ -37,7 +37,7 @@ azion create csr [flags]
| `--organization-unity` | — | string | — | Organizational unit of the certificate subject. |
| `--state` | — | string | — | State or province of the certificate subject. |
-A `--key-algorithm` value outside the three listed is refused with `"rsa_1024" is not a valid choice.`, and a `--name` that a certificate of your account already uses is refused with `This field must be unique.` Every name in `--common-name` and `--alternative-names` must belong to a domain your account has permission for. The bounds of each field are in [Certificates](/en/documentation/platform/workloads/certificate-manager/certificates/).
+A `--key-algorithm` value outside the three listed is refused with `"rsa_1024" is not a valid choice.` A `--name` that a certificate of your account already uses is refused with `This field must be unique.` Every name in `--common-name` and `--alternative-names` must belong to a domain your account has permission for. The bounds of each field are in [Certificates](/en/documentation/platform/workloads/certificate-manager/certificates/).
This command creates a CSR named `my-csr` for `example.com` and `www.example.com`, with a 2048-bit RSA key:
diff --git a/apps/docs/src/content/docs/en/pages/main-menu/reference/ai-inference/ai-models/qwen-2-5-vl-3b.mdx b/apps/docs/src/content/docs/en/pages/main-menu/reference/ai-inference/ai-models/qwen-2-5-vl-3b.mdx
index 45174dfae4..af61b5b3ad 100644
--- a/apps/docs/src/content/docs/en/pages/main-menu/reference/ai-inference/ai-models/qwen-2-5-vl-3b.mdx
+++ b/apps/docs/src/content/docs/en/pages/main-menu/reference/ai-inference/ai-models/qwen-2-5-vl-3b.mdx
@@ -94,7 +94,7 @@ One entry arrives in `choices`, and the text the model generated sits at `choice
### Tool calling
-A `tools` array declares the functions the model may call. Every entry sets `type` to `function` and carries a `function` object with three fields: the `name` the model returns, a `description` of what the function does, and the `parameters` it accepts, written as a JSON Schema object:
+A `tools` array declares the functions the model may call. Every entry sets `type` to `function` and carries a `function` object. That object has three fields: the `name` the model returns, a `description` of what the function does, and the `parameters` it accepts, written as a JSON Schema object:
```ts
const modelResponse = await Azion.AI.run("qwen-qwen25-vl-3b-instruct-awq", {
diff --git a/apps/docs/src/content/docs/en/pages/main-menu/reference/ai-inference/edge-ai-reference.mdx b/apps/docs/src/content/docs/en/pages/main-menu/reference/ai-inference/edge-ai-reference.mdx
index 4098079dc2..2ad0b02c8c 100644
--- a/apps/docs/src/content/docs/en/pages/main-menu/reference/ai-inference/edge-ai-reference.mdx
+++ b/apps/docs/src/content/docs/en/pages/main-menu/reference/ai-inference/edge-ai-reference.mdx
@@ -13,7 +13,7 @@ import DocCard from '@aziontech/webkit/doc-card'
Inference is the act of running a trained AI model. You send an input, and the model returns an output computed from the weights it learned in training: generated text, a ranking, or a vector of numbers that stands for the input. A model answers nothing until those weights are loaded into memory, on hardware sized for them. An inference service carries that part, keeping the models loaded and putting each one behind a request.
-**AI Inference** runs the models on Azion's distributed infrastructure, on [Azion Runtime](/en/documentation/devtools/runtime/). A model is not an object you create. You name one by its id inside a [function](/en/documentation/platform/functions/), and that call is what invokes it. Use AI Inference to generate text from a prompt, read the text out of an image, turn a document into a vector for retrieval, or rank a set of documents against a query.
+**AI Inference** runs the models on Azion's distributed infrastructure, on [Azion Runtime](/en/documentation/devtools/runtime/). A model is not an object you create. You name one by its id inside a [function](/en/documentation/platform/functions/), and that call is what invokes it. Use AI Inference to generate text from a prompt or to read the text out of an image. You can also use it to turn a document into a vector for retrieval, or to rank a set of documents against a query.
diff --git a/apps/docs/src/content/docs/en/pages/main-menu/reference/ai-inference/model-invocation.mdx b/apps/docs/src/content/docs/en/pages/main-menu/reference/ai-inference/model-invocation.mdx
index 861d000a86..264de63954 100644
--- a/apps/docs/src/content/docs/en/pages/main-menu/reference/ai-inference/model-invocation.mdx
+++ b/apps/docs/src/content/docs/en/pages/main-menu/reference/ai-inference/model-invocation.mdx
@@ -42,7 +42,7 @@ Azion issues no credential for a model call, and the endpoint carries no Azion a
## Request fields
-These fields form the body of a chat model request, whether you send it through the binding or over HTTP. Over HTTP, the body also carries a `model` field holding the model id. Through the binding, the first parameter carries the id and the body does not repeat it. Each chat model names the [OpenAI Chat API](https://developers.openai.com/api/reference/overview) as the endpoint it is compatible with, so a field behaves as that schema describes; the types, defaults, and bounds below are the ones AI Inference states. A dash in the Default column means the schema sets no default for that field.
+These fields form the body of a chat model request, whether you send it through the binding or over HTTP. Over HTTP, the body also carries a `model` field holding the model id. Through the binding, the first parameter carries the id and the body does not repeat it. Each chat model names the [OpenAI Chat API](https://developers.openai.com/api/reference/overview) as the endpoint it is compatible with, so a field behaves as that schema describes. The types, defaults, and bounds below are the ones AI Inference states. A dash in the Default column means the schema sets no default for that field.
| Field | Type | Required | Default | Description |
| --- | --- | --- | --- | --- |
diff --git a/apps/docs/src/content/docs/en/pages/main-menu/reference/build/edge-application/cache-settings.mdx b/apps/docs/src/content/docs/en/pages/main-menu/reference/build/edge-application/cache-settings.mdx
index 1a6c3c8b37..9679b193fe 100644
--- a/apps/docs/src/content/docs/en/pages/main-menu/reference/build/edge-application/cache-settings.mdx
+++ b/apps/docs/src/content/docs/en/pages/main-menu/reference/build/edge-application/cache-settings.mdx
@@ -12,7 +12,7 @@ import FrameBox from '@aziontech/webkit/frame-box'
import ItemList from '@aziontech/webkit/item-list'
import DocItem from '@aziontech/webkit/doc-item'
-A cache setting is a set of values that tell [Cache](/en/documentation/platform/applications/cache/) how to store and serve a response. It belongs to one Application, and its values are the browser time to live (TTL), the cache TTL and behavior, stale cache, Large File Optimization, [Tiered Cache](/en/documentation/platform/applications/cache/tiered-cache/), and the cache variations. A [Rules Engine](/en/documentation/platform/applications/rules-engine/) rule with the [Set Cache Policy](/en/documentation/platform/applications/rules-engine/#set-cache-policy) behavior applies the setting, and the setting acts only on the requests that this rule matches. To create one, refer to [Create a cache setting](/en/documentation/guides/application-performance/cache-and-purge/tune-cache-settings/).
+A cache setting is a set of values that tell [Cache](/en/documentation/platform/applications/cache/) how to store and serve a response. It belongs to one Application. Its values are the browser time to live (TTL), the cache TTL and behavior, stale cache, Large File Optimization, [Tiered Cache](/en/documentation/platform/applications/cache/tiered-cache/), and the cache variations. A [Rules Engine](/en/documentation/platform/applications/rules-engine/) rule with the [Set Cache Policy](/en/documentation/platform/applications/rules-engine/#set-cache-policy) behavior applies the setting, and the setting acts only on the requests that this rule matches. To create one, refer to [Create a cache setting](/en/documentation/guides/application-performance/cache-and-purge/tune-cache-settings/).
---
@@ -77,7 +77,7 @@ The `modules.cache` object sets how long Azion keeps a copy of a response and wh
Stale cache, the `stale_cache.enabled` field, lets Azion serve an expired copy for a limited window when the origin fails to answer. Large File Optimization, the `large_file_cache.enabled` field, stores a large object in fragments, and `large_file_cache.offset` holds their size, fixed at 1,024 kB. Tiered Cache is a Feature of Cache that adds a second cache layer between the data center that answers a request and your origin. `tiered_cache.enabled` turns it on for the objects this setting caches, and `tiered_cache.topology` selects where that layer holds them. A `tiered_cache` object sent without `enabled` turns the layer on. For how each one behaves on a request, refer to [Expiration and freshness](/en/documentation/platform/applications/cache/expiration-and-freshness/).
:::note
-Two constraints bind these values. A `modules.cache.max_age` below 60 seconds requires [Application Accelerator](/en/documentation/platform/applications/application-accelerator/) on the Application; without it, the API refuses the setting with error `21021`. In Azion Console, the **Max Age** field states a minimum of 3 seconds once **Large file optimization** is on; without Application Accelerator, the API still refuses a value below 60 seconds with error `21021`. Tiered Cache requires `override` in `modules.cache.behavior`; with `honor`, the API refuses the setting with error `21001`. In Azion Console, turning on **Large file optimization** or **Tiered Cache** disables the _Honor cache policies_ option and selects _Override cache behavior_, but the API accepts `honor` with Large File Optimization.
+Two constraints bind these values. A `modules.cache.max_age` below 60 seconds requires [Application Accelerator](/en/documentation/platform/applications/application-accelerator/) on the Application; without it, the API refuses the setting with error `21021`. In Azion Console, the **Max Age** field states a minimum of 3 seconds once **Large file optimization** is on. Without Application Accelerator, the API still refuses a value below 60 seconds with error `21021`. Tiered Cache requires `override` in `modules.cache.behavior`; with `honor`, the API refuses the setting with error `21001`. In Azion Console, turning on **Large file optimization** or **Tiered Cache** disables the _Honor cache policies_ option and selects _Override cache behavior_, but the API accepts `honor` with Large File Optimization.
:::
---
diff --git a/apps/docs/src/content/docs/en/pages/main-menu/reference/build/edge-application/main-settings.mdx b/apps/docs/src/content/docs/en/pages/main-menu/reference/build/edge-application/main-settings.mdx
index fa40cc4d95..5de7c90249 100644
--- a/apps/docs/src/content/docs/en/pages/main-menu/reference/build/edge-application/main-settings.mdx
+++ b/apps/docs/src/content/docs/en/pages/main-menu/reference/build/edge-application/main-settings.mdx
@@ -13,7 +13,7 @@ import VersionRollingOut from '~/includes/snippets/versionRollingOut/en/snippet.
[Main Settings | v3](/en/documentation/platform/applications/main-settings-v3/)
-Main Settings is the set of values that apply to an [Application](/en/documentation/platform/applications/) as a whole: its name, the Platform Resources turned on in it, whether it logs the rules each request runs, and whether it is active. Azion Console groups them in the **Main Settings** tab of the Application, and the API returns them as fields of the Application. For the path a request takes through an Application, refer to [How Applications works](/en/documentation/platform/applications/how-it-works/).
+Main Settings is the set of values that apply to an [Application](/en/documentation/platform/applications/) as a whole. These values are its name, the Platform Resources turned on in it, whether it logs the rules each request runs, and whether it is active. Azion Console groups them in the **Main Settings** tab of the Application, and the API returns them as fields of the Application. For the path a request takes through an Application, refer to [How Applications works](/en/documentation/platform/applications/how-it-works/).
---
diff --git a/apps/docs/src/content/docs/en/pages/main-menu/reference/build/edge-application/real-time-purge.mdx b/apps/docs/src/content/docs/en/pages/main-menu/reference/build/edge-application/real-time-purge.mdx
index 528d3b5858..f381b06a86 100644
--- a/apps/docs/src/content/docs/en/pages/main-menu/reference/build/edge-application/real-time-purge.mdx
+++ b/apps/docs/src/content/docs/en/pages/main-menu/reference/build/edge-application/real-time-purge.mdx
@@ -106,7 +106,7 @@ When a cache setting varies the cache key, one object has one key per variation.
Query-string, cookie, device group, and request method variation come from Advanced Cache Key, in [Application Accelerator](/en/documentation/platform/applications/application-accelerator/). Application Accelerator also caches `POST` and `OPTIONS` responses; without it, Azion caches `GET` and `HEAD` only. For the behaviors, refer to [Application Accelerator settings](/en/documentation/platform/applications/application-accelerator/settings/).
-An image that [Image Processor](/en/documentation/platform/applications/image-processor/) serves has one key per processing and per format when the cache setting names `ims` in its query-string allowlist. When the cache setting does not vary the key by query string, the `ims` value is not part of the key, so every size and processing of the path shares a key, and the first one stored answers every `ims` value. With `ims` in the allowlist, the key carries the host and path, then `@@`, the `ims` query string, and the converted format at the end, with no separator. The four keys below belong to one image:
+An image that [Image Processor](/en/documentation/platform/applications/image-processor/) serves has one key per processing and per format when the cache setting names `ims` in its query-string allowlist. When the cache setting does not vary the key by query string, the `ims` value is not part of the key. Every size and processing of the path then shares a key, and the first one stored answers every `ims` value. With `ims` in the allowlist, the key carries the host and path, then `@@`, the `ims` query string, and the converted format at the end, with no separator. The four keys below belong to one image:
- `httpstatic.example.com/static/images/image.jpg@@`
- `httpstatic.example.com/static/images/image.jpg@@webp`
diff --git a/apps/docs/src/content/docs/en/pages/main-menu/reference/build/edge-application/websocket.mdx b/apps/docs/src/content/docs/en/pages/main-menu/reference/build/edge-application/websocket.mdx
index f23d089d99..44b6e7de7b 100644
--- a/apps/docs/src/content/docs/en/pages/main-menu/reference/build/edge-application/websocket.mdx
+++ b/apps/docs/src/content/docs/en/pages/main-menu/reference/build/edge-application/websocket.mdx
@@ -26,7 +26,7 @@ A WebSocket connection through an Application needs native WebSocket support at
## Upgrade headers
-An Application with WebSocket Proxy enabled reads two request headers to decide whether a request opens a WebSocket connection. It treats the request as one, and proxies it to the origin, when `Upgrade` reads `websocket` and `Connection` carries the `upgrade` token, in any letter case, alone or in a list such as `Connection: keep-alive, Upgrade`.
+An Application with WebSocket Proxy enabled reads two request headers to decide whether a request opens a WebSocket connection. It treats the request as one, and proxies it to the origin, when `Upgrade` reads `websocket` and `Connection` carries the `upgrade` token. The token counts in any letter case, alone or in a list such as `Connection: keep-alive, Upgrade`.
| Header | Value |
| --- | --- |
diff --git a/apps/docs/src/content/docs/en/pages/main-menu/reference/observe/data-stream/data-stream.mdx b/apps/docs/src/content/docs/en/pages/main-menu/reference/observe/data-stream/data-stream.mdx
index 07f0e322a1..b9bfa6f733 100644
--- a/apps/docs/src/content/docs/en/pages/main-menu/reference/observe/data-stream/data-stream.mdx
+++ b/apps/docs/src/content/docs/en/pages/main-menu/reference/observe/data-stream/data-stream.mdx
@@ -12,7 +12,7 @@ import DocButton from '~/components/webkit/DocButton.vue';
import DocCardGroup from '@aziontech/webkit/doc-card-group'
import DocCard from '@aziontech/webkit/doc-card'
-Log streaming is a way to collect the records a platform writes about its traffic and its account. The platform pushes each record to a destination you run as it happens, such as a SIEM (a security information and event management system), a data warehouse, or a stream processor. You analyze the records in your own tools, and you do not poll an API to collect them.
+Log streaming is a way to collect the records a platform writes about its traffic and its account. The platform pushes each record to a destination you run as it happens. The destination can be a SIEM (a security information and event management system), a data warehouse, or a stream processor. You analyze the records in your own tools, and you do not poll an API to collect them.
**Data Stream** sends the event logs of [Activity History](/en/documentation/fundamentals/activity-history/), [applications](/en/documentation/platform/applications/), [functions](/en/documentation/platform/functions/), and WAF to one endpoint per stream. Each stream shapes the events with a template and sends them in batches. Use Data Stream to [feed a SIEM with WAF events](/en/documentation/guides/application-security/firewall-and-waf/integrate-siems/), [keep request logs in a data warehouse](/en/documentation/guides/platform/observability/endpoint-google-bigquery/), audit the changes made to your account, or [debug functions](/en/documentation/guides/platform/observability/debugging-functions-data-stream/).
@@ -84,7 +84,7 @@ Saving a stream checks the format of its fields, not the endpoint, so the first
## Scope and limits
- **Data sources**: a stream collects from one of four data sources: *Activity History*, *Applications*, *Functions*, or *WAF Events*. *WAF Events* needs [Firewall](/en/documentation/platform/firewall/) with WAF. For the variables of each one, refer to [Data sources and variables](/en/documentation/platform/data-stream/data-sources-and-variables/).
-- **Endpoints**: a stream sends to one of 11 endpoint types: *Standard HTTP/HTTPS POST*, *Apache Kafka*, *Simple Storage Service (S3)*, *Google BigQuery*, *Elasticsearch*, *Splunk*, *AWS Kinesis Data Firehose*, *Datadog*, *IBM QRadar*, *Azure Monitor*, and *Azure Blob Storage*. Sending the same events to two endpoints takes two streams. For the fields of each type, refer to [Endpoints](/en/documentation/platform/data-stream/endpoints/).
+- **Endpoints**: a stream sends to one of 11 endpoint types. The types are *Standard HTTP/HTTPS POST*, *Apache Kafka*, *Simple Storage Service (S3)*, *Google BigQuery*, *Elasticsearch*, *Splunk*, *AWS Kinesis Data Firehose*, *Datadog*, *IBM QRadar*, *Azure Monitor*, and *Azure Blob Storage*. Sending the same events to two endpoints takes two streams. For the fields of each type, refer to [Endpoints](/en/documentation/platform/data-stream/endpoints/).
- **Templates**: Azion provides five [preset templates](/en/documentation/platform/data-stream/templates-and-payload/#preset-templates), and you write a [custom template](/en/documentation/platform/data-stream/templates-and-payload/#custom-templates) to choose the variables of each log line.
- **Batching**: a batch holds 2,000 log lines or 60 seconds of events. An *AWS Kinesis Data Firehose* endpoint receives batches of 500 log lines or 60 seconds, and a *Standard HTTP/HTTPS POST* batch also closes at its **Payload Max Size**. Logs reach your infrastructure in up to 3 minutes.
- **Scope**: a stream carries a sampling rate or a filter of chosen [workloads](/en/documentation/platform/workloads/), never both. Saving an active stream with sampling deactivates every other stream on the account, while streams with a workload filter run side by side. For both options, refer to [Stream settings](/en/documentation/platform/data-stream/stream-settings/#transform).
@@ -94,7 +94,7 @@ Saving a stream checks the format of its fields, not the endpoint, so the first
- **Usage per plan**: Data Stream needs no activation step: a stream runs once you save it. It is billed on Requests and Data Transfer, and each plan includes a monthly amount of both, listed in [Data Stream limits](/en/documentation/platform/data-stream/limits/#included-usage-per-plan). For the rates, refer to [Pricing](/en/documentation/fundamentals/pricing/#data-stream).
- **Failures**: when an endpoint is unavailable or answers with an error, the log lines of that send do not reach it. For the causes and fixes, refer to [Troubleshoot Data Stream](/en/documentation/platform/data-stream/troubleshooting/).
-Data Stream does not store or query logs. Real-Time Events keeps the raw events of your products for 7 days, and Activity History events for 2 years, while your endpoint keeps what the stream sends for as long as you decide.
+Data Stream does not store or query logs. Real-Time Events keeps the raw events of your products for 7 days, and Activity History events for 2 years. Your endpoint keeps what the stream sends for as long as you decide.
---
diff --git a/apps/docs/src/content/docs/en/pages/main-menu/reference/observe/real-time-events/real-time-events.mdx b/apps/docs/src/content/docs/en/pages/main-menu/reference/observe/real-time-events/real-time-events.mdx
index 71a6f2f8e1..d229b7d7a9 100644
--- a/apps/docs/src/content/docs/en/pages/main-menu/reference/observe/real-time-events/real-time-events.mdx
+++ b/apps/docs/src/content/docs/en/pages/main-menu/reference/observe/real-time-events/real-time-events.mdx
@@ -10,7 +10,7 @@ import DocButton from '~/components/webkit/DocButton.vue'
import DocCardGroup from '@aziontech/webkit/doc-card-group'
import DocCard from '@aziontech/webkit/doc-card'
-A system that serves traffic can write one record for each piece of work it does: the address a request came from, the path it asked for, the status it answered with, and the time it took. Those records are kept for a fixed period and searched field by field, so a question asked after the fact is answered from what was written rather than from what anyone remembers. At the end of the period the records are removed, and the question they would have answered can no longer be asked.
+A system that serves traffic can write one record for each piece of work it does. A record holds the address a request came from, the path it asked for, the status it answered with, and the time it took. Those records are kept for a fixed period and searched field by field, so a question asked after the fact is answered from what was written rather than from what anyone remembers. At the end of the period the records are removed, and the question they would have answered can no longer be asked.
**Real-Time Events** is the Platform Resource that holds those records on Azion's distributed infrastructure and serves them back. Each Azion product writes its own records into a data source of its own, and each data source carries the set of preorganized variables that product fills. Use Real-Time Events to search the records of past traffic, inspect a possible attack, debug a [function](/en/documentation/platform/functions/), measure how an [application](/en/documentation/platform/applications/) performs, or check what changed on an account.
diff --git a/apps/docs/src/content/docs/en/pages/main-menu/reference/secure/edge-connector/edge-connector.mdx b/apps/docs/src/content/docs/en/pages/main-menu/reference/secure/edge-connector/edge-connector.mdx
index 5a05627096..aba0cdb33f 100644
--- a/apps/docs/src/content/docs/en/pages/main-menu/reference/secure/edge-connector/edge-connector.mdx
+++ b/apps/docs/src/content/docs/en/pages/main-menu/reference/secure/edge-connector/edge-connector.mdx
@@ -15,7 +15,7 @@ import VersionRollingOut from '~/includes/snippets/versionRollingOut/en/snippet.
A reverse proxy answers clients on behalf of a server you run, called the origin. When the proxy cannot answer from what it already holds, it opens its own connection to the origin and forwards the request. On that connection, it decides how to address the origin: the hostname in the `Host` header, the path, the protocol, and the port. Clients never connect to the origin, so you can move or protect the origin without any change on the client side.
-**Connectors** is the Platform Resource that holds those decisions on Azion. A connector is an object of its own: it stores the address of your origin and the settings that shape every request to it, and a rule in an [application](/en/documentation/platform/applications/) sends requests to it with the _Set Connector_ behavior. Several applications can reuse one connector, so the connection settings of an origin live in one place. Use Connectors to send traffic to a cloud server or a server in your data center, serve objects from an Object Storage bucket, spread requests across several servers, keep clients from reaching your origin directly, or deliver a live stream.
+**Connectors** is the Platform Resource that holds those decisions on Azion. A connector is an object of its own: it stores the address of your origin and the settings that shape every request to it. A rule in an [application](/en/documentation/platform/applications/) sends requests to the connector with the _Set Connector_ behavior. Several applications can reuse one connector, so the connection settings of an origin live in one place. Use Connectors to send traffic to a cloud server or a server in your data center, or to serve objects from an Object Storage bucket. You can also use Connectors to spread requests across several servers, keep clients from reaching your origin directly, or deliver a live stream.
@@ -85,7 +85,7 @@ For how it chooses an address, where it acts on a request, and where to start, r
### Origin Shield
-Origin Shield protects the origin of a connector of type `http` in two ways: Origin IP ACL lets your origin's firewall accept only Azion's addresses, and HMAC signs each request the connector sends. Turn it on when clients must not reach your origin directly, or when the origin serves only signed requests.
+Origin Shield protects the origin of a connector of type `http` in two ways. Origin IP ACL lets your origin's firewall accept only Azion's addresses, and HMAC signs each request the connector sends. Turn it on when clients must not reach your origin directly, or when the origin serves only signed requests.
For what each defense proves, where it acts on a request, and where to start, refer to the [Origin Shield overview](/en/documentation/platform/connectors/origin-shield/).
diff --git a/apps/docs/src/content/docs/en/pages/main-menu/reference/secure/edge-connector/sni-check.mdx b/apps/docs/src/content/docs/en/pages/main-menu/reference/secure/edge-connector/sni-check.mdx
index a69084954a..05d506679b 100644
--- a/apps/docs/src/content/docs/en/pages/main-menu/reference/secure/edge-connector/sni-check.mdx
+++ b/apps/docs/src/content/docs/en/pages/main-menu/reference/secure/edge-connector/sni-check.mdx
@@ -64,7 +64,7 @@ When TLS session data cannot be retrieved, the platform proceeds normally rather
## Enforcement scope
-Enforcing strict SNI validation significantly reduces the risk of **SNI Spoofing** attacks, in which a malicious actor manipulates the SNI field to route a TLS connection through a certificate that does not legitimately cover the target hostname. By returning `421 Misdirected Request` in these cases, the Azion Web Platform ensures that each HTTPS request is served only under a valid and appropriate security context.
+Enforcing strict SNI validation significantly reduces the risk of **SNI Spoofing** attacks. In this attack, a malicious actor manipulates the SNI field to route a TLS connection through a certificate that does not legitimately cover the target hostname. By returning `421 Misdirected Request` in these cases, the Azion Web Platform ensures that each HTTPS request is served only under a valid and appropriate security context.
SNI Check enforcement is not configurable through the Azion Console or the API. To enable or disable it for your workloads, contact [Azion Support](https://www.azion.com/en/support/).
diff --git a/apps/docs/src/content/docs/en/pages/main-menu/reference/secure/edge-firewall/azion-bot-manager-lite.mdx b/apps/docs/src/content/docs/en/pages/main-menu/reference/secure/edge-firewall/azion-bot-manager-lite.mdx
index 07c6d4d255..9366eb2402 100644
--- a/apps/docs/src/content/docs/en/pages/main-menu/reference/secure/edge-firewall/azion-bot-manager-lite.mdx
+++ b/apps/docs/src/content/docs/en/pages/main-menu/reference/secure/edge-firewall/azion-bot-manager-lite.mdx
@@ -59,10 +59,10 @@ Rules 15, 16, and 17 read the session cookie pair the function sets on a browser
Rule 14 checks the client IP against the [Network Lists](/en/documentation/platform/firewall/network-shield/network-lists/) whose IDs are listed in `reputation_network_lists`, and adds 6 points for each list the IP is found in.
-Two arguments take a request out of the table before it is scored. A request whose fingerprint is listed in `good_fingerprint_list` bypasses every rule above. With `block_ai_bots` set to `true`, a request from a known AI user agent is blocked upstream of the scoring pipeline, so it reaches no rule and carries no rule IDs in its log line.
+Two arguments take a request out of the table before it is scored. A request whose fingerprint is listed in `good_fingerprint_list` bypasses every rule above. With `block_ai_bots` set to `true`, a request from a known AI user agent is blocked upstream of the scoring pipeline. That request reaches no rule and carries no rule IDs in its log line.
:::caution
-Rules 18 to 26 ship in v0.2.0 without prior calibration, so they can score legitimate traffic depending on your traffic profile. Run the instance with `action` set to `allow`, read the rule IDs out of the report log, and list the rules that keep matching legitimate requests in `disabled_rules` before you move to a blocking action.
+Rules 18 to 26 ship in v0.2.0 without prior calibration, so they can score legitimate traffic depending on your traffic profile. Run the instance with `action` set to `allow`, and read the rule IDs out of the report log. Before you move to a blocking action, list the rules that keep matching legitimate requests in `disabled_rules`.
:::
The IDs a request matched are written to the report log, so the values for `disabled_rules` come from your own traffic rather than from this table.
@@ -92,7 +92,7 @@ Bot Manager Lite v0.2.0 ships a default for eight arguments:
`log_headers` ships with nine headers: `accept`, `accept-encoding`, `accept-language`, `content-type`, `host`, `referer`, `user-agent`, `x-forwarded-for`, and `x-request-id`. The array names the headers the function does write, not headers to keep out of the log. Seven headers are never written, whatever the array carries: `authorization`, `cookie`, `proxy-authorization`, `set-cookie`, `x-csrf-token`, `x-api-key`, and `x-amz-security-token`. Header values are written base64-encoded.
-The seven arguments below are documented for Bot Manager Lite and ship no default with the function, so **Documented default** is the value the documentation states rather than a value read off the installed function.
+The seven arguments below are documented for Bot Manager Lite and ship no default with the function. For this reason, **Documented default** is the value the documentation states rather than a value read off the installed function.
| Argument | Type | Documented default | What it does |
| --- | --- | --- | --- |
diff --git a/apps/docs/src/content/docs/en/pages/main-menu/reference/secure/edge-firewall/edge-functions-for-edge-firewall/edge-functions-firewall.mdx b/apps/docs/src/content/docs/en/pages/main-menu/reference/secure/edge-firewall/edge-functions-for-edge-firewall/edge-functions-firewall.mdx
index 63644964f5..33d5b92485 100644
--- a/apps/docs/src/content/docs/en/pages/main-menu/reference/secure/edge-firewall/edge-functions-for-edge-firewall/edge-functions-firewall.mdx
+++ b/apps/docs/src/content/docs/en/pages/main-menu/reference/secure/edge-firewall/edge-functions-for-edge-firewall/edge-functions-firewall.mdx
@@ -60,7 +60,7 @@ The table lists the methods a function on a firewall calls on the `firewall` eve
| `event.respondWith()` | A `Response` object | Intercepts the request and answers it with a custom response, whose status, headers, and content the object sets |
| `event.waitUntil()` | A promise, such as the one an `async` handler returns | Runs an `async` handler from the synchronous listener. Without it, the promise can end in unexpected exceptions |
-In the ES Modules pattern, the `firewall` handler of a function built by Azion CLI 4.24.0 or later calls these methods on `ctx`, its third argument: `ctx.addRequestHeader()`, `ctx.addResponseHeader()`, `ctx.continue()`, `ctx.deny()`, `ctx.drop()`, `ctx.respondWith()`, and `ctx.waitUntil()`. Each one behaves like the event method of the same name. A function built by Azion CLI 4.23.0 gets a `ctx` that carries only `waitUntil`, so `ctx.deny()` throws and the request answers HTTP 500. For the handler and its `ctx`, refer to [Handlers](/en/documentation/devtools/runtime/api-reference/handlers/#firewall-handler).
+In the ES Modules pattern, the `firewall` handler of a function built by Azion CLI 4.24.0 or later calls these methods on `ctx`, its third argument. The methods are `ctx.addRequestHeader()`, `ctx.addResponseHeader()`, `ctx.continue()`, `ctx.deny()`, `ctx.drop()`, `ctx.respondWith()`, and `ctx.waitUntil()`. Each one behaves like the event method of the same name. A function built by Azion CLI 4.23.0 gets a `ctx` that carries only `waitUntil`, so `ctx.deny()` throws and the request answers HTTP 500. For the handler and its `ctx`, refer to [Handlers](/en/documentation/devtools/runtime/api-reference/handlers/#firewall-handler).
### event.addRequestHeader
diff --git a/apps/docs/src/content/docs/en/pages/main-menu/reference/secure/edge-firewall/rules-engine.mdx b/apps/docs/src/content/docs/en/pages/main-menu/reference/secure/edge-firewall/rules-engine.mdx
index 704d9a0042..748f158ff8 100644
--- a/apps/docs/src/content/docs/en/pages/main-menu/reference/secure/edge-firewall/rules-engine.mdx
+++ b/apps/docs/src/content/docs/en/pages/main-menu/reference/secure/edge-firewall/rules-engine.mdx
@@ -77,7 +77,7 @@ Once a rule on the firewall uses `${network}`, Network Shield cannot be turned o
| _Certificate Verification Error_ | `CERTIFICATE_VERIFICATION_ERROR` | The client certificate was not valid |
| _Missing Client Certificate_ | `MISSING_CLIENT_CERTIFICATE` | The request carried no client certificate |
-`Client Certificate Validation` takes one value, `true`, which the Console offers as the single entry _Valid_ in the **Select a validation result** list. A list with one entry arrives already selected, so the field looks filled before you open it. _is equal_ matches a request whose client certificate passed validation, and _is not equal_ matches one that carried no certificate or one that was not valid.
+`Client Certificate Validation` takes one value, `true`, which the Console offers as the single entry _Valid_ in the **Select a validation result** list. A list with one entry arrives already selected, so the field looks filled before you open it. The operator _is equal_ matches a request whose client certificate passed validation, and _is not equal_ matches one that carried no certificate or one that was not valid.
### Operators
@@ -200,7 +200,7 @@ For how the rate and the burst admit requests, refer to [How Firewall works](/en
_Set WAF_ applies a WAF [rule set](/en/documentation/platform/firewall/waf/rules-set/) to the requests the rule matches, and requires WAF enabled on the firewall. A rule set runs only when a rule carries this behavior, and a rule carries at most one. Rule sets live in Azion Console under **Edge Libraries** > **WAF Rules**.
:::caution
-Azion keeps one _Set WAF_ configuration for each criteria logic. When another firewall carries a rule with the same criteria and a _Set WAF_ behavior that names a different rule set, only the most recent of the two is processed, and the other rule set does not run. Refer to [How Set WAF resolves across firewalls](/en/documentation/platform/firewall/how-it-works/#how-set-waf-resolves-across-firewalls).
+Azion keeps one _Set WAF_ configuration for each criteria logic. Another firewall can carry a rule with the same criteria and a _Set WAF_ behavior that names a different rule set. In that case, only the most recent of the two is processed, and the other rule set does not run. Refer to [How Set WAF resolves across firewalls](/en/documentation/platform/firewall/how-it-works/#how-set-waf-resolves-across-firewalls).
:::
| Attribute | Console control | Values | Description |
diff --git a/apps/docs/src/content/docs/en/pages/main-menu/reference/secure/edge-firewall/web-application-firewall/waf-rule-sets.mdx b/apps/docs/src/content/docs/en/pages/main-menu/reference/secure/edge-firewall/web-application-firewall/waf-rule-sets.mdx
index 9f38b4c85d..d2bcbcf231 100644
--- a/apps/docs/src/content/docs/en/pages/main-menu/reference/secure/edge-firewall/web-application-firewall/waf-rule-sets.mdx
+++ b/apps/docs/src/content/docs/en/pages/main-menu/reference/secure/edge-firewall/web-application-firewall/waf-rule-sets.mdx
@@ -12,11 +12,11 @@ import FrameBox from '@aziontech/webkit/frame-box'
import ItemList from '@aziontech/webkit/item-list'
import DocItem from '@aziontech/webkit/doc-item'
-A rule set is the object that holds what [Web Application Firewall](/en/documentation/platform/firewall/waf/) (WAF) looks for: the threat families it scores a request against, and the sensitivity level that turns a score into a block. Azion Console lists these under **WAF Rules**; the Azion API and the Azion CLI call the same object a `waf`.
+A rule set is the object that holds what [Web Application Firewall](/en/documentation/platform/firewall/waf/) (WAF) looks for. It holds the threat families that WAF scores a request against, and the sensitivity level that turns a score into a block. Azion Console lists these under **WAF Rules**; the Azion API and the Azion CLI call the same object a `waf`.
A rule set does not act on its own. It runs when a rule in [Rules Engine for Firewall](/en/documentation/platform/firewall/rules-engine/) carries the **Set WAF** behavior naming it, together with a mode of _Logging_ or _Blocking_. The mode belongs to that rule and not to the rule set, so one rule set runs in _Logging_ on one rule and in _Blocking_ on another. For more information, refer to [Scoring and modes](/en/documentation/platform/firewall/waf/scoring-and-modes/).
-This page lists the fields of a rule set, the eight threat families it scores, the five sensitivity levels and their thresholds, the 63 internal rules behind the families, and the API and CLI surfaces that manage it.
+This page lists the fields of a rule set, the eight threat families it scores, and the five sensitivity levels and their thresholds. It also lists the 63 internal rules behind the families, and the API and CLI surfaces that manage it.
---
@@ -425,7 +425,7 @@ A rejected request returns an `errors` array. Each entry carries a `code`, a `ti
| `26006` | Name Already In Use | 400 | A `name` another rule set in the account already holds | Choose another name |
| `26007` | Cannot Delete WAF | 400 | A `DELETE` on a rule set that a Rules Engine rule still applies through a `set_waf` behavior | Delete each rule the error names, or point its _Set WAF_ at another rule set, then delete the rule set again |
-`10067` returns `500` for a client mistake. A repeated threat family is answered with the text `A server error occurred.`, which names neither the duplicate nor the field, so a reader who trusts the status code concludes the platform is down, and a retry returns the same `500`. Its `source` pointer reads `/data/attributes/thresholds`, one segment short of the pointer every other threshold error returns.
+`10067` returns `500` for a client mistake. A repeated threat family is answered with the text `A server error occurred.`, which names neither the duplicate nor the field. A reader who trusts the status code then concludes the platform is down, and a retry returns the same `500`. Its `source` pointer reads `/data/attributes/thresholds`, one segment short of the pointer every other threshold error returns.
`26007` names each rule that still applies the rule set twice, as ` - `: once in the `detail`, `It was not possible to perform this operation. To delete this WAF, you must first remove its usage in the following rules engine: [' - '].`, and once as an entry of `meta.ef_rules_using_waf`. Its `source` pointer reads `/data`.
diff --git a/apps/docs/src/content/docs/en/pages/main-menu/reference/store/kv-store/kv-store.mdx b/apps/docs/src/content/docs/en/pages/main-menu/reference/store/kv-store/kv-store.mdx
index 8affb6bbcc..0e6f6af36a 100644
--- a/apps/docs/src/content/docs/en/pages/main-menu/reference/store/kv-store/kv-store.mdx
+++ b/apps/docs/src/content/docs/en/pages/main-menu/reference/store/kv-store/kv-store.mdx
@@ -73,7 +73,7 @@ flowchart TD
5. `Azion.KV.open` resolves the namespace by name. A name no namespace on the account carries throws `NotFound`.
6. The handler calls `put`, `get`, `getWithMetadata`, or `delete`, and returns its response.
-Creating the namespace outside the request keeps the request path short, and it costs you the ability to provision one on demand: a function cannot create the namespace it needs, so the name has to exist before the code that opens it ships.
+Creating the namespace outside the request keeps the request path short, and it costs you the ability to provision one on demand. A function cannot create the namespace it needs, so the name has to exist before the code that opens it ships.
---
diff --git a/apps/docs/src/content/docs/en/pages/store/kv-store/best-practices.mdx b/apps/docs/src/content/docs/en/pages/store/kv-store/best-practices.mdx
index ce75acf05c..9564824b7e 100644
--- a/apps/docs/src/content/docs/en/pages/store/kv-store/best-practices.mdx
+++ b/apps/docs/src/content/docs/en/pages/store/kv-store/best-practices.mdx
@@ -14,7 +14,7 @@ import DocItem from '@aziontech/webkit/doc-item'
A namespace is named once and keeps that name for as long as the account exists, because no interface renames one, empties one, or deletes one. A key is reachable only by a name the code can build again, because nothing lists what a namespace holds. A read can return a value an earlier write has already replaced. A rejected request arrives in one of two shapes, and a client written for one of them records the other as a success. Each of those is decided where the code is written, and each is cheap there and expensive afterwards.
-The practices below run in the order the decisions arrive. The namespace name comes first, because no interface changes it. Then the client a function opens, the two envelopes a rejected namespace request arrives in, and the key name that stands in for the listing this store does not have. The last four cover the type a value takes on the way in and on the way out, reading several keys in one call, the staleness every read carries, and the questions to keep out of the store.
+The practices below run in the order the decisions arrive. The namespace name comes first, because no interface changes it. Then the client a function opens, the two envelopes a rejected namespace request arrives in, and the key name that stands in for the listing this store does not have. The last four start with the type a value takes on the way in and on the way out, and with reading several keys in one call. They end with the staleness every read carries and the questions to keep out of the store.
---
@@ -22,7 +22,9 @@ The practices below run in the order the decisions arrive. The namespace name co
Choose a namespace name that still describes its contents a year from now, because nothing in KV Store renames one.
-The Azion API v4 exposes three operations on a namespace: create, list, and retrieve. `PUT`, `PATCH`, and `DELETE` each answer `405`, so a namespace cannot be renamed, deactivated, emptied, or deleted once it exists, and a name the account creates stays on the account. The name is also the identifier, since a namespace carries no numeric id, so the name is what every later request and every `Azion.KV.open` call in a function passes. A name that states the application and the environment it serves tells the next reader of the list which namespace a function is opening, and it keeps one workload's keys out of another's. For example, a checkout service that runs in two environments holds two namespaces rather than one namespace with two key prefixes, so a staging write cannot land on a production key.
+The Azion API v4 exposes three operations on a namespace: create, list, and retrieve. `PUT`, `PATCH`, and `DELETE` each answer `405`, so a namespace cannot be renamed, deactivated, emptied, or deleted once it exists, and a name the account creates stays on the account. The name is also the identifier, since a namespace carries no numeric id, so the name is what every later request and every `Azion.KV.open` call in a function passes.
+
+A name that states the application and the environment it serves tells the next reader of the list which namespace a function is opening. Such a name also keeps one workload's keys out of another's. For example, a checkout service that runs in two environments holds two namespaces rather than one namespace with two key prefixes. That way, a staging write cannot land on a production key.
```text
checkout-sessions-prod
@@ -32,7 +34,7 @@ checkout-flags-prod
Write names in lowercase, with the hyphen between words, and keep that form for every namespace on the account. The platform does not require it: the pattern `^[a-zA-Z0-9_-]+$` accepts uppercase, so `Orders-EU` is a valid name and so is `orders-eu`. **Names are case-sensitive**, so those two are different namespaces, and an account can end up holding both. Since nothing deletes a namespace, a name created in the wrong case stays on the account under that case for good. Lowercase is a convention this page recommends, not a rule the API enforces, and its value is that it removes the one mistake you cannot take back. For the rules it does enforce, refer to [Namespaces](/en/documentation/platform/kv-store/namespaces/).
-The cost is that the decision is permanent, and it is taken before the first key exists. A namespace whose name stops describing its contents is replaced by creating a second one and writing the keys into it from a function, and the first one stays on the account from then on.
+The cost is that the decision is permanent, and it is taken before the first key exists. A namespace whose name stops describing its contents is replaced by creating a second one and writing the keys into it from a function. The first one stays on the account from then on.
---
@@ -71,7 +73,9 @@ The cost is that every call holds the handler until it resolves. A write the res
Write one handler that reads both shapes a rejected namespace request returns, because a client that reads one of them treats the other as a success.
-Two emitters answer under `https://api.azion.com/v4/workspace/kv/namespaces`, the collection and the resource path beneath it. The KV service answers a validation failure, a missing namespace, and a server error with `state` set to `error` and an `error` object, where `code` is a snake_case string such as `validation_error` or `namespace_not_found` and the text is in `message`. The platform gateway answers an unsupported method with an `errors` array, where `code` is numeric, the text is in `title` and `detail`, and `status` repeats the HTTP status. The two share no keys. A client that reads `errors[0].detail` finds nothing on every `400` and `404` the KV service raises, and a client that reads `error.message` finds nothing on the `405` that a `DELETE` returns from `https://api.azion.com/v4/workspace/kv/namespaces/{name}`, the resource path.
+Two emitters answer under `https://api.azion.com/v4/workspace/kv/namespaces`, the collection and the resource path beneath it. The KV service answers a validation failure, a missing namespace, and a server error with `state` set to `error` and an `error` object. In that object, `code` is a snake_case string such as `validation_error` or `namespace_not_found`, and the text is in `message`. The platform gateway answers an unsupported method with an `errors` array, where `code` is numeric, the text is in `title` and `detail`, and `status` repeats the HTTP status.
+
+The two share no keys. A client that reads `errors[0].detail` finds nothing on every `400` and `404` the KV service raises. A client that reads `error.message` finds nothing on the `405` that a `DELETE` returns from `https://api.azion.com/v4/workspace/kv/namespaces/{name}`, the resource path.
```javascript
// Returns a message for either envelope a namespace request can answer with.
@@ -90,7 +94,7 @@ function kvErrorMessage(body) {
}
```
-The third branch is not decoration. A path the gateway does not route answers with an HTML page rather than either envelope, so a client that parses the body as JSON needs somewhere for that case to land. For both envelopes in full, and the code and message each failure returns, refer to [Namespaces](/en/documentation/platform/kv-store/namespaces/).
+The third branch is not decoration. A path the gateway does not route answers with an HTML page rather than either envelope. A client that parses the body as JSON therefore needs somewhere for that case to land. For both envelopes in full, and the code and message each failure returns, refer to [Namespaces](/en/documentation/platform/kv-store/namespaces/).
The cost is two parsers for one endpoint, and a test of the body's shape before any field is read out of it. A client that grows a third failure path later has to add it in both branches.
@@ -100,7 +104,9 @@ The cost is two parsers for one endpoint, and a test of the body's shape before
Compose every key from values the request already holds, because no interface lists the keys a namespace holds.
-The client exposes `get`, `getWithMetadata`, `put`, and `delete`, and nothing else. There is no `list`, no `keys`, and no enumeration of a namespace's contents, on the client or in the Azion API v4, so a key is reachable only by a name the code can produce again. The naming scheme is what replaces the listing. One separator used everywhere keeps it readable: a colon between a prefix naming the kind of record and the identifier selecting one, as in `session:42` and `flag:new-checkout`. A key nothing can name again is also a key nothing can remove, since `delete` takes the key, so give a record with a natural lifetime an expiry when you write it and let it leave on its own.
+The client exposes `get`, `getWithMetadata`, `put`, and `delete`, and nothing else. There is no `list`, no `keys`, and no enumeration of a namespace's contents, on the client or in the Azion API v4. A key is therefore reachable only by a name the code can produce again.
+
+The naming scheme is what replaces the listing. One separator used everywhere keeps it readable: a colon between a prefix naming the kind of record and the identifier selecting one, as in `session:42` and `flag:new-checkout`. A key nothing can name again is also a key nothing can remove, since `delete` takes the key. For that reason, give a record with a natural lifetime an expiry when you write it, and let it leave on its own.
```javascript
export default {
diff --git a/apps/docs/src/content/docs/en/pages/store/kv-store/how-it-works.mdx b/apps/docs/src/content/docs/en/pages/store/kv-store/how-it-works.mdx
index 9f3d9f75de..3344b97d12 100644
--- a/apps/docs/src/content/docs/en/pages/store/kv-store/how-it-works.mdx
+++ b/apps/docs/src/content/docs/en/pages/store/kv-store/how-it-works.mdx
@@ -62,7 +62,7 @@ flowchart TD
Two of those steps happen once and the rest happen per request. Creating the namespace, instantiating the function, and writing the rule are done in advance; opening the client and calling a method happen every time the function runs.
-Resolving the namespace by name when the client opens keeps the function free of a binding and a credential, and it costs the caller a failure that arrives at run time. A name that matches no namespace on the account throws at `Azion.KV.open`, in the request that needed the value, rather than when the function deploys.
+Resolving the namespace by name when the client opens keeps the function free of a binding and a credential. The cost to the caller is a failure that arrives at run time. A name that matches no namespace on the account throws at `Azion.KV.open`, in the request that needed the value, rather than when the function deploys.
---
@@ -72,13 +72,13 @@ KV Store is eventually consistent. A write is applied where it arrives and is vi
What a read guarantees, therefore, is that it returns a value written to that key, not that it returns the most recent one. The window is bounded rather than open-ended, and it is not zero: a write becomes visible everywhere within 60 seconds, or within the value of `cacheTtl` when a read set one. Design for the convergence rather than for the number, because a workload that breaks on a value a minute old needs a different approach and not a shorter wait.
-A read can widen that window itself. `cacheTtl` on `get` and `getWithMetadata` caches the result for the seconds it names, so every read of that key inside that span is answered from the cached result rather than from the store, including reads made after a newer write has already landed. The number set on `cacheTtl` is the staleness the caller accepts in exchange for the read.
+A read can widen that window itself. `cacheTtl` on `get` and `getWithMetadata` caches the result for the seconds it names. Every read of that key inside that span is answered from the cached result rather than from the store. That includes reads made after a newer write has already landed. The number set on `cacheTtl` is the staleness the caller accepts in exchange for the read.
A delete converges the same way. The key stops resolving where the delete was applied, and a read answered elsewhere returns the old value until the delete reaches it.
-Concurrent writes to one key do not merge, and nothing orders them for you: the last write wins and the other value is gone. The client has no atomic increment and no compare-and-set, and no operation spans more than one key as a unit, so nothing groups several writes into one change that either lands whole or not at all. A value that several requests update at once, such as a counter or a running total, loses updates here rather than accumulating them.
+Concurrent writes to one key do not merge, and nothing orders them for you: the last write wins and the other value is gone. The client has no atomic increment and no compare-and-set, and no operation spans more than one key as a unit. As a result, nothing groups several writes into one change that either lands whole or not at all. A value that several requests update at once, such as a counter or a running total, loses updates here rather than accumulating them.
-One consequence is worth building into the code. A caller does not read a key back to confirm the write that just set it, because the write's own promise resolving is the confirmation and the read that follows it can be answered from a copy the write has not reached. A caller that treats that read as a failed write retries a write that already succeeded. Converging in the background keeps a read answerable near the request that made it, and it costs the caller the guarantee that what they read is what was last written.
+One consequence is worth building into the code. A caller does not read a key back to confirm the write that just set it. The write's own promise resolving is the confirmation, and the read that follows it can be answered from a copy the write has not reached. A caller that treats that read as a failed write retries a write that already succeeded. Converging in the background keeps a read answerable near the request that made it, and it costs the caller the guarantee that what they read is what was last written.
---
@@ -88,11 +88,11 @@ KV Store has exactly two interfaces, and they do not overlap. The Azion API v4 m
Neither reaches into the other half. The client creates no namespace: `Azion.KV.open` opens one that already exists, and a name the account does not hold throws `NotFound` rather than creating it. The API reads no key: the collection that would hold the keys of a namespace does not exist, so no API call returns a value.
-The two sides see one namespace, not two copies of it. The namespace an API call created is the namespace a function opens under the same name, and a value written from a function is in that same namespace the API lists.
+The two sides see one namespace, not two copies of it. The namespace an API call created is the namespace a function opens under the same name. A value written from a function is in that same namespace the API lists.
That split explains most of what surprises a reader here. A function cannot provision its own storage, so a namespace exists before the code that opens it deploys. A namespace cannot be removed from a function, because it cannot be removed at all. And there is no Azion Console screen, no Azion CLI command, and no Terraform resource for either half: the two interfaces above are the whole surface of the product.
-Splitting them keeps a credential out of the function, since `Azion.KV` is a runtime global reached with no token and no import line, and it costs the caller a provisioning step the code cannot take for itself.
+Splitting them keeps a credential out of the function, since `Azion.KV` is a runtime global reached with no token and no import line. The cost to the caller is a provisioning step the code cannot take for itself.
---
@@ -100,11 +100,11 @@ Splitting them keeps a credential out of the function, since `Azion.KV` is a run
KV Store is billed on three meters. Storage counts the data the account holds in KV Store. Keys Read counts every key a read returns. Keys Written counts every key a write affects, which covers a `delete` and a metadata update as well as a `put`.
-The meters count keys, not calls. A read that names an array of keys is one call and as many keys as come back from it, and a function that writes one key per request spends one write per request whatever the size of the value it stored.
+The meters count keys, not calls. A read that names an array of keys is one call and as many keys as come back from it. A function that writes one key per request spends one write per request, whatever the size of the value it stored.
Nothing in the response reports those counts. A read returns the value and a write resolves with nothing, so what a call spent is read from the account's consumption rather than from the call itself. Measuring a function against the meters therefore means watching the account, not parsing a return value.
-Metering keys rather than calls keeps the price proportional to the data an application touches, and it costs the caller the saving they might expect from batching: reading ten keys in one call counts the same ten reads that ten separate calls would. For the storage and the keys an account includes on each meter, refer to [KV Store limits](/en/documentation/platform/kv-store/limits/).
+Metering keys rather than calls keeps the price proportional to the data an application touches. The cost to the caller is the saving they might expect from batching. Reading ten keys in one call counts the same ten reads that ten separate calls would. For the storage and the keys an account includes on each meter, refer to [KV Store limits](/en/documentation/platform/kv-store/limits/).
---
diff --git a/apps/docs/src/content/docs/en/pages/store/kv-store/limits.mdx b/apps/docs/src/content/docs/en/pages/store/kv-store/limits.mdx
index d921b510e7..6648d0cc21 100644
--- a/apps/docs/src/content/docs/en/pages/store/kv-store/limits.mdx
+++ b/apps/docs/src/content/docs/en/pages/store/kv-store/limits.mdx
@@ -47,7 +47,7 @@ The bounds below apply to the data a function stores, rather than to the namespa
| Minimum `expirationTtl` | 60 seconds |
| Minimum `cacheTtl` | 60 seconds |
-The client applies none of these itself. It checks that `expirationTtl` and `expiration` are numbers and that `metadata` is a string or an object, and it passes everything else through, so a value past one of these bounds is rejected by the platform rather than by the code that sent it. For what each option does, refer to [KV client](/en/documentation/devtools/runtime/api-reference/kv-store/).
+The client applies none of these itself. It checks that `expirationTtl` and `expiration` are numbers and that `metadata` is a string or an object. It passes everything else through. A value past one of these bounds is therefore rejected by the platform rather than by the code that sent it. For what each option does, refer to [KV client](/en/documentation/devtools/runtime/api-reference/kv-store/).
---
diff --git a/apps/docs/src/content/docs/en/pages/store/kv-store/namespaces.mdx b/apps/docs/src/content/docs/en/pages/store/kv-store/namespaces.mdx
index 5b72b1710f..a9d8d2b956 100644
--- a/apps/docs/src/content/docs/en/pages/store/kv-store/namespaces.mdx
+++ b/apps/docs/src/content/docs/en/pages/store/kv-store/namespaces.mdx
@@ -31,7 +31,7 @@ A namespace name is chosen at creation and cannot be changed afterwards.
A name shorter than 3 characters, longer than 63 characters, or carrying a character outside the pattern returns `400` with `validation_error`. A name the account already holds returns `400` with the message `Namespace already exists`, and not `409`.
-The pattern accepts uppercase letters, so `Orders-EU` is as valid a name as `orders-eu`, and the two are **different namespaces**: a retrieve of one answers `200` while the same name in another case answers `404` with `namespace_not_found`. Lowercase is a convention rather than a rule, and it matters because a namespace cannot be deleted, so a name created in the wrong case is permanent. For the convention Azion recommends, refer to [Best practices](/en/documentation/platform/kv-store/best-practices/).
+The pattern accepts uppercase letters, so `Orders-EU` is as valid a name as `orders-eu`. The two are **different namespaces**: a retrieve of one answers `200`, while the same name in another case answers `404` with `namespace_not_found`. Lowercase is a convention rather than a rule, and it matters because a namespace cannot be deleted, so a name created in the wrong case is permanent. For the convention Azion recommends, refer to [Best practices](/en/documentation/platform/kv-store/best-practices/).
---
diff --git a/apps/docs/src/content/docs/en/pages/store/kv-store/troubleshooting.mdx b/apps/docs/src/content/docs/en/pages/store/kv-store/troubleshooting.mdx
index 64c44a48d5..c04c09467f 100644
--- a/apps/docs/src/content/docs/en/pages/store/kv-store/troubleshooting.mdx
+++ b/apps/docs/src/content/docs/en/pages/store/kv-store/troubleshooting.mdx
@@ -12,7 +12,20 @@ import FrameBox from '@aziontech/webkit/frame-box'
import ItemList from '@aziontech/webkit/item-list'
import DocItem from '@aziontech/webkit/doc-item'
-Every symptom below is a string [KV Store](/en/documentation/platform/kv-store/) returns: a constructor that throws, an argument `open` refuses, a namespace the runtime does not find while the Azion API lists it, a value and a return type the client rejects, a delete method that is not a function, an import that fails the build, a configuration entry that creates nothing, a duplicate name answered with `400`, a `405` on every request that would change a namespace, a `500` on a malformed body, a page size outside its range, and an error body a handler reads as empty.
+Every symptom below is a string [KV Store](/en/documentation/platform/kv-store/) returns:
+
+- A constructor that throws.
+- An argument `open` refuses.
+- A namespace the runtime does not find while the Azion API lists it.
+- A value and a return type the client rejects.
+- A delete method that is not a function.
+- An import that fails the build.
+- A configuration entry that creates nothing.
+- A duplicate name answered with `400`.
+- A `405` on every request that would change a namespace.
+- A `500` on a malformed body.
+- A page size outside its range.
+- An error body a handler reads as empty.
---
@@ -20,7 +33,7 @@ Every symptom below is a string [KV Store](/en/documentation/platform/kv-store/)
A function throws `KvError: KV constructor is private, use KV.open(name) instead` on the line that builds the client, before any key is read or written. Both `new Azion.KV()` and `new Azion.KV('my-namespace')` produce it.
-`Azion.KV` guards its constructor, and `open` is the only static member that hands back a client. The guard runs before the argument is examined, which is why the no-argument form fails the same way: there is no default namespace behind it, and the call never gets far enough to look for one. `Azion.KV.open` is also asynchronous, so a call that is not awaited hands the lines after it a promise where they expect a client, and the first method call on that promise throws something else entirely.
+`Azion.KV` guards its constructor, and `open` is the only static member that hands back a client. The guard runs before the argument is examined, so the no-argument form fails the same way. There is no default namespace behind it, and the call never gets far enough to look for one. `Azion.KV.open` is also asynchronous, so a call that is not awaited hands the lines after it a promise where they expect a client, and the first method call on that promise throws something else entirely.
- **Replace the constructor with `await Azion.KV.open(name)`**: it is the only entry point, and it is asynchronous, so the call is awaited.
- **Name a namespace on every call**: no form of `open` resolves a default, so the argument is always the name of a namespace the account holds.
@@ -49,7 +62,7 @@ export default {
- **Pass the name as a non-empty string**: `Azion.KV.open('my-namespace')`.
- **Do not pass an identifier from another product**: a namespace has no `id` field, and `name` is what addresses it. For the fields it carries, refer to [Namespaces](/en/documentation/platform/kv-store/namespaces/).
-- **Check the variable before the call**: a name built from a request or a configuration value can arrive as `undefined` or as an empty string, and either one reaches `open` as an invalid type.
+- **Check the variable before the call**: a name built from a request or a configuration value can arrive as `undefined` or as an empty string. Either one reaches `open` as an invalid type.
`open` then resolves the name against the account, and a name no namespace carries raises a `NotFound` error naming it instead.
@@ -59,12 +72,12 @@ export default {
`Azion.KV.open` rejects with `NotFound: KV namespace "my-namespace" does not exist` inside a deployed function, while `GET /v4/workspace/kv/namespaces` returns that same name in `results`. A name no namespace carries produces the identical message, so the error does not tell the two cases apart.
-`open` resolves the name against the runtime's own view of the account before it returns a client, and that view is separate from the one the management API answers from. `open` can keep refusing a namespace that the API lists, while `Azion.Storage` constructs normally on the same request and `env` and `ctx` are both empty objects. That rules out a general failure to reach the stores and rules out a missing binding. Two readings remain open and neither can be settled from the function: propagation from the management API to the runtime that has not finished, and a Preview entitlement that covers the management API without covering the runtime.
+`open` resolves the name against the runtime's own view of the account before it returns a client, and that view is separate from the one the management API answers from. `open` can keep refusing a namespace that the API lists, while `Azion.Storage` constructs normally on the same request and `env` and `ctx` are both empty objects. That rules out a general failure to reach the stores and rules out a missing binding. Two readings remain open, and neither can be settled from the function. One is propagation from the management API to the runtime that has not finished. The other is a Preview entitlement that covers the management API without covering the runtime.
- **Compare the name character for character**: names are case-sensitive, so the string `open` receives has to match the one the create request sent exactly, including its case.
- **Confirm the namespace through the Azion API**: `GET /v4/workspace/kv/namespaces/{name}` answers `200` with the namespace, or `404` with `namespace_not_found`. For the operation, refer to [Namespaces](/en/documentation/platform/kv-store/namespaces/).
- **Confirm that the account holds KV Store Preview access**: KV Store is a Preview product, and access is granted per account on request. For the channels, refer to [Technical Support](/en/documentation/support/).
-- **Report it when all three hold**: a namespace the API returns and the runtime refuses is not something the function can correct, so it goes to the technical support team with the namespace name and the time of the call.
+- **Report it when all three hold**: a namespace the API returns and the runtime refuses is not something the function can correct. It therefore goes to the technical support team with the namespace name and the time of the call.
The three checks separate a name you can fix yourself from a condition only the technical support team can clear, which is what the identical message otherwise hides.
@@ -74,9 +87,9 @@ The three checks separate a name you can fix yourself from a condition only the
`kv.put(key, value)` rejects with `INVALID_VALUE_TYPE` and writes nothing. The value is a `Map`, a `Set`, a `WeakMap`, a `WeakSet`, a `RegExp`, or a `SharedArrayBuffer`.
-`put` serializes a value it does not already hold as text or as bytes, and JSON serialization returns `{}` for every one of those six shapes. Writing one would therefore store an empty object under the key and resolve as a success, and the read that followed would return `{}` with nothing to show that the entries, the members, or the pattern had been dropped. The client refuses the value instead, so the loss surfaces at the write, on the line that caused it, rather than at a read somewhere else in the application.
+`put` serializes a value it does not already hold as text or as bytes, and JSON serialization returns `{}` for every one of those six shapes. Writing one would therefore store an empty object under the key and resolve as a success. The read that followed would return `{}`, with nothing to show that the entries, the members, or the pattern had been dropped. The client refuses the value instead, so the loss surfaces at the write, on the line that caused it, rather than at a read somewhere else in the application.
-- **Convert a `Map` or a `Set` before you store it**: a `Map` becomes an array of its entries and a `Set` becomes an array of its members, and both of those serialize to what they hold.
+- **Convert a `Map` or a `Set` before you store it**: a `Map` becomes an array of its entries. A `Set` becomes an array of its members, and both of those serialize to what they hold.
- **Store the parts of a `RegExp` rather than the object**: `source` and `flags` are strings, and the expression is rebuilt from them on read.
- **Pass an `ArrayBuffer` or a typed-array view for binary data**: `put` accepts both, and a view is written with its `byteOffset` and `byteLength` honored.
@@ -126,7 +139,7 @@ The build stops on the import line and no bundle is produced:
[Azion] [Build] › ✖ error Build failed with 1 error
```
-There is no `azion:kv` module. `Azion.KV` is a global of [Azion Runtime](/en/documentation/devtools/runtime/), present in every function with no import line and no credential, and a module specifier for it has never existed. The failure is misread often, because a neighboring specifier behaves differently: `azion:storage` resolves in the same project with the same bundler, so a function that reaches two stores fails on one import and builds the other. The `azion` library does not cover it either, because the published package exports no KV entry.
+There is no `azion:kv` module. `Azion.KV` is a global of [Azion Runtime](/en/documentation/devtools/runtime/), present in every function with no import line and no credential, and a module specifier for it has never existed. The failure is misread often, because a neighboring specifier behaves differently. The `azion:storage` specifier resolves in the same project with the same bundler. A function that reaches two stores therefore fails on one import and builds the other. The `azion` library does not cover it either, because the published package exports no KV entry.
- **Delete the import line**: `Azion.KV` is reachable without it, and nothing takes its place at the top of the file.
- **Open the client from the global**: `const kv = await Azion.KV.open('my-namespace');` inside the handler.
@@ -147,7 +160,9 @@ export default {
};
```
-The entry is accepted at every stage that could reject it and acted on at none. The key is declared in the configuration's type definitions, so an editor accepts it; the build validates it and carries it into the manifest; the deploy reads the manifest and reports success. A namespace is created by one request only, `POST /v4/workspace/kv/namespaces` on the Azion API. The silence is what makes this costly: a function deployed alongside that entry opens a namespace that was never created, and the symptom that reaches you is a `NotFound` from `Azion.KV.open` rather than anything pointing at the configuration.
+The entry is accepted at every stage that could reject it and acted on at none. The key is declared in the configuration's type definitions, so an editor accepts it. The build validates it and carries it into the manifest. The deploy reads the manifest and reports success.
+
+A namespace is created by one request only, `POST /v4/workspace/kv/namespaces` on the Azion API. The silence is what makes this costly: a function deployed alongside that entry opens a namespace that was never created. The symptom that reaches you is a `NotFound` from `Azion.KV.open`, rather than anything pointing at the configuration.
- **Create the namespace through the Azion API**: one `POST` to `/v4/workspace/kv/namespaces` carrying `name` in the body. For the request and the response it returns, refer to [Namespaces](/en/documentation/platform/kv-store/namespaces/).
- **Remove the `kv` entry from `azion.config.js`**: it creates nothing, and leaving it in place reads as though the namespace is provisioned with the function.
@@ -165,7 +180,7 @@ The namespace then exists before the first deploy, and `Azion.KV.open` receives
{"state":"error","error":{"code":"validation_error","message":"Namespace already exists","details":{"field":"name"}}}
```
-The KV service reports every rejection of the create body under one status and one code. A name shorter than 3 characters, a name longer than 63, a name carrying a character outside `^[a-zA-Z0-9_-]+$`, a missing `name`, and a name the account already holds all answer `400` with `validation_error` in `code`, and only `message` separates them. A name is unique within the account and it is permanent, so the collision is with a namespace that keeps that name from then on.
+The KV service reports every rejection of the create body under one status and one code. A name shorter than 3 characters or longer than 63 answers `400` with `validation_error` in `code`. So does a name carrying a character outside `^[a-zA-Z0-9_-]+$`, a missing `name`, or a name the account already holds. Only `message` separates them. A name is unique within the account and it is permanent, so the collision is with a namespace that keeps that name from then on.
- **Branch on `error.message` rather than on the status**: `400` with `validation_error` covers every rejection of the body, and the message names which rule was broken.
- **List what the account already holds**: `GET /v4/workspace/kv/namespaces` returns every name in `results`. For the operation, refer to [Namespaces](/en/documentation/platform/kv-store/namespaces/).
@@ -183,7 +198,7 @@ The create request then answers `201`, and the response carries `name`, `created
{"errors":[{"code":"10007","title":"Method Not Allowed","detail":"Method \"DELETE\" not allowed.","status":"405","source":{"pointer":"/data"},"meta":{"method":"DELETE"}}]}
```
-Three operations exist on the resource and none of them changes a namespace. `OPTIONS` on the collection answers `allow: GET, POST, HEAD, OPTIONS`, and `OPTIONS` on a single namespace answers `allow: GET, HEAD, OPTIONS`. There is no rename, no deactivation, no emptying, and no delete, on the Azion API or on any other interface. A namespace is therefore permanent from the moment the create request answers `201`, and the `405` is the whole answer rather than a permission to request or a header to add.
+Three operations exist on the resource and none of them changes a namespace. `OPTIONS` on the collection answers `allow: GET, POST, HEAD, OPTIONS`, and `OPTIONS` on a single namespace answers `allow: GET, HEAD, OPTIONS`. There is no rename, no deactivation, no emptying, and no delete, on the Azion API or on any other interface. A namespace is therefore permanent from the moment the create request answers `201`. The `405` is the whole answer, rather than a permission to request or a header to add.
- **Read the `allow` header before you write the client**: `OPTIONS` on either path returns the methods that exist.
- **Remove keys rather than the namespace**: `kv.delete(key)` from a function removes one key at a time. For the method, refer to [KV client](/en/documentation/devtools/runtime/api-reference/kv-store/).
@@ -202,7 +217,7 @@ The account then works with create, list, and retrieve, which is the whole surfa
{"state":"error","error":{"code":"internal_error","message":"Internal server error","details":{}}}
```
-Two ordinary client mistakes reach the service unhandled: a body that is not valid JSON, and a `name` carrying a type other than a string, such as `{"name":123}`. Both belong to the `400` family the endpoint uses for every other rejection of the body, and Azion tracks the mismatch as a service defect rather than behavior to write code against. What it means for you is that this status does not report an outage and does not justify a retry: the body is what to look at.
+Two ordinary client mistakes reach the service unhandled: a body that is not valid JSON, and a `name` carrying a type other than a string, such as `{"name":123}`. Both belong to the `400` family the endpoint uses for every other rejection of the body. Azion tracks the mismatch as a service defect rather than behavior to write code against. What it means for you is that this status does not report an outage and does not justify a retry: the body is what to look at.
- **Validate the JSON before the request is sent**: a truncated body or an unquoted key produces this status rather than a parse error naming the character.
- **Send `name` as a string**: `{"name":"my-namespace"}`, and never a number or a boolean in that field.
@@ -220,7 +235,7 @@ The create request then answers `201` with the namespace, or `400` with a `valid
{"state":"error","error":{"code":"invalid_page_size","message":"Page size must be between 1 and 100","details":{}}}
```
-`page_size` accepts 1 to 100 and defaults to 50. A request above the ceiling is refused rather than trimmed to it, so a client that asks for every namespace in one response receives nothing instead of the first hundred. The list pages instead, and KV Store's envelope is not the one the rest of the Azion API v4 uses: the namespaces sit in `results`, and the paging fields sit under a `pagination` object carrying `page`, `page_size`, `total_count`, `total_pages`, `has_next`, and `has_previous`.
+`page_size` accepts 1 to 100 and defaults to 50. A request above the ceiling is refused rather than trimmed to it, so a client that asks for every namespace in one response receives nothing instead of the first hundred. The list returns pages instead. KV Store's envelope is not the one the rest of the Azion API v4 uses. The namespaces sit in `results`, and the paging fields sit under a `pagination` object. That object carries `page`, `page_size`, `total_count`, `total_pages`, `has_next`, and `has_previous`.
- **Keep `page_size` between 1 and 100**: 50 is what the endpoint uses when the parameter is absent.
- **Walk the pages with `has_next`**: send `page` once per page until `has_next` reads `false`.
diff --git a/apps/docs/src/content/docs/pt-br/pages/devtools/azion-edge-runtime/api-reference/ai/ai.mdx b/apps/docs/src/content/docs/pt-br/pages/devtools/azion-edge-runtime/api-reference/ai/ai.mdx
index 5bce1b997b..c280fc8d45 100644
--- a/apps/docs/src/content/docs/pt-br/pages/devtools/azion-edge-runtime/api-reference/ai/ai.mdx
+++ b/apps/docs/src/content/docs/pt-br/pages/devtools/azion-edge-runtime/api-reference/ai/ai.mdx
@@ -52,7 +52,7 @@ return modelResponse
## Valor de retorno
-O valor resolvido é o objeto que o modelo retorna: um objeto `chat.completion` de um modelo de chat, uma `list` de embeddings de um modelo de embedding e os resultados ranqueados de um modelo de reranking. O texto gerado por um modelo de chat fica em `modelResponse?.choices?.[0]?.message?.content`, que é o conteúdo da primeira entrada de `choices`. Todos os campos das três formas estão listados em [Invocação de modelos](/pt-br/documentacao/plataforma/ai-inference/invocacao-de-modelos/#campos-da-resposta).
+O valor resolvido é o objeto que o modelo retorna. Um modelo de chat retorna um objeto `chat.completion`, um modelo de embedding retorna uma `list` de embeddings e um modelo de reranking retorna os resultados ranqueados. O texto gerado por um modelo de chat fica em `modelResponse?.choices?.[0]?.message?.content`, que é o conteúdo da primeira entrada de `choices`. Todos os campos das três formas estão listados em [Invocação de modelos](/pt-br/documentacao/plataforma/ai-inference/invocacao-de-modelos/#campos-da-resposta).
---
diff --git a/apps/docs/src/content/docs/pt-br/pages/devtools/azion-edge-runtime/api-reference/kv-store/kv-store.mdx b/apps/docs/src/content/docs/pt-br/pages/devtools/azion-edge-runtime/api-reference/kv-store/kv-store.mdx
index f8b5401061..a73c7e81a7 100644
--- a/apps/docs/src/content/docs/pt-br/pages/devtools/azion-edge-runtime/api-reference/kv-store/kv-store.mdx
+++ b/apps/docs/src/content/docs/pt-br/pages/devtools/azion-edge-runtime/api-reference/kv-store/kv-store.mdx
@@ -271,7 +271,7 @@ O terceiro argumento de `get` e `getWithMetadata` é um objeto, e ele carrega um
| --- | --- | --- |
| `cacheTtl` | número | Mantém o resultado da leitura em cache por essa quantidade de segundos, de modo que uma leitura posterior da mesma key é servida pelo cache |
-Por exemplo, um objeto de configuração que toda requisição lê e um deploy reescreve uma vez por dia é lido com `cacheTtl` em 300, então leituras repetidas dentro de cinco minutos vêm do cache, e não do store.
+Por exemplo, toda requisição lê um objeto de configuração, e um deploy o reescreve uma vez por dia. Quando a function lê esse objeto com `cacheTtl` em 300, leituras repetidas dentro de cinco minutos vêm do cache, e não do store.
Este handler lê uma key de configuração com o resultado em cache:
diff --git a/apps/docs/src/content/docs/pt-br/pages/devtools/azion-edge-runtime/api-reference/metadata/metadata.mdx b/apps/docs/src/content/docs/pt-br/pages/devtools/azion-edge-runtime/api-reference/metadata/metadata.mdx
index 779d08094c..c4de6824d4 100644
--- a/apps/docs/src/content/docs/pt-br/pages/devtools/azion-edge-runtime/api-reference/metadata/metadata.mdx
+++ b/apps/docs/src/content/docs/pt-br/pages/devtools/azion-edge-runtime/api-reference/metadata/metadata.mdx
@@ -14,7 +14,7 @@ import FrameBox from '@aziontech/webkit/frame-box'
import ItemList from '@aziontech/webkit/item-list'
import DocItem from '@aziontech/webkit/doc-item'
-A API de metadados do Azion Runtime fornece a uma function um conjunto de valores sobre cada requisição: a localização GeoIP do cliente, o endereço e a porta dele, o protocolo, a sessão TLS, fingerprints e identificadores. Functions executadas em uma Application ou em um Firewall podem lê-la. Use-a para filtrar e gerenciar o acesso à sua aplicação ou para aplicar uma lógica diferente para cada cenário.
+A API de metadados do Azion Runtime fornece a uma function um conjunto de valores sobre cada requisição. Esses valores cobrem a localização GeoIP do cliente, o endereço e a porta dele, o protocolo, a sessão TLS, fingerprints e identificadores. Functions executadas em uma Application ou em um Firewall podem lê-la. Use-a para filtrar e gerenciar o acesso à sua aplicação ou para aplicar uma lógica diferente para cada cenário.
:::note[nota]
Com `azion dev`, o objeto de metadados é `undefined`. Teste a leitura dos metadados em uma function com deploy feito.
diff --git a/apps/docs/src/content/docs/pt-br/pages/devtools/azion-edge-runtime/api-reference/object-storage/object-storage.mdx b/apps/docs/src/content/docs/pt-br/pages/devtools/azion-edge-runtime/api-reference/object-storage/object-storage.mdx
index f027f8ecfa..2eeeacada3 100644
--- a/apps/docs/src/content/docs/pt-br/pages/devtools/azion-edge-runtime/api-reference/object-storage/object-storage.mdx
+++ b/apps/docs/src/content/docs/pt-br/pages/devtools/azion-edge-runtime/api-reference/object-storage/object-storage.mdx
@@ -15,7 +15,7 @@ import DocItem from '@aziontech/webkit/doc-item'
A Object Storage API do Azion Runtime dá a uma function de [Functions](/pt-br/documentacao/plataforma/functions/) acesso de leitura e escrita aos objetos de um bucket do [Object Storage](/pt-br/documentacao/plataforma/object-storage/). A function importa a classe `Storage` do módulo `azion:storage`, informa um bucket e chama `put`, `get`, `delete` e `list` nele. Nenhum token é usado: o construtor recebe o nome do bucket e nada mais.
:::note[nota]
-Com `azion dev`, o módulo guarda os objetos no disco local e se comporta de outra forma: `put` sem um objeto `options` falha com `TypeError: Cannot read properties of undefined (reading 'content-length')`, um número em `metadata` é aceito, uma key ausente lança `ENOENT` em vez de `StorageError: Object not found`, e `list` retorna as keys sem a barra inicial e sem `content_length`. Teste as chamadas de storage em uma function após o deploy.
+Com `azion dev`, o módulo guarda os objetos no disco local e se comporta de outra forma. Sem um objeto `options`, `put` falha com `TypeError: Cannot read properties of undefined (reading 'content-length')`. O módulo aceita um número em `metadata`. Uma key ausente lança `ENOENT` em vez de `StorageError: Object not found`. O método `list` retorna as keys sem a barra inicial e sem `content_length`. Teste as chamadas de storage em uma function após o deploy.
:::
---
diff --git a/apps/docs/src/content/docs/pt-br/pages/devtools/azion-edge-runtime/how-it-works.mdx b/apps/docs/src/content/docs/pt-br/pages/devtools/azion-edge-runtime/how-it-works.mdx
index 7085e7b6c8..65a66a6146 100644
--- a/apps/docs/src/content/docs/pt-br/pages/devtools/azion-edge-runtime/how-it-works.mdx
+++ b/apps/docs/src/content/docs/pt-br/pages/devtools/azion-edge-runtime/how-it-works.mdx
@@ -13,7 +13,7 @@ Um runtime JavaScript serverless executa o seu código uma vez por requisição,
O Azion Runtime é esse ambiente para [Functions](/pt-br/documentacao/plataforma/functions/). Ele executa JavaScript construído sobre padrões Web, chama o handler que a sua function exporta e entrega ao handler as APIs da plataforma. O seu projeto chega a ele por meio do Azion Bundler, que faz o build do código e resolve as APIs do Node.js com polyfills em tempo de build.
-As seções cobrem o modelo de execução, o ciclo de vida da requisição, os formatos de handler, o bundler e os polyfills, o strict mode, o tempo dentro de uma requisição, as variáveis de ambiente e os secrets e como `azion dev` difere de uma function com deploy feito. O que decide quando uma function roda, a regra e a instância de function, está em [Como Functions funciona](/pt-br/documentacao/plataforma/functions/como-funciona/).
+As seções cobrem o modelo de execução, o ciclo de vida da requisição, os formatos de handler, o bundler e os polyfills e o strict mode. Em seguida, cobrem o tempo dentro de uma requisição, as variáveis de ambiente e os secrets e como `azion dev` difere de uma function com deploy feito. O que decide quando uma function roda, a regra e a instância de function, está em [Como Functions funciona](/pt-br/documentacao/plataforma/functions/como-funciona/).
---
@@ -123,7 +123,7 @@ O strict mode altera a semântica normal do JavaScript de três formas:
- Remove enganos que impedem os motores JavaScript de otimizar o código, então o código em strict mode às vezes roda mais rápido que o mesmo código fora do strict mode.
- Proíbe parte da sintaxe que versões posteriores do ECMAScript provavelmente vão definir.
-A primeira mudança tem um custo para o código escrito sem strict mode. Um engano que o JavaScript fora do strict mode ignora lança um erro em uma function, e o erro aparece na requisição, então uma biblioteca mais antiga que depende de falhas silenciosas precisa de um teste antes que você faça o deploy dela.
+A primeira mudança tem um custo para o código escrito sem strict mode. Um engano que o JavaScript fora do strict mode ignora lança um erro em uma function, e o erro aparece na requisição. Como resultado, uma biblioteca mais antiga que depende de falhas silenciosas precisa de um teste antes que você faça o deploy dela.
---
diff --git a/apps/docs/src/content/docs/pt-br/pages/devtools/azion-edge-runtime/javascript-examples/hello-world/index.mdx b/apps/docs/src/content/docs/pt-br/pages/devtools/azion-edge-runtime/javascript-examples/hello-world/index.mdx
index c5ab814b3e..9b283f9971 100644
--- a/apps/docs/src/content/docs/pt-br/pages/devtools/azion-edge-runtime/javascript-examples/hello-world/index.mdx
+++ b/apps/docs/src/content/docs/pt-br/pages/devtools/azion-edge-runtime/javascript-examples/hello-world/index.mdx
@@ -12,7 +12,7 @@ import FrameBox from '@aziontech/webkit/frame-box'
import ItemList from '@aziontech/webkit/item-list'
import DocItem from '@aziontech/webkit/doc-item'
-Retorne uma string fixa diretamente de uma função, sem contatar um servidor de origem. Esta é a forma mais simples do padrão que toda função segue, o que a torna uma verificação útil de que a função está publicada e atendendo ao tráfego antes de você adicionar lógica a ela.
+Retorne uma string fixa diretamente de uma função, sem contatar um servidor de origem. Esta é a forma mais simples do padrão que toda função segue. Isso a torna uma verificação útil de que a função está publicada e atendendo ao tráfego antes de você adicionar lógica a ela.
```js
async function handleRequest(request) {
diff --git a/apps/docs/src/content/docs/pt-br/pages/devtools/azion-edge-runtime/javascript-examples/index.mdx b/apps/docs/src/content/docs/pt-br/pages/devtools/azion-edge-runtime/javascript-examples/index.mdx
index 118ed39fce..999a074a59 100644
--- a/apps/docs/src/content/docs/pt-br/pages/devtools/azion-edge-runtime/javascript-examples/index.mdx
+++ b/apps/docs/src/content/docs/pt-br/pages/devtools/azion-edge-runtime/javascript-examples/index.mdx
@@ -14,7 +14,7 @@ import DocItem from '@aziontech/webkit/doc-item'
Copie qualquer um destes trechos de JavaScript para uma função como ponto de partida para o seu próprio código. Os exemplos cobrem os padrões para os quais as funções são mais usadas: retornar uma resposta ou um conteúdo JSON, redirecionar tráfego, ler cookies, executar um teste A/B e negar uma requisição por país. Eles são agrupados por onde a função é executada: Applications, para funções que tratam o evento `fetch` em uma aplicação, e Firewall, para funções que tratam o evento `firewall` em um firewall.
-A maior parte dos handlers desta coleção é escrita no padrão Service Worker, que registra o handler com `addEventListener`. Código novo usa ES Modules, e [Processe o corpo de uma requisição](/pt-br/documentacao/plataforma/functions/process-request-body/) está escrito assim: consulte [Boas práticas](/pt-br/documentacao/plataforma/functions/boas-praticas/) para o padrão atual e [Migre padrões de handler em Functions](/pt-br/documentacao/guias/desenvolvimento-de-aplicacoes/functions-e-runtime/migrar-padroes-de-handler/) para o antes e depois de cada handler.
+A maior parte dos handlers desta coleção é escrita no padrão Service Worker, que registra o handler com `addEventListener`. Código novo usa ES Modules, e [Processe o corpo de uma requisição](/pt-br/documentacao/plataforma/functions/process-request-body/) está escrito assim. Consulte [Boas práticas](/pt-br/documentacao/plataforma/functions/boas-praticas/) para o padrão atual e [Migre padrões de handler em Functions](/pt-br/documentacao/guias/desenvolvimento-de-aplicacoes/functions-e-runtime/migrar-padroes-de-handler/) para o antes e depois de cada handler.
---
diff --git a/apps/docs/src/content/docs/pt-br/pages/devtools/azion-edge-runtime/javascript-examples/process-request-body/index.mdx b/apps/docs/src/content/docs/pt-br/pages/devtools/azion-edge-runtime/javascript-examples/process-request-body/index.mdx
index 23d9cae2e4..fcac649baa 100644
--- a/apps/docs/src/content/docs/pt-br/pages/devtools/azion-edge-runtime/javascript-examples/process-request-body/index.mdx
+++ b/apps/docs/src/content/docs/pt-br/pages/devtools/azion-edge-runtime/javascript-examples/process-request-body/index.mdx
@@ -105,7 +105,7 @@ Quando há corpo, o handler lê o header `Content-Type` e direciona para um mét
| `application/octet-stream` | `request.blob()` | Lê o corpo como binário e retorna seu texto |
| Qualquer outro | `request.body.getReader()` | Lê o stream bloco a bloco, decodificando cada bloco como UTF-8 |
-O branch de stream é o fallback, então um content type não reconhecido ainda é lido em vez de descartado. Ele também é o branch a usar quando o corpo é grande o bastante para que manter todo o payload em memória importe: o reader entrega um bloco por vez, e o loop termina quando `done` é verdadeiro.
+O branch de stream é o fallback, então um content type não reconhecido ainda é lido em vez de descartado. Ele também é o branch a usar quando o corpo é grande o bastante para que manter todo o payload em memória importe. O reader entrega um bloco por vez, e o loop termina quando `done` é verdadeiro.
Um corpo só pode ser lido uma vez. Chamar dois métodos de parse na mesma requisição lança um erro, e por isso o handler escolhe exatamente um branch e o retorna.
diff --git a/apps/docs/src/content/docs/pt-br/pages/devtools/azion-edge-runtime/javascript-examples/rest-apis/index.mdx b/apps/docs/src/content/docs/pt-br/pages/devtools/azion-edge-runtime/javascript-examples/rest-apis/index.mdx
index ff5b870d66..ca89f79a73 100644
--- a/apps/docs/src/content/docs/pt-br/pages/devtools/azion-edge-runtime/javascript-examples/rest-apis/index.mdx
+++ b/apps/docs/src/content/docs/pt-br/pages/devtools/azion-edge-runtime/javascript-examples/rest-apis/index.mdx
@@ -152,7 +152,9 @@ export default {
## Como funciona
-Cada exemplo é uma função completa no padrão ES Modules. O handler `fetch` chama `fetch()` com a URL da API e um objeto de opções: `method` seleciona o verbo HTTP, `headers` leva o `Content-Type` e o token de autorização, e `body` leva a string JSON que `JSON.stringify()` produz. O token vem da [variável de ambiente](/pt-br/documentacao/devtools/runtime/api-reference/environment-variables/) `API_TOKEN` por meio de `Azion.env.get()`, então ele fica fora do código. `await fetch()` resolve em um `Response`. O exemplo de GET o lê com `response.json()`, e os outros exemplos retornam ao cliente o status e o corpo da resposta da API. Substitua `https://api.example.com/items` e os valores de exemplo pelos da sua API.
+Cada exemplo é uma função completa no padrão ES Modules. O handler `fetch` chama `fetch()` com a URL da API e um objeto de opções. Nesse objeto, `method` seleciona o verbo HTTP, e `headers` leva o `Content-Type` e o token de autorização. O campo `body` leva a string JSON que `JSON.stringify()` produz.
+
+O token vem da [variável de ambiente](/pt-br/documentacao/devtools/runtime/api-reference/environment-variables/) `API_TOKEN` por meio de `Azion.env.get()`, então ele fica fora do código. `await fetch()` resolve em um `Response`. O exemplo de GET o lê com `response.json()`, e os outros exemplos retornam ao cliente o status e o corpo da resposta da API. Substitua `https://api.example.com/items` e os valores de exemplo pelos da sua API.
## Recursos relacionados
diff --git a/apps/docs/src/content/docs/pt-br/pages/devtools/azion-edge-runtime/javascript-examples/return-html/index.mdx b/apps/docs/src/content/docs/pt-br/pages/devtools/azion-edge-runtime/javascript-examples/return-html/index.mdx
index 1d9200aee9..866f4deb9c 100644
--- a/apps/docs/src/content/docs/pt-br/pages/devtools/azion-edge-runtime/javascript-examples/return-html/index.mdx
+++ b/apps/docs/src/content/docs/pt-br/pages/devtools/azion-edge-runtime/javascript-examples/return-html/index.mdx
@@ -36,7 +36,7 @@ Gere uma página HTML completa a partir de uma string e retorne-a diretamente de
## Como funciona
-A marcação é armazenada em um template literal atribuído à constante `html`, de modo que toda a página fica dentro da função. Quando o evento `fetch` é disparado, `handleRequest` constrói um novo `Response` com essa string como corpo e define o header `content-type` como `text/html;charset=UTF-8`, o que faz o navegador renderizar o conteúdo como página web em vez de texto puro. Em seguida, `event.respondWith()` retorna a página ao cliente, sem nenhuma requisição a uma origem.
+A marcação é armazenada em um template literal atribuído à constante `html`, de modo que toda a página fica dentro da função. Quando o evento `fetch` é disparado, `handleRequest` constrói um novo `Response` com essa string como corpo. Ele também define o header `content-type` como `text/html;charset=UTF-8`. Esse header faz o navegador renderizar o conteúdo como página web em vez de texto puro. Em seguida, `event.respondWith()` retorna a página ao cliente, sem nenhuma requisição a uma origem.
O header `content-type` é o ponto que mais importa aqui. Sem ele, o navegador não recebe instrução para renderizar o corpo como uma página, então mantenha-o definido sempre que uma função retornar HTML.
diff --git a/apps/docs/src/content/docs/pt-br/pages/devtools/azion-edge-runtime/javascript-examples/return-json/index.mdx b/apps/docs/src/content/docs/pt-br/pages/devtools/azion-edge-runtime/javascript-examples/return-json/index.mdx
index db3fa0a62c..ea9f668824 100644
--- a/apps/docs/src/content/docs/pt-br/pages/devtools/azion-edge-runtime/javascript-examples/return-json/index.mdx
+++ b/apps/docs/src/content/docs/pt-br/pages/devtools/azion-edge-runtime/javascript-examples/return-json/index.mdx
@@ -12,7 +12,7 @@ import FrameBox from '@aziontech/webkit/frame-box'
import ItemList from '@aziontech/webkit/item-list'
import DocItem from '@aziontech/webkit/doc-item'
-Retorne um conteúdo JSON diretamente de uma função, sem encaminhar a requisição a uma origem. Use esse padrão para APIs leves e middlewares, como mocks de API, feature flags, endpoints de configuração e health checks, em que a resposta é um dado estruturado e nenhum serviço de backend precisa ser envolvido.
+Retorne um conteúdo JSON diretamente de uma função, sem encaminhar a requisição a uma origem. Use esse padrão para APIs leves e middlewares, como mocks de API, feature flags, endpoints de configuração e health checks. Nesses casos, a resposta é um dado estruturado e nenhum serviço de backend precisa ser envolvido.
```js
addEventListener("fetch", event => {
@@ -36,9 +36,9 @@ Retorne um conteúdo JSON diretamente de uma função, sem encaminhar a requisi
Quando o evento `fetch` é disparado, o handler define um objeto JavaScript simples e o serializa com `JSON.stringify(data, null, 2)`, em que o `2` adiciona indentação para tornar a saída mais legível. Em seguida, cria um novo `Response` com essa string como corpo e define o header `content-type` como `application/json;charset=UTF-8`, o que indica ao cliente que o conteúdo é JSON. Por fim, `event.respondWith()` retorna a resposta, sem nenhuma requisição a uma origem.
-O mesmo formato cobre respostas mais completas. Defina um código de status ou adicione headers de CORS e de cache-control no segundo argumento de `Response`, e monte o objeto a partir de dados da requisição, como parâmetros de query string, cookies ou headers, em vez de fixá-los no código.
+O mesmo formato cobre respostas mais completas. Defina um código de status ou adicione headers de CORS e de cache-control no segundo argumento de `Response`. Monte o objeto a partir de dados da requisição, como parâmetros de query string, cookies ou headers, em vez de fixá-los no código.
-O objeto também pode ser montado a partir de dados que a função busca. Um handler que chama `fetch()` para cada uma de várias URLs, faz o parse de cada resposta com `response.json()` e aguarda todas juntas com `Promise.all()` retorna um único corpo JSON montado a partir de todas elas. Para um exemplo pronto, consulte [Exemplo: Handlers de eventos assíncronos](/pt-br/documentacao/devtools/runtime/node/events/#handlers-de-eventos-assincronos).
+O objeto também pode ser montado a partir de dados que a função busca. Nesse caso, o handler chama `fetch()` para cada uma de várias URLs e faz o parse de cada resposta com `response.json()`. Ele aguarda todas juntas com `Promise.all()` e retorna um único corpo JSON montado a partir de todas elas. Para um exemplo pronto, consulte [Exemplo: Handlers de eventos assíncronos](/pt-br/documentacao/devtools/runtime/node/events/#handlers-de-eventos-assincronos).
## Recursos relacionados
diff --git a/apps/docs/src/content/docs/pt-br/pages/devtools/azion-edge-runtime/javascript-examples/usar-args/index.mdx b/apps/docs/src/content/docs/pt-br/pages/devtools/azion-edge-runtime/javascript-examples/usar-args/index.mdx
index 1206278a21..fd3f004c09 100644
--- a/apps/docs/src/content/docs/pt-br/pages/devtools/azion-edge-runtime/javascript-examples/usar-args/index.mdx
+++ b/apps/docs/src/content/docs/pt-br/pages/devtools/azion-edge-runtime/javascript-examples/usar-args/index.mdx
@@ -42,7 +42,7 @@ Os Args definidos na instância de função que executa este código:
O handler do evento `fetch` lê `event.args.value` e o passa para `handleRequest`, que retorna esse valor no corpo de um novo `Response`, junto com um header personalizado definido por `new Headers([...])` e um `status: 200` explícito. A chave `value` vem do objeto JSON acima, então alterar esse objeto altera o que a função retorna.
-Os Args não fazem parte do código. Você os define na [instância de função](/pt-br/documentacao/plataforma/applications/functions-instances/) que vincula a função a uma aplicação ou a um firewall, e é por isso que a mesma função pode se comportar de forma diferente em cada instância sem ser editada nem passar por um novo deploy. [Como funciona](/pt-br/documentacao/plataforma/functions/como-funciona/) cobre o restante da cadeia, da função à instância e à regra do Rules Engine que a executa.
+Os Args não fazem parte do código. Você os define na [instância de função](/pt-br/documentacao/plataforma/applications/functions-instances/) que vincula a função a uma aplicação ou a um firewall. É por isso que a mesma função pode se comportar de forma diferente em cada instância sem ser editada nem passar por um novo deploy. [Como funciona](/pt-br/documentacao/plataforma/functions/como-funciona/) cobre o restante da cadeia, da função à instância e à regra do Rules Engine que a executa.
## Recursos relacionados
diff --git a/apps/docs/src/content/docs/pt-br/pages/devtools/cli/azion-cli/comandos/config/config.mdx b/apps/docs/src/content/docs/pt-br/pages/devtools/cli/azion-cli/comandos/config/config.mdx
index e17ac08765..e837ec61bf 100644
--- a/apps/docs/src/content/docs/pt-br/pages/devtools/cli/azion-cli/comandos/config/config.mdx
+++ b/apps/docs/src/content/docs/pt-br/pages/devtools/cli/azion-cli/comandos/config/config.mdx
@@ -10,7 +10,7 @@ import FrameBox from '@aziontech/webkit/frame-box'
import ItemList from '@aziontech/webkit/item-list'
import DocItem from '@aziontech/webkit/doc-item'
-Os comandos `config` da Azion CLI gerenciam recursos da Azion a partir de arquivos de manifesto: `init` cria um arquivo `azion.json` vazio, `apply` cria ou atualiza os recursos que um arquivo [azion.config](/pt-br/documentacao/devtools/cli/azion-config-js/) declara, e `delete` exclui os recursos que o `azion.json` lista. As opções que todo comando aceita, como `--format`, `--out` e `-y`, estão em [Opções globais da Azion CLI](/pt-br/documentacao/devtools/cli/globals/).
+Os comandos `config` da Azion CLI gerenciam recursos da Azion a partir de arquivos de manifesto. O comando `init` cria um arquivo `azion.json` vazio. O comando `apply` cria ou atualiza os recursos que um arquivo [azion.config](/pt-br/documentacao/devtools/cli/azion-config-js/) declara. O comando `delete` exclui os recursos que o `azion.json` lista. As opções que todo comando aceita, como `--format`, `--out` e `-y`, estão em [Opções globais da Azion CLI](/pt-br/documentacao/devtools/cli/globals/).
---
diff --git a/apps/docs/src/content/docs/pt-br/pages/devtools/cli/azion-cli/comandos/dev-command/dev.mdx b/apps/docs/src/content/docs/pt-br/pages/devtools/cli/azion-cli/comandos/dev-command/dev.mdx
index a29c103bac..3af37f9505 100644
--- a/apps/docs/src/content/docs/pt-br/pages/devtools/cli/azion-cli/comandos/dev-command/dev.mdx
+++ b/apps/docs/src/content/docs/pt-br/pages/devtools/cli/azion-cli/comandos/dev-command/dev.mdx
@@ -10,7 +10,7 @@ import FrameBox from '@aziontech/webkit/frame-box'
import ItemList from '@aziontech/webkit/item-list'
import DocItem from '@aziontech/webkit/doc-item'
-O comando `dev` da Azion CLI faz o build do projeto no diretório atual e inicia um servidor de desenvolvimento local, para que você teste uma aplicação ou uma function na sua máquina antes de fazer o deploy. Execute-o na pasta raiz de um projeto que o [Azion CLI init](/pt-br/documentacao/devtools/cli/init/) criou ou que o [Azion CLI link](/pt-br/documentacao/devtools/cli/link-comando/) configurou. Para um projeto existente que não está configurado para a Azion, execute `azion link` antes. As opções que todo comando aceita, como `--debug`, `--format` e `-y`, estão em [Opções globais](/pt-br/documentacao/devtools/cli/globals/).
+O comando `dev` da Azion CLI faz o build do projeto no diretório atual e inicia um servidor de desenvolvimento local. Com esse servidor, você pode testar uma aplicação ou uma function na sua máquina antes de fazer o deploy. Execute-o na pasta raiz de um projeto que o [Azion CLI init](/pt-br/documentacao/devtools/cli/init/) criou ou que o [Azion CLI link](/pt-br/documentacao/devtools/cli/link-comando/) configurou. Para um projeto existente que não está configurado para a Azion, execute `azion link` antes. As opções que todo comando aceita, como `--debug`, `--format` e `-y`, estão em [Opções globais](/pt-br/documentacao/devtools/cli/globals/).
---
diff --git a/apps/docs/src/content/docs/pt-br/pages/devtools/cli/azion-cli/comandos/globals/globals.mdx b/apps/docs/src/content/docs/pt-br/pages/devtools/cli/azion-cli/comandos/globals/globals.mdx
index d4bc6dc9d4..139ab4393b 100644
--- a/apps/docs/src/content/docs/pt-br/pages/devtools/cli/azion-cli/comandos/globals/globals.mdx
+++ b/apps/docs/src/content/docs/pt-br/pages/devtools/cli/azion-cli/comandos/globals/globals.mdx
@@ -10,7 +10,7 @@ import FrameBox from '@aziontech/webkit/frame-box'
import ItemList from '@aziontech/webkit/item-list'
import DocItem from '@aziontech/webkit/doc-item'
-As opções globais são as flags que os comandos da [Azion CLI](/pt-br/documentacao/devtools/cli/) compartilham. Elas vêm depois do comando e do seu subcomando, como em `azion list application --debug`, e definem a pasta de configuração, o token, o nível de log, o tempo limite das requisições, o formato da saída e as respostas às perguntas sim/não.
+As opções globais são as flags que os comandos da [Azion CLI](/pt-br/documentacao/devtools/cli/) compartilham. Elas vêm depois do comando e do seu subcomando, como em `azion list application --debug`. Elas definem a pasta de configuração, o token, o nível de log, o tempo limite das requisições, o formato da saída e as respostas às perguntas sim/não.
---
diff --git a/apps/docs/src/content/docs/pt-br/pages/devtools/cli/resources/csr.mdx b/apps/docs/src/content/docs/pt-br/pages/devtools/cli/resources/csr.mdx
index 5f2bae91d4..88ac9fd28a 100644
--- a/apps/docs/src/content/docs/pt-br/pages/devtools/cli/resources/csr.mdx
+++ b/apps/docs/src/content/docs/pt-br/pages/devtools/cli/resources/csr.mdx
@@ -37,7 +37,7 @@ azion create csr [flags]
| `--organization-unity` | — | string | — | Unidade organizacional do subject do certificado. |
| `--state` | — | string | — | Estado ou província do subject do certificado. |
-Um valor de `--key-algorithm` fora dos três listados é recusado com `"rsa_1024" is not a valid choice.`, e um `--name` que um certificado da sua conta já usa é recusado com `This field must be unique.` Cada nome em `--common-name` e `--alternative-names` precisa pertencer a um domínio para o qual a sua conta tem permissão. Os limites de cada campo estão em [Certificados](/pt-br/documentacao/plataforma/workloads/certificate-manager/certificados/).
+Um valor de `--key-algorithm` fora dos três listados é recusado com `"rsa_1024" is not a valid choice.` Um `--name` que um certificado da sua conta já usa é recusado com `This field must be unique.` Cada nome em `--common-name` e `--alternative-names` precisa pertencer a um domínio para o qual a sua conta tem permissão. Os limites de cada campo estão em [Certificados](/pt-br/documentacao/plataforma/workloads/certificate-manager/certificados/).
Este comando cria uma CSR chamada `my-csr` para `example.com` e `www.example.com`, com uma chave RSA de 2048 bits:
diff --git a/apps/docs/src/content/docs/pt-br/pages/menu-principal/referencia/ai-inference/ai-models/qwen-2-5-vl-3b.mdx b/apps/docs/src/content/docs/pt-br/pages/menu-principal/referencia/ai-inference/ai-models/qwen-2-5-vl-3b.mdx
index 56e5df45b6..c6c6a081b7 100644
--- a/apps/docs/src/content/docs/pt-br/pages/menu-principal/referencia/ai-inference/ai-models/qwen-2-5-vl-3b.mdx
+++ b/apps/docs/src/content/docs/pt-br/pages/menu-principal/referencia/ai-inference/ai-models/qwen-2-5-vl-3b.mdx
@@ -94,7 +94,7 @@ Uma entrada chega em `choices`, e o texto que o modelo gerou fica em `choices[0]
### Chamada de ferramentas
-Um array `tools` declara as funções que o modelo pode chamar. Cada entrada define `type` como `function` e carrega um objeto `function` com três campos: o `name` que o modelo retorna, uma `description` do que a função faz e os `parameters` que ela aceita, escritos como um objeto JSON Schema:
+Um array `tools` declara as funções que o modelo pode chamar. Cada entrada define `type` como `function` e carrega um objeto `function`. Esse objeto tem três campos: o `name` que o modelo retorna, uma `description` do que a função faz e os `parameters` que ela aceita, escritos como um objeto JSON Schema:
```ts
const modelResponse = await Azion.AI.run("qwen-qwen25-vl-3b-instruct-awq", {
diff --git a/apps/docs/src/content/docs/pt-br/pages/menu-principal/referencia/ai-inference/edge-ai-reference.mdx b/apps/docs/src/content/docs/pt-br/pages/menu-principal/referencia/ai-inference/edge-ai-reference.mdx
index 99247e1a38..35b389d1f7 100644
--- a/apps/docs/src/content/docs/pt-br/pages/menu-principal/referencia/ai-inference/edge-ai-reference.mdx
+++ b/apps/docs/src/content/docs/pt-br/pages/menu-principal/referencia/ai-inference/edge-ai-reference.mdx
@@ -13,7 +13,7 @@ import DocCard from '@aziontech/webkit/doc-card'
Inferência é o ato de executar um modelo de AI treinado. Você envia uma entrada e o modelo retorna uma saída calculada a partir dos pesos que ele aprendeu no treinamento: um texto gerado, um ranking ou um vetor de números que representa a entrada. Um modelo não responde nada enquanto esses pesos não estiverem carregados em memória, em hardware dimensionado para eles. Um serviço de inferência assume essa parte, mantendo os modelos carregados e colocando cada um atrás de uma requisição.
-**AI Inference** executa os modelos na infraestrutura distribuída da Azion, no [Azion Runtime](/pt-br/documentacao/devtools/runtime/). Um modelo não é um objeto que você cria. Você nomeia um modelo pelo id dele dentro de uma [função](/pt-br/documentacao/plataforma/functions/), e essa chamada é o que o invoca. Use AI Inference para gerar texto a partir de um prompt, ler o texto de uma imagem, transformar um documento em um vetor para recuperação ou ranquear um conjunto de documentos em relação a uma consulta.
+**AI Inference** executa os modelos na infraestrutura distribuída da Azion, no [Azion Runtime](/pt-br/documentacao/devtools/runtime/). Um modelo não é um objeto que você cria. Você nomeia um modelo pelo id dele dentro de uma [função](/pt-br/documentacao/plataforma/functions/), e essa chamada é o que o invoca. Use AI Inference para gerar texto a partir de um prompt ou para ler o texto de uma imagem. Você também pode usá-lo para transformar um documento em um vetor para recuperação ou para ranquear um conjunto de documentos em relação a uma consulta.
diff --git a/apps/docs/src/content/docs/pt-br/pages/menu-principal/referencia/ai-inference/invocacao-de-modelos.mdx b/apps/docs/src/content/docs/pt-br/pages/menu-principal/referencia/ai-inference/invocacao-de-modelos.mdx
index bbea4bc643..be769b35c2 100644
--- a/apps/docs/src/content/docs/pt-br/pages/menu-principal/referencia/ai-inference/invocacao-de-modelos.mdx
+++ b/apps/docs/src/content/docs/pt-br/pages/menu-principal/referencia/ai-inference/invocacao-de-modelos.mdx
@@ -42,7 +42,7 @@ Azion não emite nenhuma credencial para uma chamada de modelo, e o endpoint nã
## Campos da requisição
-Estes campos formam o corpo de uma requisição a um modelo de chat, seja pelo binding, seja por HTTP. Por HTTP, o corpo também carrega um campo `model` com o id do modelo. Pelo binding, o primeiro parâmetro carrega o id e o corpo não o repete. Cada modelo de chat indica a [OpenAI Chat API](https://developers.openai.com/api/reference/overview) como o endpoint com o qual é compatível, então um campo se comporta como esse schema descreve; os tipos, os padrões e os limites abaixo são os que AI Inference declara. Um traço na coluna Padrão significa que o schema não define padrão para o campo.
+Estes campos formam o corpo de uma requisição a um modelo de chat, seja pelo binding, seja por HTTP. Por HTTP, o corpo também carrega um campo `model` com o id do modelo. Pelo binding, o primeiro parâmetro carrega o id e o corpo não o repete. Cada modelo de chat indica a [OpenAI Chat API](https://developers.openai.com/api/reference/overview) como o endpoint com o qual é compatível, então um campo se comporta como esse schema descreve. Os tipos, os padrões e os limites abaixo são os que AI Inference declara. Um traço na coluna Padrão significa que o schema não define padrão para o campo.
| Campo | Tipo | Obrigatório | Padrão | Descrição |
| --- | --- | --- | --- | --- |
diff --git a/apps/docs/src/content/docs/pt-br/pages/menu-principal/referencia/build/edge-application/cache-settings.mdx b/apps/docs/src/content/docs/pt-br/pages/menu-principal/referencia/build/edge-application/cache-settings.mdx
index 278edd68de..9fe23768f3 100644
--- a/apps/docs/src/content/docs/pt-br/pages/menu-principal/referencia/build/edge-application/cache-settings.mdx
+++ b/apps/docs/src/content/docs/pt-br/pages/menu-principal/referencia/build/edge-application/cache-settings.mdx
@@ -12,7 +12,7 @@ import FrameBox from '@aziontech/webkit/frame-box'
import ItemList from '@aziontech/webkit/item-list'
import DocItem from '@aziontech/webkit/doc-item'
-Um cache setting é um conjunto de valores que dizem ao [Cache](/pt-br/documentacao/plataforma/applications/cache/) como armazenar e entregar uma resposta. Ele pertence a uma Application, e os seus valores são o tempo de vida (TTL) de browser, o TTL e o comportamento de cache, o stale cache, a Large File Optimization, [Tiered Cache](/pt-br/documentacao/plataforma/applications/cache/tiered-cache/) e as variações de cache. Uma regra do [Rules Engine](/pt-br/documentacao/plataforma/applications/rules-engine/) com o behavior [Set Cache Policy](/pt-br/documentacao/plataforma/applications/rules-engine/#set-cache-policy) aplica o cache setting, e ele age apenas sobre as requisições às quais essa regra corresponde. Para criar um, consulte [Crie um cache setting](/pt-br/documentacao/guias/performance-e-confiabilidade/cache-e-purge/ajustar-cache-settings/).
+Um cache setting é um conjunto de valores que dizem ao [Cache](/pt-br/documentacao/plataforma/applications/cache/) como armazenar e entregar uma resposta. Ele pertence a uma Application. Os seus valores são o tempo de vida (TTL) de browser, o TTL e o comportamento de cache, o stale cache, a Large File Optimization, [Tiered Cache](/pt-br/documentacao/plataforma/applications/cache/tiered-cache/) e as variações de cache. Uma regra do [Rules Engine](/pt-br/documentacao/plataforma/applications/rules-engine/) com o behavior [Set Cache Policy](/pt-br/documentacao/plataforma/applications/rules-engine/#set-cache-policy) aplica o cache setting, e ele age apenas sobre as requisições às quais essa regra corresponde. Para criar um, consulte [Crie um cache setting](/pt-br/documentacao/guias/performance-e-confiabilidade/cache-e-purge/ajustar-cache-settings/).
---
@@ -77,7 +77,7 @@ O objeto `modules.cache` define por quanto tempo a Azion mantém uma cópia de u
O stale cache, o campo `stale_cache.enabled`, permite que a Azion entregue uma cópia expirada por uma janela limitada quando a origem não responde. A Large File Optimization, o campo `large_file_cache.enabled`, armazena um objeto grande em fragmentos, e `large_file_cache.offset` carrega o tamanho deles, fixo em 1.024 kB. Tiered Cache é uma feature de Cache que adiciona uma segunda camada de cache entre o data center que responde a uma requisição e a sua origem. O `tiered_cache.enabled` a ativa para os objetos que esse cache setting coloca em cache, e o `tiered_cache.topology` seleciona onde essa camada os mantém. Um objeto `tiered_cache` enviado sem `enabled` ativa a camada. Para saber como cada um se comporta em uma requisição, consulte [Expiração e atualização](/pt-br/documentacao/plataforma/applications/cache/expiracao-e-atualizacao/).
:::note[nota]
-Duas restrições se aplicam a esses valores. Um `modules.cache.max_age` abaixo de 60 segundos exige [Application Accelerator](/pt-br/documentacao/plataforma/applications/application-accelerator/) na Application; sem ele, a API recusa o cache setting com o erro `21021`. No Azion Console, o campo **Max Age** informa um mínimo de 3 segundos assim que **Large file optimization** é ativado; sem Application Accelerator, a API continua recusando um valor abaixo de 60 segundos com o erro `21021`. Tiered Cache exige `override` em `modules.cache.behavior`; com `honor`, a API recusa o cache setting com o erro `21001`. No Azion Console, ativar **Large file optimization** ou **Tiered Cache** desabilita a opção _Honor cache policies_ e seleciona _Override cache behavior_, mas a API aceita `honor` com a Large File Optimization.
+Duas restrições se aplicam a esses valores. Um `modules.cache.max_age` abaixo de 60 segundos exige [Application Accelerator](/pt-br/documentacao/plataforma/applications/application-accelerator/) na Application; sem ele, a API recusa o cache setting com o erro `21021`. No Azion Console, o campo **Max Age** informa um mínimo de 3 segundos assim que **Large file optimization** é ativado. Sem Application Accelerator, a API continua recusando um valor abaixo de 60 segundos com o erro `21021`. Tiered Cache exige `override` em `modules.cache.behavior`; com `honor`, a API recusa o cache setting com o erro `21001`. No Azion Console, ativar **Large file optimization** ou **Tiered Cache** desabilita a opção _Honor cache policies_ e seleciona _Override cache behavior_, mas a API aceita `honor` com a Large File Optimization.
:::
---
diff --git a/apps/docs/src/content/docs/pt-br/pages/menu-principal/referencia/build/edge-application/main-settings.mdx b/apps/docs/src/content/docs/pt-br/pages/menu-principal/referencia/build/edge-application/main-settings.mdx
index 84551d3617..efe0205f90 100644
--- a/apps/docs/src/content/docs/pt-br/pages/menu-principal/referencia/build/edge-application/main-settings.mdx
+++ b/apps/docs/src/content/docs/pt-br/pages/menu-principal/referencia/build/edge-application/main-settings.mdx
@@ -13,7 +13,7 @@ import VersionRollingOut from '~/includes/snippets/versionRollingOut/pt/snippet.
[Main Settings | v3](/pt-br/documentacao/plataforma/applications/main-settings-v3/)
-Main Settings é o conjunto de valores que se aplicam a uma [Application](/pt-br/documentacao/plataforma/applications/) como um todo: o nome, os recursos da plataforma ativados nela, se ela registra as regras que cada requisição executa e se ela está ativa. Azion Console agrupa esses valores na aba **Main Settings** da Application, e a API os retorna como campos da Application. Para o caminho que uma requisição percorre em uma Application, consulte [Como Applications funciona](/pt-br/documentacao/plataforma/applications/como-funciona/).
+Main Settings é o conjunto de valores que se aplicam a uma [Application](/pt-br/documentacao/plataforma/applications/) como um todo. Esses valores são o nome, os recursos da plataforma ativados nela, se ela registra as regras que cada requisição executa e se ela está ativa. Azion Console agrupa esses valores na aba **Main Settings** da Application, e a API os retorna como campos da Application. Para o caminho que uma requisição percorre em uma Application, consulte [Como Applications funciona](/pt-br/documentacao/plataforma/applications/como-funciona/).
---
diff --git a/apps/docs/src/content/docs/pt-br/pages/menu-principal/referencia/build/edge-application/real-time-purge.mdx b/apps/docs/src/content/docs/pt-br/pages/menu-principal/referencia/build/edge-application/real-time-purge.mdx
index 767829b222..c567864896 100644
--- a/apps/docs/src/content/docs/pt-br/pages/menu-principal/referencia/build/edge-application/real-time-purge.mdx
+++ b/apps/docs/src/content/docs/pt-br/pages/menu-principal/referencia/build/edge-application/real-time-purge.mdx
@@ -106,7 +106,7 @@ Quando um cache setting varia a cache key, um objeto tem uma key por variação.
As variações por query string, por cookie, por device group e por método da requisição vêm de Advanced Cache Key, em [Application Accelerator](/pt-br/documentacao/plataforma/applications/application-accelerator/). Application Accelerator também coloca em cache respostas `POST` e `OPTIONS`; sem ele, a Azion coloca em cache apenas `GET` e `HEAD`. Para os behaviors, consulte [Configurações do Application Accelerator](/pt-br/documentacao/plataforma/applications/application-accelerator/configuracoes/).
-Uma imagem que [Image Processor](/pt-br/documentacao/plataforma/applications/image-processor/) entrega tem uma key por processamento e por formato quando o cache setting nomeia `ims` na allowlist de query string. Quando o cache setting não varia a key por query string, o valor de `ims` não faz parte da key, então todos os tamanhos e processamentos do path compartilham uma key, e o primeiro armazenado responde a todos os valores de `ims`. Com `ims` na allowlist, a key carrega o host e o path, depois `@@`, a query string `ims` e, no fim, o formato convertido, sem separador. As quatro keys abaixo pertencem a uma imagem:
+Uma imagem que [Image Processor](/pt-br/documentacao/plataforma/applications/image-processor/) entrega tem uma key por processamento e por formato quando o cache setting nomeia `ims` na allowlist de query string. Quando o cache setting não varia a key por query string, o valor de `ims` não faz parte da key. Todos os tamanhos e processamentos do path então compartilham uma key, e o primeiro armazenado responde a todos os valores de `ims`. Com `ims` na allowlist, a key carrega o host e o path, depois `@@`, a query string `ims` e, no fim, o formato convertido, sem separador. As quatro keys abaixo pertencem a uma imagem:
- `httpstatic.example.com/static/images/image.jpg@@`
- `httpstatic.example.com/static/images/image.jpg@@webp`
diff --git a/apps/docs/src/content/docs/pt-br/pages/menu-principal/referencia/build/edge-application/websocket.mdx b/apps/docs/src/content/docs/pt-br/pages/menu-principal/referencia/build/edge-application/websocket.mdx
index 2b16088f6d..61a2df6068 100644
--- a/apps/docs/src/content/docs/pt-br/pages/menu-principal/referencia/build/edge-application/websocket.mdx
+++ b/apps/docs/src/content/docs/pt-br/pages/menu-principal/referencia/build/edge-application/websocket.mdx
@@ -26,7 +26,7 @@ Uma conexão WebSocket por meio de uma Application precisa de suporte nativo a W
## Headers de upgrade
-Uma Application com WebSocket Proxy habilitado lê dois headers de requisição para decidir se uma requisição abre uma conexão WebSocket. Ela trata a requisição como uma conexão WebSocket, e faz o proxy dela até a origem, quando `Upgrade` traz `websocket` e `Connection` traz o token `upgrade`, com qualquer combinação de maiúsculas e minúsculas, sozinho ou em uma lista como `Connection: keep-alive, Upgrade`.
+Uma Application com WebSocket Proxy habilitado lê dois headers de requisição para decidir se uma requisição abre uma conexão WebSocket. Ela trata a requisição como uma conexão WebSocket, e faz o proxy dela até a origem, quando `Upgrade` traz `websocket` e `Connection` traz o token `upgrade`. O token vale com qualquer combinação de maiúsculas e minúsculas, sozinho ou em uma lista como `Connection: keep-alive, Upgrade`.
| Header | Valor |
| --- | --- |
diff --git a/apps/docs/src/content/docs/pt-br/pages/menu-principal/referencia/observe/data-streaming/data-streaming.mdx b/apps/docs/src/content/docs/pt-br/pages/menu-principal/referencia/observe/data-streaming/data-streaming.mdx
index faad229304..19d80be9bf 100644
--- a/apps/docs/src/content/docs/pt-br/pages/menu-principal/referencia/observe/data-streaming/data-streaming.mdx
+++ b/apps/docs/src/content/docs/pt-br/pages/menu-principal/referencia/observe/data-streaming/data-streaming.mdx
@@ -12,7 +12,7 @@ import DocButton from '~/components/webkit/DocButton.vue';
import DocCardGroup from '@aziontech/webkit/doc-card-group'
import DocCard from '@aziontech/webkit/doc-card'
-Log streaming é uma forma de coletar os registros que uma plataforma escreve sobre o tráfego e a conta dela. A plataforma envia cada registro, no momento em que ele acontece, para um destino que você opera, como um SIEM (um sistema de gerenciamento de informações e eventos de segurança), um data warehouse ou um processador de streams. Você analisa os registros nas suas próprias ferramentas e não consulta uma API repetidamente para coletá-los.
+Log streaming é uma forma de coletar os registros que uma plataforma escreve sobre o tráfego e a conta dela. A plataforma envia cada registro, no momento em que ele acontece, para um destino que você opera. Esse destino pode ser um SIEM (um sistema de gerenciamento de informações e eventos de segurança), um data warehouse ou um processador de streams. Você analisa os registros nas suas próprias ferramentas e não consulta uma API repetidamente para coletá-los.
**Data Stream** envia os logs de eventos do [Activity History](/pt-br/documentacao/fundamentos/activity-history/), de [aplicações](/pt-br/documentacao/plataforma/applications/), de [functions](/pt-br/documentacao/plataforma/functions/) e do WAF para um endpoint por stream. Cada stream formata os eventos com um template e os envia em lotes. Use Data Stream para [alimentar um SIEM com eventos do WAF](/pt-br/documentacao/guias/seguranca-de-aplicacoes/firewall-e-waf/integrar-siems/), [manter logs de requisições em um data warehouse](/pt-br/documentacao/guias/plataforma/observabilidade/google-bigquery-endpoint/), auditar as mudanças feitas na sua conta ou [depurar functions](/pt-br/documentacao/guias/plataforma/observabilidade/debugging-functions-data-stream/).
@@ -84,7 +84,7 @@ Salvar um stream verifica o formato dos campos dele, não o endpoint, então os
## Escopo e limites
- **Fontes de dados**: um stream coleta de uma entre quatro fontes de dados: *Activity History*, *Applications*, *Functions* ou *WAF Events*. *WAF Events* precisa do [Firewall](/pt-br/documentacao/plataforma/firewall/) com WAF. Para as variáveis de cada uma, consulte [Fontes de dados e variáveis](/pt-br/documentacao/plataforma/data-stream/fontes-de-dados-e-variaveis/).
-- **Endpoints**: um stream envia para um entre 11 tipos de endpoint: *Standard HTTP/HTTPS POST*, *Apache Kafka*, *Simple Storage Service (S3)*, *Google BigQuery*, *Elasticsearch*, *Splunk*, *AWS Kinesis Data Firehose*, *Datadog*, *IBM QRadar*, *Azure Monitor* e *Azure Blob Storage*. Enviar os mesmos eventos para dois endpoints exige dois streams. Para os campos de cada tipo, consulte [Endpoints](/pt-br/documentacao/plataforma/data-stream/endpoints/).
+- **Endpoints**: um stream envia para um entre 11 tipos de endpoint. Os tipos são *Standard HTTP/HTTPS POST*, *Apache Kafka*, *Simple Storage Service (S3)*, *Google BigQuery*, *Elasticsearch*, *Splunk*, *AWS Kinesis Data Firehose*, *Datadog*, *IBM QRadar*, *Azure Monitor* e *Azure Blob Storage*. Enviar os mesmos eventos para dois endpoints exige dois streams. Para os campos de cada tipo, consulte [Endpoints](/pt-br/documentacao/plataforma/data-stream/endpoints/).
- **Templates**: a Azion fornece cinco [templates predefinidos](/pt-br/documentacao/plataforma/data-stream/templates-e-payload/#templates-predefinidos), e você escreve um [template personalizado](/pt-br/documentacao/plataforma/data-stream/templates-e-payload/#templates-personalizados) para escolher as variáveis de cada linha de log.
- **Lotes**: um lote guarda 2.000 linhas de log ou 60 segundos de eventos. Um endpoint *AWS Kinesis Data Firehose* recebe lotes de 500 linhas de log ou 60 segundos, e um lote *Standard HTTP/HTTPS POST* também fecha ao atingir o **Payload Max Size** dele. Os logs chegam à sua infraestrutura em até 3 minutos.
- **Escopo**: um stream carrega uma taxa de sampling ou um filtro de [workloads](/pt-br/documentacao/plataforma/workloads/) escolhidos, nunca os dois. Salvar um stream ativo com sampling desativa todos os outros streams da conta, enquanto streams com filtro de workloads rodam lado a lado. Para as duas opções, consulte [Configurações do stream](/pt-br/documentacao/plataforma/data-stream/configuracoes-do-stream/#transform).
@@ -94,7 +94,7 @@ Salvar um stream verifica o formato dos campos dele, não o endpoint, então os
- **Uso por plano**: Data Stream não exige etapa de ativação: um stream é executado assim que você o salva. Ele é cobrado por Requests e Data Transfer, e cada plano inclui uma quantidade mensal dos dois, listada em [Limites de Data Stream](/pt-br/documentacao/plataforma/data-stream/limites/#uso-incluido-por-plano). Para os valores, consulte [Preços](/pt-br/documentacao/fundamentos/precos/#data-stream).
- **Falhas**: quando um endpoint está indisponível ou responde com um erro, as linhas de log daquele envio não chegam a ele. Para as causas e as correções, consulte [Solucionar problemas de Data Stream](/pt-br/documentacao/plataforma/data-stream/solucao-de-problemas/).
-Data Stream não armazena nem consulta logs. Real-Time Events mantém os eventos brutos dos seus produtos por 7 dias e os eventos do Activity History por 2 anos, enquanto o seu endpoint mantém o que o stream envia pelo tempo que você decidir.
+Data Stream não armazena nem consulta logs. Real-Time Events mantém os eventos brutos dos seus produtos por 7 dias e os eventos do Activity History por 2 anos. O seu endpoint mantém o que o stream envia pelo tempo que você decidir.
---
diff --git a/apps/docs/src/content/docs/pt-br/pages/menu-principal/referencia/observe/real-time-events/real-time-events.mdx b/apps/docs/src/content/docs/pt-br/pages/menu-principal/referencia/observe/real-time-events/real-time-events.mdx
index cb95ef340d..fed9b78085 100644
--- a/apps/docs/src/content/docs/pt-br/pages/menu-principal/referencia/observe/real-time-events/real-time-events.mdx
+++ b/apps/docs/src/content/docs/pt-br/pages/menu-principal/referencia/observe/real-time-events/real-time-events.mdx
@@ -10,7 +10,7 @@ import DocButton from '~/components/webkit/DocButton.vue'
import DocCardGroup from '@aziontech/webkit/doc-card-group'
import DocCard from '@aziontech/webkit/doc-card'
-Um sistema que serve tráfego pode escrever um registro para cada unidade de trabalho que executa: o endereço de onde uma requisição veio, o caminho que ela pediu, o status com que ela foi respondida e o tempo que ela levou. Esses registros são mantidos por um período fixo e consultados campo a campo, então uma pergunta feita depois do fato é respondida pelo que foi escrito, e não pelo que alguém lembra. No fim do período, os registros são removidos, e a pergunta que eles responderiam não pode mais ser feita.
+Um sistema que serve tráfego pode escrever um registro para cada unidade de trabalho que executa. Um registro guarda o endereço de onde uma requisição veio, o caminho que ela pediu, o status com que ela foi respondida e o tempo que ela levou. Esses registros são mantidos por um período fixo e consultados campo a campo, então uma pergunta feita depois do fato é respondida pelo que foi escrito, e não pelo que alguém lembra. No fim do período, os registros são removidos, e a pergunta que eles responderiam não pode mais ser feita.
**Real-Time Events** é o recurso da plataforma que guarda esses registros na infraestrutura distribuída da Azion e os entrega de volta. Cada produto Azion escreve os próprios registros em uma fonte de dados própria, e cada fonte de dados carrega o conjunto de variáveis pré-organizadas que esse produto preenche. Use Real-Time Events para consultar os registros do tráfego passado, inspecionar um possível ataque, depurar uma [function](/pt-br/documentacao/plataforma/functions/), medir a performance de uma [aplicação](/pt-br/documentacao/plataforma/applications/) ou verificar o que mudou em uma conta.
diff --git a/apps/docs/src/content/docs/pt-br/pages/menu-principal/referencia/secure/edge-connector/edge-connector.mdx b/apps/docs/src/content/docs/pt-br/pages/menu-principal/referencia/secure/edge-connector/edge-connector.mdx
index ebef855669..1e4cb309db 100644
--- a/apps/docs/src/content/docs/pt-br/pages/menu-principal/referencia/secure/edge-connector/edge-connector.mdx
+++ b/apps/docs/src/content/docs/pt-br/pages/menu-principal/referencia/secure/edge-connector/edge-connector.mdx
@@ -15,7 +15,7 @@ import VersionRollingOut from '~/includes/snippets/versionRollingOut/pt/snippet.
Um proxy reverso responde aos clientes em nome de um servidor que você opera, chamado de origem. Quando o proxy não consegue responder com o que já guarda, ele abre a própria conexão com a origem e encaminha a requisição. Nessa conexão, ele decide como endereçar a origem: o hostname no header `Host`, o caminho, o protocolo e a porta. Os clientes nunca se conectam à origem, então você pode mover ou proteger a origem sem nenhuma mudança do lado do cliente.
-**Connectors** é o recurso da plataforma que guarda essas decisões na Azion. Um connector é um objeto próprio: ele armazena o endereço da sua origem e as configurações que moldam cada requisição a ela, e uma regra em uma [aplicação](/pt-br/documentacao/plataforma/applications/) envia requisições a ele com o behavior _Set Connector_. Várias aplicações podem reutilizar um connector, então as configurações de conexão de uma origem ficam em um só lugar. Use Connectors para enviar tráfego a um servidor em cloud ou a um servidor no seu data center, servir objetos de um bucket do Object Storage, distribuir requisições entre vários servidores, impedir que os clientes alcancem a sua origem diretamente ou entregar uma transmissão ao vivo.
+**Connectors** é o recurso da plataforma que guarda essas decisões na Azion. Um connector é um objeto próprio: ele armazena o endereço da sua origem e as configurações que moldam cada requisição a ela. Uma regra em uma [aplicação](/pt-br/documentacao/plataforma/applications/) envia requisições ao connector com o behavior _Set Connector_. Várias aplicações podem reutilizar um connector, então as configurações de conexão de uma origem ficam em um só lugar. Use Connectors para enviar tráfego a um servidor em cloud ou a um servidor no seu data center, ou para servir objetos de um bucket do Object Storage. Você também pode usar Connectors para distribuir requisições entre vários servidores, impedir que os clientes alcancem a sua origem diretamente ou entregar uma transmissão ao vivo.
@@ -85,7 +85,7 @@ Para saber como ele escolhe um endereço, onde age sobre uma requisição e por
### Origin Shield
-Origin Shield protege a origem de um connector do tipo `http` de duas formas: Origin IP ACL deixa o firewall da sua origem aceitar somente os endereços da Azion, e HMAC assina cada requisição que o connector envia. Ative-o quando os clientes não devem alcançar a sua origem diretamente ou quando a origem serve somente requisições assinadas.
+Origin Shield protege a origem de um connector do tipo `http` de duas formas. Origin IP ACL deixa o firewall da sua origem aceitar somente os endereços da Azion, e HMAC assina cada requisição que o connector envia. Ative-o quando os clientes não devem alcançar a sua origem diretamente ou quando a origem serve somente requisições assinadas.
Para saber o que cada defesa prova, onde ele age sobre uma requisição e por onde começar, consulte a [visão geral do Origin Shield](/pt-br/documentacao/plataforma/connectors/origin-shield/).
diff --git a/apps/docs/src/content/docs/pt-br/pages/menu-principal/referencia/secure/edge-connector/sni-check.mdx b/apps/docs/src/content/docs/pt-br/pages/menu-principal/referencia/secure/edge-connector/sni-check.mdx
index 5908420be5..4f967fae9c 100644
--- a/apps/docs/src/content/docs/pt-br/pages/menu-principal/referencia/secure/edge-connector/sni-check.mdx
+++ b/apps/docs/src/content/docs/pt-br/pages/menu-principal/referencia/secure/edge-connector/sni-check.mdx
@@ -65,7 +65,7 @@ Quando os dados da sessão TLS não podem ser recuperados, a plataforma prossegu
## Escopo da aplicação
-A aplicação rigorosa da validação de SNI reduz significativamente o risco de ataques de **SNI Spoofing**, nos quais um agente malicioso manipula o campo SNI para rotear uma conexão TLS por um certificado que não cobre legitimamente o hostname de destino. Ao retornar `421 Misdirected Request` nesses casos, a Azion Web Platform garante que cada requisição HTTPS seja servida apenas em um contexto de segurança válido e apropriado.
+A aplicação rigorosa da validação de SNI reduz significativamente o risco de ataques de **SNI Spoofing**. Nesse ataque, um agente malicioso manipula o campo SNI para rotear uma conexão TLS por um certificado que não cobre legitimamente o hostname de destino. Ao retornar `421 Misdirected Request` nesses casos, a Azion Web Platform garante que cada requisição HTTPS seja servida apenas em um contexto de segurança válido e apropriado.
A aplicação do SNI Check não é configurável pelo Azion Console ou pela API. Para habilitá-la ou desabilitá-la nos seus workloads, entre em contato com o [Suporte da Azion](https://www.azion.com/pt-br/suporte/).
diff --git a/apps/docs/src/content/docs/pt-br/pages/menu-principal/referencia/secure/edge-firewall/azion-bot-manager-lite.mdx b/apps/docs/src/content/docs/pt-br/pages/menu-principal/referencia/secure/edge-firewall/azion-bot-manager-lite.mdx
index 0c3e2f8ebe..6ec6b7b8bb 100644
--- a/apps/docs/src/content/docs/pt-br/pages/menu-principal/referencia/secure/edge-firewall/azion-bot-manager-lite.mdx
+++ b/apps/docs/src/content/docs/pt-br/pages/menu-principal/referencia/secure/edge-firewall/azion-bot-manager-lite.mdx
@@ -60,10 +60,10 @@ As regras 15, 16 e 17 leem o par de cookies de sessão que a função define em
A regra 14 verifica o IP do cliente contra as [Network Lists](/pt-br/documentacao/plataforma/firewall/network-shield/network-lists/) cujos IDs estão listados em `reputation_network_lists`, e soma 6 pontos para cada lista em que o IP é encontrado.
-Dois argumentos tiram uma requisição da tabela antes de ela ser pontuada. Uma requisição cujo fingerprint está listado em `good_fingerprint_list` pula todas as regras acima. Com `block_ai_bots` definido como `true`, uma requisição de um user agent de IA conhecido é bloqueada antes do pipeline de pontuação, então ela não alcança regra nenhuma e não carrega ID de regra na sua linha de log.
+Dois argumentos tiram uma requisição da tabela antes de ela ser pontuada. Uma requisição cujo fingerprint está listado em `good_fingerprint_list` pula todas as regras acima. Com `block_ai_bots` definido como `true`, uma requisição de um user agent de IA conhecido é bloqueada antes do pipeline de pontuação. Essa requisição não alcança regra nenhuma e não carrega ID de regra na sua linha de log.
:::caution[Atenção]
-As regras 18 a 26 são entregues na v0.2.0 sem calibração prévia, então elas podem pontuar tráfego legítimo dependendo do seu perfil de tráfego. Execute a instância com `action` definido como `allow`, leia os IDs das regras no log de report e liste em `disabled_rules` as regras que seguem correspondendo a requisições legítimas antes de passar para uma ação de bloqueio.
+As regras 18 a 26 são entregues na v0.2.0 sem calibração prévia, então elas podem pontuar tráfego legítimo dependendo do seu perfil de tráfego. Execute a instância com `action` definido como `allow` e leia os IDs das regras no log de report. Antes de passar para uma ação de bloqueio, liste em `disabled_rules` as regras que seguem correspondendo a requisições legítimas.
:::
Os IDs que uma requisição correspondeu são escritos no log de report, então os valores de `disabled_rules` vêm do seu próprio tráfego, e não desta tabela.
@@ -93,7 +93,7 @@ O Bot Manager Lite v0.2.0 entrega um padrão para oito argumentos:
`log_headers` é entregue com nove cabeçalhos: `accept`, `accept-encoding`, `accept-language`, `content-type`, `host`, `referer`, `user-agent`, `x-forwarded-for` e `x-request-id`. O array nomeia os cabeçalhos que a função escreve, e não os cabeçalhos a manter fora do log. Sete cabeçalhos nunca são escritos, qualquer que seja o conteúdo do array: `authorization`, `cookie`, `proxy-authorization`, `set-cookie`, `x-csrf-token`, `x-api-key` e `x-amz-security-token`. Os valores dos cabeçalhos são escritos em base64.
-Os sete argumentos abaixo são documentados para o Bot Manager Lite e não são entregues com padrão na função, então **Padrão documentado** é o valor que a documentação informa, e não um valor lido da função instalada.
+Os sete argumentos abaixo são documentados para o Bot Manager Lite e não são entregues com padrão na função. Por isso, **Padrão documentado** é o valor que a documentação informa, e não um valor lido da função instalada.
| Argumento | Tipo | Padrão documentado | O que faz |
| --- | --- | --- | --- |
diff --git a/apps/docs/src/content/docs/pt-br/pages/menu-principal/referencia/secure/edge-firewall/edge-functions-for-edge-firewall/edge-functions-firewall.mdx b/apps/docs/src/content/docs/pt-br/pages/menu-principal/referencia/secure/edge-firewall/edge-functions-for-edge-firewall/edge-functions-firewall.mdx
index 3b2fe632c0..db4eceee5b 100644
--- a/apps/docs/src/content/docs/pt-br/pages/menu-principal/referencia/secure/edge-firewall/edge-functions-for-edge-firewall/edge-functions-firewall.mdx
+++ b/apps/docs/src/content/docs/pt-br/pages/menu-principal/referencia/secure/edge-firewall/edge-functions-for-edge-firewall/edge-functions-firewall.mdx
@@ -60,7 +60,7 @@ A tabela lista os métodos que uma função em um firewall chama no evento `fire
| `event.respondWith()` | Um objeto `Response` | Intercepta a requisição e a responde com uma resposta personalizada, cujo status, headers e conteúdo o objeto define |
| `event.waitUntil()` | Uma promise, como a que um handler `async` retorna | Executa um handler `async` a partir do listener síncrono. Sem ele, a promise pode terminar em exceções inesperadas |
-No padrão ES Modules, o handler `firewall` de uma função com build feito pela Azion CLI 4.24.0 ou posterior chama esses métodos em `ctx`, o terceiro argumento dele: `ctx.addRequestHeader()`, `ctx.addResponseHeader()`, `ctx.continue()`, `ctx.deny()`, `ctx.drop()`, `ctx.respondWith()` e `ctx.waitUntil()`. Cada um se comporta como o método do evento com o mesmo nome. Uma função com build feito pela Azion CLI 4.23.0 recebe um `ctx` que carrega apenas `waitUntil`, então `ctx.deny()` lança um erro e a requisição responde HTTP 500. Para o handler e o `ctx` dele, consulte [Handlers](/pt-br/documentacao/devtools/runtime/api-reference/handlers/#handler-firewall).
+No padrão ES Modules, o handler `firewall` de uma função com build feito pela Azion CLI 4.24.0 ou posterior chama esses métodos em `ctx`, o terceiro argumento dele. Os métodos são `ctx.addRequestHeader()`, `ctx.addResponseHeader()`, `ctx.continue()`, `ctx.deny()`, `ctx.drop()`, `ctx.respondWith()` e `ctx.waitUntil()`. Cada um se comporta como o método do evento com o mesmo nome. Uma função com build feito pela Azion CLI 4.23.0 recebe um `ctx` que carrega apenas `waitUntil`, então `ctx.deny()` lança um erro e a requisição responde HTTP 500. Para o handler e o `ctx` dele, consulte [Handlers](/pt-br/documentacao/devtools/runtime/api-reference/handlers/#handler-firewall).
### event.addRequestHeader
diff --git a/apps/docs/src/content/docs/pt-br/pages/menu-principal/referencia/secure/edge-firewall/rules-engine-edge-firewall.mdx b/apps/docs/src/content/docs/pt-br/pages/menu-principal/referencia/secure/edge-firewall/rules-engine-edge-firewall.mdx
index 7491b7039b..6155e7e38c 100644
--- a/apps/docs/src/content/docs/pt-br/pages/menu-principal/referencia/secure/edge-firewall/rules-engine-edge-firewall.mdx
+++ b/apps/docs/src/content/docs/pt-br/pages/menu-principal/referencia/secure/edge-firewall/rules-engine-edge-firewall.mdx
@@ -77,7 +77,7 @@ Depois que uma regra do firewall usa `${network}`, Network Shield não pode ser
| _Certificate Verification Error_ | `CERTIFICATE_VERIFICATION_ERROR` | O certificado do cliente não era válido |
| _Missing Client Certificate_ | `MISSING_CLIENT_CERTIFICATE` | A requisição não carregava certificado de cliente |
-`Client Certificate Validation` recebe um único valor, `true`, que Azion Console oferece como a entrada única _Valid_ na lista **Select a validation result**. Uma lista com uma única entrada já vem selecionada, então o campo parece preenchido antes de você abri-lo. _is equal_ corresponde a uma requisição cujo certificado de cliente passou na validação, e _is not equal_ corresponde a uma que não carregava certificado ou cujo certificado não era válido.
+`Client Certificate Validation` recebe um único valor, `true`, que Azion Console oferece como a entrada única _Valid_ na lista **Select a validation result**. Uma lista com uma única entrada já vem selecionada, então o campo parece preenchido antes de você abri-lo. O operador _is equal_ corresponde a uma requisição cujo certificado de cliente passou na validação, e _is not equal_ corresponde a uma que não carregava certificado ou cujo certificado não era válido.
### Operadores
@@ -200,7 +200,7 @@ Para saber como a taxa e o burst admitem requisições, consulte [Como Firewall
_Set WAF_ aplica um [rule set](/pt-br/documentacao/plataforma/firewall/waf/rule-sets/) de WAF às requisições a que a regra corresponde, e exige WAF habilitado no firewall. Um rule set só é executado quando uma regra carrega esse comportamento, e uma regra carrega no máximo um. Os rule sets ficam no Azion Console em **Edge Libraries** > **WAF Rules**.
:::caution[Atenção]
-A Azion mantém uma única configuração de _Set WAF_ para cada lógica de critérios. Quando outro firewall carrega uma regra com os mesmos critérios e um comportamento _Set WAF_ que nomeia um rule set diferente, apenas o mais recente dos dois é processado, e o outro rule set não é executado. Consulte [Como Set WAF é resolvido entre firewalls](/pt-br/documentacao/plataforma/firewall/como-funciona/#como-set-waf-e-resolvido-entre-firewalls).
+A Azion mantém uma única configuração de _Set WAF_ para cada lógica de critérios. Outro firewall pode carregar uma regra com os mesmos critérios e um comportamento _Set WAF_ que nomeia um rule set diferente. Nesse caso, apenas o mais recente dos dois é processado, e o outro rule set não é executado. Consulte [Como Set WAF é resolvido entre firewalls](/pt-br/documentacao/plataforma/firewall/como-funciona/#como-set-waf-e-resolvido-entre-firewalls).
:::
| Atributo | Controle no Console | Valores | Descrição |
diff --git a/apps/docs/src/content/docs/pt-br/pages/menu-principal/referencia/secure/edge-firewall/web-application-firewall/waf-rule-sets.mdx b/apps/docs/src/content/docs/pt-br/pages/menu-principal/referencia/secure/edge-firewall/web-application-firewall/waf-rule-sets.mdx
index 6a4f0939d2..69f3defb14 100644
--- a/apps/docs/src/content/docs/pt-br/pages/menu-principal/referencia/secure/edge-firewall/web-application-firewall/waf-rule-sets.mdx
+++ b/apps/docs/src/content/docs/pt-br/pages/menu-principal/referencia/secure/edge-firewall/web-application-firewall/waf-rule-sets.mdx
@@ -12,11 +12,11 @@ import FrameBox from '@aziontech/webkit/frame-box'
import ItemList from '@aziontech/webkit/item-list'
import DocItem from '@aziontech/webkit/doc-item'
-Um rule set é o objeto que guarda o que o [Web Application Firewall](/pt-br/documentacao/plataforma/firewall/waf/) (WAF) procura: as famílias de ameaças contra as quais ele pontua uma requisição e o nível de sensibilidade que transforma um score em um bloqueio. O Azion Console lista esses objetos em **WAF Rules**; a API da Azion e a Azion CLI chamam o mesmo objeto de `waf`.
+Um rule set é o objeto que guarda o que o [Web Application Firewall](/pt-br/documentacao/plataforma/firewall/waf/) (WAF) procura. Ele guarda as famílias de ameaças contra as quais o WAF pontua uma requisição e o nível de sensibilidade que transforma um score em um bloqueio. O Azion Console lista esses objetos em **WAF Rules**; a API da Azion e a Azion CLI chamam o mesmo objeto de `waf`.
Um rule set não age sozinho. Ele é executado quando uma regra do [Rules Engine for Firewall](/pt-br/documentacao/plataforma/firewall/rules-engine/) carrega o behavior **Set WAF** que o nomeia, junto com um modo _Logging_ ou _Blocking_. O modo pertence a essa regra e não ao rule set, então um mesmo rule set é executado em _Logging_ em uma regra e em _Blocking_ em outra. Para mais informações, consulte [Score e modos](/pt-br/documentacao/plataforma/firewall/waf/score-e-modos/).
-Esta página lista os campos de um rule set, as oito famílias de ameaças que ele pontua, os cinco níveis de sensibilidade e seus limiares, as 63 regras internas por trás das famílias e as superfícies de API e CLI que o gerenciam.
+Esta página lista os campos de um rule set, as oito famílias de ameaças que ele pontua e os cinco níveis de sensibilidade e seus limiares. Ela também lista as 63 regras internas por trás das famílias e as superfícies de API e CLI que o gerenciam.
---
@@ -425,7 +425,7 @@ Uma requisição rejeitada retorna um array `errors`. Cada entrada carrega um `c
| `26006` | Name Already In Use | 400 | Um `name` que outro rule set da conta já possui | Escolha outro nome |
| `26007` | Cannot Delete WAF | 400 | Um `DELETE` em um rule set que uma regra do Rules Engine ainda aplica por um comportamento `set_waf` | Exclua cada regra que o erro nomeia, ou aponte o _Set WAF_ dela para outro rule set, e depois exclua o rule set de novo |
-`10067` retorna `500` para um erro do cliente. Uma família de ameaças repetida é respondida com o texto `A server error occurred.`, que não nomeia nem a duplicata nem o campo, então quem confia no código de status conclui que a plataforma está fora do ar, e uma nova tentativa retorna o mesmo `500`. O seu ponteiro `source` diz `/data/attributes/thresholds`, um segmento a menos que o ponteiro que todo outro erro de threshold retorna.
+`10067` retorna `500` para um erro do cliente. Uma família de ameaças repetida é respondida com o texto `A server error occurred.`, que não nomeia nem a duplicata nem o campo. Quem confia no código de status então conclui que a plataforma está fora do ar, e uma nova tentativa retorna o mesmo `500`. O seu ponteiro `source` diz `/data/attributes/thresholds`, um segmento a menos que o ponteiro que todo outro erro de threshold retorna.
`26007` nomeia duas vezes cada regra que ainda aplica o rule set, como ` - `: uma no `detail`, `It was not possible to perform this operation. To delete this WAF, you must first remove its usage in the following rules engine: [' - '].`, e outra como uma entrada de `meta.ef_rules_using_waf`. O seu ponteiro `source` diz `/data`.
diff --git a/apps/docs/src/content/docs/pt-br/pages/menu-principal/referencia/store/kv-store/kv-store.mdx b/apps/docs/src/content/docs/pt-br/pages/menu-principal/referencia/store/kv-store/kv-store.mdx
index 973c59a841..9dc0df8e62 100644
--- a/apps/docs/src/content/docs/pt-br/pages/menu-principal/referencia/store/kv-store/kv-store.mdx
+++ b/apps/docs/src/content/docs/pt-br/pages/menu-principal/referencia/store/kv-store/kv-store.mdx
@@ -73,7 +73,7 @@ flowchart TD
5. `Azion.KV.open` resolve o namespace pelo nome. Um nome que nenhum namespace da conta carrega lança `NotFound`.
6. O handler chama `put`, `get`, `getWithMetadata` ou `delete` e retorna sua resposta.
-Criar o namespace fora da requisição mantém curto o caminho da requisição, e custa a você a possibilidade de provisionar um sob demanda: uma function não pode criar o namespace de que precisa, então o nome precisa existir antes de o código que o abre ir para produção.
+Criar o namespace fora da requisição mantém curto o caminho da requisição, e custa a você a possibilidade de provisionar um sob demanda. Uma function não pode criar o namespace de que precisa, então o nome precisa existir antes de o código que o abre ir para produção.
---
diff --git a/apps/docs/src/content/docs/pt-br/pages/store/kv-store/boas-praticas.mdx b/apps/docs/src/content/docs/pt-br/pages/store/kv-store/boas-praticas.mdx
index 31f5de6d51..02f0cc754e 100644
--- a/apps/docs/src/content/docs/pt-br/pages/store/kv-store/boas-praticas.mdx
+++ b/apps/docs/src/content/docs/pt-br/pages/store/kv-store/boas-praticas.mdx
@@ -14,7 +14,7 @@ import DocItem from '@aziontech/webkit/doc-item'
Um namespace é nomeado uma vez e mantém esse nome enquanto a conta existir, porque nenhuma interface renomeia, esvazia ou exclui um namespace. Uma key só é alcançável por um nome que o código consiga construir de novo, porque nada lista o que um namespace guarda. Uma leitura pode retornar um value que uma escrita anterior já substituiu. Uma requisição rejeitada chega em uma de duas formas, e um cliente escrito para uma delas registra a outra como sucesso. Cada uma dessas decisões é tomada onde o código é escrito, e cada uma é barata ali e cara depois.
-As práticas a seguir aparecem na ordem em que as decisões chegam. O nome do namespace vem primeiro, porque nenhuma interface o altera. Depois vêm o cliente que uma função abre, os dois envelopes em que uma requisição de namespace rejeitada chega e o nome de key que substitui a listagem que este store não tem. As quatro últimas cobrem o tipo que um value assume na entrada e na saída, a leitura de várias keys em uma chamada, a desatualização que toda leitura carrega e as perguntas que devem ficar fora do store.
+As práticas a seguir aparecem na ordem em que as decisões chegam. O nome do namespace vem primeiro, porque nenhuma interface o altera. Depois vêm o cliente que uma função abre, os dois envelopes em que uma requisição de namespace rejeitada chega e o nome de key que substitui a listagem que este store não tem. As quatro últimas começam pelo tipo que um value assume na entrada e na saída e pela leitura de várias keys em uma chamada. Elas terminam com a desatualização que toda leitura carrega e as perguntas que devem ficar fora do store.
---
@@ -22,7 +22,9 @@ As práticas a seguir aparecem na ordem em que as decisões chegam. O nome do na
Escolha um nome de namespace que ainda descreva seu conteúdo daqui a um ano, porque nada no KV Store renomeia um namespace.
-A Azion API v4 expõe três operações sobre um namespace: criar, listar e recuperar. `PUT`, `PATCH` e `DELETE` respondem `405` cada um, então um namespace não pode ser renomeado, desativado, esvaziado ou excluído depois que existe, e um nome que a conta cria permanece na conta. O nome também é o identificador, já que um namespace não carrega id numérico, então o nome é o que toda requisição posterior e toda chamada de `Azion.KV.open` em uma função passam. Um nome que declara a aplicação e o ambiente que ele atende diz ao próximo leitor da lista qual namespace uma função está abrindo, e mantém as keys de uma carga de trabalho fora das de outra. Por exemplo, um serviço de checkout que roda em dois ambientes mantém dois namespaces em vez de um namespace com dois prefixos de key, para que uma escrita de staging não caia em uma key de produção.
+A Azion API v4 expõe três operações sobre um namespace: criar, listar e recuperar. `PUT`, `PATCH` e `DELETE` respondem `405` cada um, então um namespace não pode ser renomeado, desativado, esvaziado ou excluído depois que existe, e um nome que a conta cria permanece na conta. O nome também é o identificador, já que um namespace não carrega id numérico, então o nome é o que toda requisição posterior e toda chamada de `Azion.KV.open` em uma função passam.
+
+Um nome que declara a aplicação e o ambiente que ele atende diz ao próximo leitor da lista qual namespace uma função está abrindo. Esse nome também mantém as keys de uma carga de trabalho fora das de outra. Por exemplo, um serviço de checkout que roda em dois ambientes mantém dois namespaces em vez de um namespace com dois prefixos de key. Assim, uma escrita de staging não pode cair em uma key de produção.
```text
checkout-sessions-prod
@@ -32,7 +34,7 @@ checkout-flags-prod
Escreva os nomes em minúsculas, com hífen entre as palavras, e mantenha essa forma para todo namespace da conta. A plataforma não exige isso: o padrão `^[a-zA-Z0-9_-]+$` aceita maiúsculas, então `Orders-EU` é um nome válido e `orders-eu` também. **Os nomes diferenciam maiúsculas de minúsculas**, então os dois são namespaces diferentes, e uma conta pode acabar com os dois. Como nada exclui um namespace, um nome criado na caixa errada fica na conta com essa caixa para sempre. Minúsculas são uma convenção que esta página recomenda, não uma regra que a API impõe, e o valor dela é remover o único erro que não dá para desfazer. Para as regras que ela impõe, consulte [Namespaces](/pt-br/documentacao/plataforma/kv-store/namespaces/).
-O custo é que a decisão é permanente, e ela é tomada antes de a primeira key existir. Um namespace cujo nome deixa de descrever seu conteúdo é substituído pela criação de um segundo namespace e pela escrita das keys nele a partir de uma função, e o primeiro permanece na conta a partir de então.
+O custo é que a decisão é permanente, e ela é tomada antes de a primeira key existir. Um namespace cujo nome deixa de descrever seu conteúdo é substituído pela criação de um segundo namespace e pela escrita das keys nele a partir de uma função. O primeiro permanece na conta a partir de então.
---
@@ -71,7 +73,9 @@ O custo é que cada chamada segura o handler até ela resolver. Uma escrita da q
Escreva um handler que leia as duas formas que uma requisição de namespace rejeitada retorna, porque um cliente que lê uma delas trata a outra como sucesso.
-Dois emissores respondem sob `https://api.azion.com/v4/workspace/kv/namespaces`, a coleção e o caminho do recurso abaixo dela. O serviço KV responde uma falha de validação, um namespace inexistente e um erro de servidor com `state` definido como `error` e um objeto `error`, onde `code` é uma string em snake_case como `validation_error` ou `namespace_not_found` e o texto está em `message`. O gateway da plataforma responde um método não suportado com um array `errors`, onde `code` é numérico, o texto está em `title` e `detail`, e `status` repete o status HTTP. Os dois não compartilham nenhuma key. Um cliente que lê `errors[0].detail` não encontra nada em todo `400` e `404` que o serviço KV levanta, e um cliente que lê `error.message` não encontra nada no `405` que um `DELETE` retorna de `https://api.azion.com/v4/workspace/kv/namespaces/{name}`, o caminho do recurso.
+Dois emissores respondem sob `https://api.azion.com/v4/workspace/kv/namespaces`, a coleção e o caminho do recurso abaixo dela. O serviço KV responde uma falha de validação, um namespace inexistente e um erro de servidor com `state` definido como `error` e um objeto `error`. Nesse objeto, `code` é uma string em snake_case como `validation_error` ou `namespace_not_found`, e o texto está em `message`. O gateway da plataforma responde um método não suportado com um array `errors`, onde `code` é numérico, o texto está em `title` e `detail`, e `status` repete o status HTTP.
+
+Os dois não compartilham nenhuma key. Um cliente que lê `errors[0].detail` não encontra nada em todo `400` e `404` que o serviço KV levanta. Um cliente que lê `error.message` não encontra nada no `405` que um `DELETE` retorna de `https://api.azion.com/v4/workspace/kv/namespaces/{name}`, o caminho do recurso.
```javascript
// Retorna uma mensagem para qualquer um dos envelopes com que uma requisição de namespace pode responder.
@@ -90,7 +94,7 @@ function kvErrorMessage(body) {
}
```
-O terceiro ramo não é decoração. Um caminho que o gateway não roteia responde com uma página HTML em vez de qualquer um dos envelopes, então um cliente que analisa o corpo como JSON precisa de um lugar para esse caso cair. Para os dois envelopes por completo, e o `code` e a `message` que cada falha retorna, consulte [Namespaces](/pt-br/documentacao/plataforma/kv-store/namespaces/).
+O terceiro ramo não é decoração. Um caminho que o gateway não roteia responde com uma página HTML em vez de qualquer um dos envelopes. Por isso, um cliente que analisa o corpo como JSON precisa de um lugar para esse caso cair. Para os dois envelopes por completo, e o `code` e a `message` que cada falha retorna, consulte [Namespaces](/pt-br/documentacao/plataforma/kv-store/namespaces/).
O custo são dois parsers para um endpoint, e um teste da forma do corpo antes de qualquer campo ser lido dele. Um cliente que ganha um terceiro caminho de falha depois tem que adicioná-lo nos dois ramos.
@@ -100,7 +104,9 @@ O custo são dois parsers para um endpoint, e um teste da forma do corpo antes d
Componha toda key a partir de dados que a requisição já carrega, porque nenhuma interface lista as keys que um namespace guarda.
-O cliente expõe `get`, `getWithMetadata`, `put` e `delete`, e nada mais. Não existe `list`, não existe `keys` e não existe enumeração do conteúdo de um namespace, nem no cliente nem na Azion API v4, então uma key só é alcançável por um nome que o código consiga produzir de novo. O esquema de nomes é o que substitui a listagem. Um separador usado em todo lugar o mantém legível: dois-pontos entre um prefixo que nomeia o tipo de registro e o identificador que seleciona um deles, como em `session:42` e `flag:new-checkout`. Uma key que nada consegue nomear de novo é também uma key que nada consegue remover, já que `delete` recebe a key, então dê a um registro com tempo de vida natural uma expiração quando você o escreve e deixe que ele saia sozinho.
+O cliente expõe `get`, `getWithMetadata`, `put` e `delete`, e nada mais. Não existe `list`, não existe `keys` e não existe enumeração do conteúdo de um namespace, nem no cliente nem na Azion API v4. Assim, uma key só é alcançável por um nome que o código consiga produzir de novo.
+
+O esquema de nomes é o que substitui a listagem. Um separador usado em todo lugar o mantém legível: dois-pontos entre um prefixo que nomeia o tipo de registro e o identificador que seleciona um deles, como em `session:42` e `flag:new-checkout`. Uma key que nada consegue nomear de novo é também uma key que nada consegue remover, já que `delete` recebe a key. Por isso, dê a um registro com tempo de vida natural uma expiração quando você o escreve e deixe que ele saia sozinho.
```javascript
export default {
diff --git a/apps/docs/src/content/docs/pt-br/pages/store/kv-store/como-funciona.mdx b/apps/docs/src/content/docs/pt-br/pages/store/kv-store/como-funciona.mdx
index e3ae973f4f..7249c0fcc4 100644
--- a/apps/docs/src/content/docs/pt-br/pages/store/kv-store/como-funciona.mdx
+++ b/apps/docs/src/content/docs/pt-br/pages/store/kv-store/como-funciona.mdx
@@ -62,7 +62,7 @@ flowchart TD
Dois desses passos acontecem uma vez e os demais acontecem a cada requisição. Criar o namespace, instanciar a function e escrever a regra são feitos com antecedência; abrir o cliente e chamar um método acontecem toda vez que a function executa.
-Resolver o namespace pelo nome no momento em que o cliente abre mantém a function livre de um binding e de uma credencial, e custa a quem chama uma falha que chega em tempo de execução. Um nome que não corresponde a nenhum namespace da conta lança um erro em `Azion.KV.open`, na requisição que precisava do valor, e não no deploy da function.
+Resolver o namespace pelo nome no momento em que o cliente abre mantém a function livre de um binding e de uma credencial. O custo para quem chama é uma falha que chega em tempo de execução. Um nome que não corresponde a nenhum namespace da conta lança um erro em `Azion.KV.open`, na requisição que precisava do valor, e não no deploy da function.
---
@@ -72,13 +72,13 @@ KV Store é eventualmente consistente. Uma escrita é aplicada onde chega e fica
O que uma leitura garante, portanto, é que ela retorna um valor escrito naquela key, não que retorna o mais recente. A janela é limitada, e não indefinida, e não é zero: uma escrita fica visível em todos os lugares em até 60 segundos, ou no valor de `cacheTtl` quando a leitura define um. Projete para a convergência, e não para o número, porque uma carga que quebra com um valor de um minuto atrás precisa de outra abordagem, e não de uma espera mais curta.
-Uma leitura pode alargar essa janela por conta própria. `cacheTtl` em `get` e `getWithMetadata` mantém o resultado em cache pelos segundos que ele indica, então toda leitura dessa key dentro desse intervalo é respondida a partir do resultado em cache, e não do store, incluindo as leituras feitas depois que uma escrita mais nova já foi aplicada. O número definido em `cacheTtl` é a defasagem que quem chama aceita em troca da leitura.
+Uma leitura pode alargar essa janela por conta própria. `cacheTtl` em `get` e `getWithMetadata` mantém o resultado em cache pelos segundos que ele indica. Toda leitura dessa key dentro desse intervalo é respondida a partir do resultado em cache, e não do store. Isso inclui as leituras feitas depois que uma escrita mais nova já foi aplicada. O número definido em `cacheTtl` é a defasagem que quem chama aceita em troca da leitura.
O `delete` converge do mesmo jeito. A key deixa de resolver onde o `delete` foi aplicado, e uma leitura respondida em outro lugar retorna o valor antigo até que o `delete` a alcance.
-Escritas concorrentes em uma mesma key não são mescladas, e nada as ordena por você: a última escrita vence e o outro valor se perde. O cliente não tem incremento atômico nem compare-and-set, e nenhuma operação abrange mais de uma key como unidade, então nada agrupa várias escritas em uma única alteração que ou é aplicada inteira ou não é aplicada. Um valor que várias requisições atualizam ao mesmo tempo, como um contador ou um total acumulado, perde atualizações aqui em vez de acumulá-las.
+Escritas concorrentes em uma mesma key não são mescladas, e nada as ordena por você: a última escrita vence e o outro valor se perde. O cliente não tem incremento atômico nem compare-and-set, e nenhuma operação abrange mais de uma key como unidade. Como resultado, nada agrupa várias escritas em uma única alteração que ou é aplicada inteira ou não é aplicada. Um valor que várias requisições atualizam ao mesmo tempo, como um contador ou um total acumulado, perde atualizações aqui em vez de acumulá-las.
-Uma consequência vale ser incorporada ao código. Quem chama não lê uma key de volta para confirmar a escrita que acabou de defini-la, porque a resolução da própria promise da escrita é a confirmação, e a leitura que vem em seguida pode ser respondida por uma cópia que a escrita ainda não alcançou. Quem tratar essa leitura como uma escrita que falhou repete uma escrita que já teve sucesso. Convergir em segundo plano mantém a leitura respondível perto da requisição que a fez, e custa a quem chama a garantia de que o que se lê é o que foi escrito por último.
+Uma consequência vale ser incorporada ao código. Quem chama não lê uma key de volta para confirmar a escrita que acabou de defini-la. A resolução da própria promise da escrita é a confirmação, e a leitura que vem em seguida pode ser respondida por uma cópia que a escrita ainda não alcançou. Quem tratar essa leitura como uma escrita que falhou repete uma escrita que já teve sucesso. Convergir em segundo plano mantém a leitura respondível perto da requisição que a fez, e custa a quem chama a garantia de que o que se lê é o que foi escrito por último.
---
@@ -88,11 +88,11 @@ KV Store tem exatamente duas interfaces, e elas não se sobrepõem. A Azion API
Nenhuma das duas alcança a metade da outra. O cliente não cria namespace: `Azion.KV.open` abre um que já existe, e um nome que a conta não possui lança `NotFound` em vez de criá-lo. A API não lê key: a coleção que guardaria as keys de um namespace não existe, então nenhuma chamada de API retorna um valor.
-Os dois lados veem um namespace, não duas cópias dele. O namespace que uma chamada de API criou é o namespace que uma function abre sob o mesmo nome, e um valor escrito a partir de uma function está nesse mesmo namespace que a API lista.
+Os dois lados veem um namespace, não duas cópias dele. O namespace que uma chamada de API criou é o namespace que uma function abre sob o mesmo nome. Um valor escrito a partir de uma function está nesse mesmo namespace que a API lista.
Essa separação explica a maior parte do que surpreende quem lê sobre o produto. Uma function não consegue provisionar o próprio armazenamento, então um namespace existe antes do deploy do código que o abre. Um namespace não pode ser removido de uma function, porque não pode ser removido de jeito nenhum. E não há tela no Azion Console, comando da Azion CLI nem recurso do Terraform para nenhuma das metades: as duas interfaces acima são toda a superfície do produto.
-Separá-las mantém a credencial fora da function, já que `Azion.KV` é um global de runtime alcançado sem token e sem linha de import, e custa a quem chama uma etapa de provisionamento que o código não consegue executar sozinho.
+Separá-las mantém a credencial fora da function, já que `Azion.KV` é um global de runtime alcançado sem token e sem linha de import. O custo para quem chama é uma etapa de provisionamento que o código não consegue executar sozinho.
---
@@ -100,11 +100,11 @@ Separá-las mantém a credencial fora da function, já que `Azion.KV` é um glob
KV Store é cobrado em três medidores. Storage conta os dados que a conta guarda em KV Store. Keys Read conta cada key que uma leitura retorna. Keys Written conta cada key que uma escrita afeta, o que inclui um `delete` e uma atualização de metadata, além de um `put`.
-Os medidores contam keys, não chamadas. Uma leitura que nomeia um array de keys é uma chamada e tantas keys quantas voltarem dela, e uma function que escreve uma key por requisição gasta uma escrita por requisição, qualquer que seja o tamanho do valor que ela armazenou.
+Os medidores contam keys, não chamadas. Uma leitura que nomeia um array de keys é uma chamada e tantas keys quantas voltarem dela. Uma function que escreve uma key por requisição gasta uma escrita por requisição, qualquer que seja o tamanho do valor que ela armazenou.
Nada na resposta informa essas contagens. Uma leitura retorna o valor e uma escrita resolve sem nada, então o que uma chamada gastou é lido no consumo da conta, e não na própria chamada. Medir uma function contra os medidores significa, portanto, observar a conta, não interpretar um valor de retorno.
-Contar keys em vez de chamadas mantém o preço proporcional aos dados que uma aplicação toca, e custa a quem chama a economia que ele poderia esperar do batching: ler dez keys em uma chamada conta as mesmas dez leituras que dez chamadas separadas contariam. Para o armazenamento e as keys que uma conta inclui em cada medidor, consulte [Limites do KV Store](/pt-br/documentacao/plataforma/kv-store/limites/).
+Contar keys em vez de chamadas mantém o preço proporcional aos dados que uma aplicação toca. O custo para quem chama é a economia que ele poderia esperar do batching. Ler dez keys em uma chamada conta as mesmas dez leituras que dez chamadas separadas contariam. Para o armazenamento e as keys que uma conta inclui em cada medidor, consulte [Limites do KV Store](/pt-br/documentacao/plataforma/kv-store/limites/).
---
diff --git a/apps/docs/src/content/docs/pt-br/pages/store/kv-store/limites.mdx b/apps/docs/src/content/docs/pt-br/pages/store/kv-store/limites.mdx
index 5b8ff2978d..1f7f8a4c48 100644
--- a/apps/docs/src/content/docs/pt-br/pages/store/kv-store/limites.mdx
+++ b/apps/docs/src/content/docs/pt-br/pages/store/kv-store/limites.mdx
@@ -48,7 +48,7 @@ Os limites abaixo se aplicam aos dados que uma função armazena, e não ao name
| `expirationTtl` mínimo | 60 segundos |
| `cacheTtl` mínimo | 60 segundos |
-O cliente não aplica nenhum deles. Ele verifica que `expirationTtl` e `expiration` são números e que `metadata` é uma string ou um objeto, e repassa o resto, então um value acima de um desses limites é rejeitado pela plataforma, e não pelo código que o enviou. Para o que cada opção faz, consulte [Cliente KV](/pt-br/documentacao/devtools/runtime/api-reference/kv-store/).
+O cliente não aplica nenhum deles. Ele verifica que `expirationTtl` e `expiration` são números e que `metadata` é uma string ou um objeto. Ele repassa o resto. Por isso, um value acima de um desses limites é rejeitado pela plataforma, e não pelo código que o enviou. Para o que cada opção faz, consulte [Cliente KV](/pt-br/documentacao/devtools/runtime/api-reference/kv-store/).
---
diff --git a/apps/docs/src/content/docs/pt-br/pages/store/kv-store/namespaces.mdx b/apps/docs/src/content/docs/pt-br/pages/store/kv-store/namespaces.mdx
index 53fb0829a4..2bf5dca956 100644
--- a/apps/docs/src/content/docs/pt-br/pages/store/kv-store/namespaces.mdx
+++ b/apps/docs/src/content/docs/pt-br/pages/store/kv-store/namespaces.mdx
@@ -31,7 +31,7 @@ O nome de um namespace é escolhido na criação e não pode ser alterado depois
Um nome com menos de 3 caracteres, com mais de 63 caracteres ou com um caractere fora do padrão retorna `400` com `validation_error`. Um nome que a conta já tem retorna `400` com a mensagem `Namespace already exists`, e não `409`.
-O padrão aceita letras maiúsculas, então `Orders-EU` é um nome tão válido quanto `orders-eu`, e os dois são **namespaces diferentes**: uma consulta a um responde `200` enquanto o mesmo nome em outra caixa responde `404` com `namespace_not_found`. Minúsculas são uma convenção, e não uma regra, e ela importa porque um namespace não pode ser excluído, então um nome criado na caixa errada é permanente. Para a convenção que Azion recomenda, consulte [Boas práticas](/pt-br/documentacao/plataforma/kv-store/boas-praticas/).
+O padrão aceita letras maiúsculas, então `Orders-EU` é um nome tão válido quanto `orders-eu`. Os dois são **namespaces diferentes**: uma consulta a um responde `200`, enquanto o mesmo nome em outra caixa responde `404` com `namespace_not_found`. Minúsculas são uma convenção, e não uma regra, e ela importa porque um namespace não pode ser excluído, então um nome criado na caixa errada é permanente. Para a convenção que Azion recomenda, consulte [Boas práticas](/pt-br/documentacao/plataforma/kv-store/boas-praticas/).
---
diff --git a/apps/docs/src/content/docs/pt-br/pages/store/kv-store/solucao-de-problemas.mdx b/apps/docs/src/content/docs/pt-br/pages/store/kv-store/solucao-de-problemas.mdx
index 8e50d28b35..b41fce11f8 100644
--- a/apps/docs/src/content/docs/pt-br/pages/store/kv-store/solucao-de-problemas.mdx
+++ b/apps/docs/src/content/docs/pt-br/pages/store/kv-store/solucao-de-problemas.mdx
@@ -12,7 +12,20 @@ import FrameBox from '@aziontech/webkit/frame-box'
import ItemList from '@aziontech/webkit/item-list'
import DocItem from '@aziontech/webkit/doc-item'
-Cada sintoma abaixo é uma string que [KV Store](/pt-br/documentacao/plataforma/kv-store/) retorna: um constructor que lança erro, um argumento que `open` recusa, um namespace que o runtime não encontra enquanto a Azion API o lista, um valor e um tipo de retorno que o cliente recusa, um método delete que não é uma função, um import que faz o build falhar, uma entrada de configuração que não cria nada, um nome duplicado respondido com `400`, um `405` em cada requisição que alteraria um namespace, um `500` em um corpo malformado, um tamanho de página fora da faixa dele e um corpo de erro que um handler lê como vazio.
+Cada sintoma abaixo é uma string que [KV Store](/pt-br/documentacao/plataforma/kv-store/) retorna:
+
+- Um constructor que lança erro.
+- Um argumento que `open` recusa.
+- Um namespace que o runtime não encontra enquanto a Azion API o lista.
+- Um valor e um tipo de retorno que o cliente recusa.
+- Um método delete que não é uma função.
+- Um import que faz o build falhar.
+- Uma entrada de configuração que não cria nada.
+- Um nome duplicado respondido com `400`.
+- Um `405` em cada requisição que alteraria um namespace.
+- Um `500` em um corpo malformado.
+- Um tamanho de página fora da faixa dele.
+- Um corpo de erro que um handler lê como vazio.
---
@@ -20,7 +33,7 @@ Cada sintoma abaixo é uma string que [KV Store](/pt-br/documentacao/plataforma/
Uma função lança `KvError: KV constructor is private, use KV.open(name) instead` na linha que constrói o cliente, antes de qualquer chave ser lida ou escrita. Tanto `new Azion.KV()` quanto `new Azion.KV('my-namespace')` produzem esse erro.
-`Azion.KV` protege o constructor dele, e `open` é o único membro estático que devolve um cliente. A proteção roda antes de o argumento ser examinado, e é por isso que a forma sem argumento falha do mesmo jeito: não existe namespace padrão por trás dela, e a chamada nunca chega longe o bastante para procurar um. `Azion.KV.open` também é assíncrono, então uma chamada que não é aguardada entrega às linhas seguintes uma promise onde elas esperam um cliente, e a primeira chamada de método nessa promise lança outra coisa completamente diferente.
+`Azion.KV` protege o constructor dele, e `open` é o único membro estático que devolve um cliente. A proteção roda antes de o argumento ser examinado, então a forma sem argumento falha do mesmo jeito. Não existe namespace padrão por trás dela, e a chamada nunca chega longe o bastante para procurar um. `Azion.KV.open` também é assíncrono, então uma chamada que não é aguardada entrega às linhas seguintes uma promise onde elas esperam um cliente, e a primeira chamada de método nessa promise lança outra coisa completamente diferente.
- **Substitua o constructor por `await Azion.KV.open(name)`**: ele é o único ponto de entrada, e ele é assíncrono, então a chamada é aguardada.
- **Nomeie um namespace em cada chamada**: nenhuma forma de `open` resolve um padrão, então o argumento é sempre o nome de um namespace que a conta tem.
@@ -49,7 +62,7 @@ export default {
- **Passe o nome como uma string não vazia**: `Azion.KV.open('my-namespace')`.
- **Não passe um identificador de outro produto**: um namespace não tem campo `id`, e `name` é o que o endereça. Para os campos que ele carrega, consulte [Namespaces](/pt-br/documentacao/plataforma/kv-store/namespaces/).
-- **Verifique a variável antes da chamada**: um nome construído a partir de uma requisição ou de um valor de configuração pode chegar como `undefined` ou como uma string vazia, e qualquer um dos dois alcança `open` como um tipo inválido.
+- **Verifique a variável antes da chamada**: um nome construído a partir de uma requisição ou de um valor de configuração pode chegar como `undefined` ou como uma string vazia. Qualquer um dos dois alcança `open` como um tipo inválido.
`open` então resolve o nome contra a conta, e um nome que nenhum namespace carrega levanta um erro `NotFound` que o nomeia.
@@ -59,12 +72,12 @@ export default {
`Azion.KV.open` rejeita com `NotFound: KV namespace "my-namespace" does not exist` dentro de uma função implantada, enquanto `GET /v4/workspace/kv/namespaces` retorna esse mesmo nome em `results`. Um nome que nenhum namespace carrega produz a mensagem idêntica, então o erro não separa os dois casos.
-`open` resolve o nome contra a visão que o runtime tem da conta antes de retornar um cliente, e essa visão é separada daquela de onde a API de gerenciamento responde. `open` pode continuar recusando um namespace que a API lista, enquanto `Azion.Storage` é construído normalmente na mesma requisição e `env` e `ctx` são ambos objetos vazios. Isso descarta uma falha geral de alcançar os stores e descarta um binding ausente. Duas leituras continuam abertas e nenhuma pode ser resolvida a partir da função: uma propagação da API de gerenciamento para o runtime que não terminou, e um direito de acesso ao Preview que cobre a API de gerenciamento sem cobrir o runtime.
+`open` resolve o nome contra a visão que o runtime tem da conta antes de retornar um cliente, e essa visão é separada daquela de onde a API de gerenciamento responde. `open` pode continuar recusando um namespace que a API lista, enquanto `Azion.Storage` é construído normalmente na mesma requisição e `env` e `ctx` são ambos objetos vazios. Isso descarta uma falha geral de alcançar os stores e descarta um binding ausente. Duas leituras continuam abertas, e nenhuma pode ser resolvida a partir da função. Uma é uma propagação da API de gerenciamento para o runtime que não terminou. A outra é um direito de acesso ao Preview que cobre a API de gerenciamento sem cobrir o runtime.
- **Compare o nome caractere por caractere**: os nomes diferenciam maiúsculas de minúsculas, então a string que o `open` recebe precisa ser idêntica à que a requisição de criação enviou, inclusive na caixa.
- **Confirme o namespace pela Azion API**: `GET /v4/workspace/kv/namespaces/{name}` responde `200` com o namespace, ou `404` com `namespace_not_found`. Para a operação, consulte [Namespaces](/pt-br/documentacao/plataforma/kv-store/namespaces/).
- **Confirme que a conta tem o acesso ao Preview do KV Store**: KV Store é um produto em Preview, e o acesso é concedido por conta mediante solicitação. Para os canais, consulte [Technical Support](/pt-br/documentacao/suporte/).
-- **Reporte quando as três verificações se confirmarem**: um namespace que a API retorna e o runtime recusa não é algo que a função possa corrigir, então ele vai para o time de suporte técnico com o nome do namespace e o horário da chamada.
+- **Reporte quando as três verificações se confirmarem**: um namespace que a API retorna e o runtime recusa não é algo que a função possa corrigir. Por isso, ele vai para o time de suporte técnico com o nome do namespace e o horário da chamada.
As três verificações separam um nome que você mesmo pode corrigir de uma condição que só o time de suporte técnico pode resolver, que é o que a mensagem idêntica de outro modo esconde.
@@ -74,9 +87,9 @@ As três verificações separam um nome que você mesmo pode corrigir de uma con
`kv.put(key, value)` rejeita com `INVALID_VALUE_TYPE` e não escreve nada. O valor é um `Map`, um `Set`, um `WeakMap`, um `WeakSet`, um `RegExp` ou um `SharedArrayBuffer`.
-`put` serializa um valor que ele ainda não tem como texto ou como bytes, e a serialização JSON retorna `{}` para cada uma dessas seis formas. Escrever uma delas armazenaria, portanto, um objeto vazio sob a chave e seria resolvida como um sucesso, e a leitura seguinte retornaria `{}` sem nada que mostrasse que as entradas, os membros ou o padrão foram descartados. O cliente recusa o valor em vez disso, então a perda aparece na escrita, na linha que a causou, em vez de em uma leitura em outro ponto da aplicação.
+`put` serializa um valor que ele ainda não tem como texto ou como bytes, e a serialização JSON retorna `{}` para cada uma dessas seis formas. Escrever uma delas armazenaria, portanto, um objeto vazio sob a chave e seria resolvida como um sucesso. A leitura seguinte retornaria `{}`, sem nada que mostrasse que as entradas, os membros ou o padrão foram descartados. O cliente recusa o valor em vez disso, então a perda aparece na escrita, na linha que a causou, em vez de em uma leitura em outro ponto da aplicação.
-- **Converta um `Map` ou um `Set` antes de armazená-lo**: um `Map` vira um array das entradas dele e um `Set` vira um array dos membros dele, e os dois serializam para o que carregam.
+- **Converta um `Map` ou um `Set` antes de armazená-lo**: um `Map` vira um array das entradas dele. Um `Set` vira um array dos membros dele, e os dois serializam para o que carregam.
- **Armazene as partes de um `RegExp` em vez do objeto**: `source` e `flags` são strings, e a expressão é reconstruída a partir delas na leitura.
- **Passe um `ArrayBuffer` ou uma view de typed array para dados binários**: `put` aceita os dois, e uma view é escrita com o `byteOffset` e o `byteLength` dela respeitados.
@@ -126,7 +139,7 @@ O build para na linha do import e nenhum bundle é produzido:
[Azion] [Build] › ✖ error Build failed with 1 error
```
-Não existe módulo `azion:kv`. `Azion.KV` é um global do [Azion Runtime](/pt-br/documentacao/devtools/runtime/), presente em toda função sem linha de import e sem credencial, e um module specifier para ele nunca existiu. A falha é lida errado com frequência, porque um specifier vizinho se comporta de outro jeito: `azion:storage` resolve no mesmo projeto com o mesmo bundler, então uma função que alcança dois stores falha em um import e constrói o outro. A biblioteca `azion` também não cobre isso, porque o pacote publicado não exporta nenhuma entrada de KV.
+Não existe módulo `azion:kv`. `Azion.KV` é um global do [Azion Runtime](/pt-br/documentacao/devtools/runtime/), presente em toda função sem linha de import e sem credencial, e um module specifier para ele nunca existiu. A falha é lida errado com frequência, porque um specifier vizinho se comporta de outro jeito. O specifier `azion:storage` resolve no mesmo projeto com o mesmo bundler. Por isso, uma função que alcança dois stores falha em um import e constrói o outro. A biblioteca `azion` também não cobre isso, porque o pacote publicado não exporta nenhuma entrada de KV.
- **Remova a linha de import**: `Azion.KV` é alcançável sem ela, e nada toma o lugar dela no topo do arquivo.
- **Abra o cliente a partir do global**: `const kv = await Azion.KV.open('my-namespace');` dentro do handler.
@@ -147,7 +160,9 @@ export default {
};
```
-A entrada é aceita em cada etapa que poderia recusá-la e usada em nenhuma. A chave é declarada nas definições de tipo da configuração, então um editor a aceita; o build a valida e a leva para o manifesto; o deploy lê o manifesto e reporta sucesso. Um namespace é criado por uma única requisição, `POST /v4/workspace/kv/namespaces` na Azion API. O silêncio é o que torna isso caro: uma função implantada junto com essa entrada abre um namespace que nunca foi criado, e o sintoma que chega até você é um `NotFound` de `Azion.KV.open` em vez de algo que aponte para a configuração.
+A entrada é aceita em cada etapa que poderia recusá-la e usada em nenhuma. A chave é declarada nas definições de tipo da configuração, então um editor a aceita. O build a valida e a leva para o manifesto. O deploy lê o manifesto e reporta sucesso.
+
+Um namespace é criado por uma única requisição, `POST /v4/workspace/kv/namespaces` na Azion API. O silêncio é o que torna isso caro: uma função implantada junto com essa entrada abre um namespace que nunca foi criado. O sintoma que chega até você é um `NotFound` de `Azion.KV.open`, em vez de algo que aponte para a configuração.
- **Crie o namespace pela Azion API**: um `POST` para `/v4/workspace/kv/namespaces` carregando `name` no corpo. Para a requisição e a resposta que ela retorna, consulte [Namespaces](/pt-br/documentacao/plataforma/kv-store/namespaces/).
- **Remova a entrada `kv` do `azion.config.js`**: ela não cria nada, e deixá-la no lugar dá a entender que o namespace é provisionado junto com a função.
@@ -165,7 +180,7 @@ O namespace então existe antes do primeiro deploy, e `Azion.KV.open` recebe um
{"state":"error","error":{"code":"validation_error","message":"Namespace already exists","details":{"field":"name"}}}
```
-O serviço de KV reporta cada recusa do corpo de criação sob um status e um código. Um nome com menos de 3 caracteres, um nome com mais de 63, um nome carregando um caractere fora de `^[a-zA-Z0-9_-]+$`, um `name` ausente e um nome que a conta já tem respondem todos `400` com `validation_error` em `code`, e só `message` os separa. Um nome é único dentro da conta e ele é permanente, então a colisão é com um namespace que fica com aquele nome dali em diante.
+O serviço de KV reporta cada recusa do corpo de criação sob um status e um código. Um nome com menos de 3 caracteres ou com mais de 63 responde `400` com `validation_error` em `code`. O mesmo vale para um nome carregando um caractere fora de `^[a-zA-Z0-9_-]+$`, um `name` ausente ou um nome que a conta já tem. Só `message` os separa. Um nome é único dentro da conta e ele é permanente, então a colisão é com um namespace que fica com aquele nome dali em diante.
- **Decida por `error.message` em vez do status**: `400` com `validation_error` cobre cada recusa do corpo, e a mensagem nomeia qual regra foi quebrada.
- **Liste o que a conta já tem**: `GET /v4/workspace/kv/namespaces` retorna cada nome em `results`. Para a operação, consulte [Namespaces](/pt-br/documentacao/plataforma/kv-store/namespaces/).
@@ -183,7 +198,7 @@ A requisição de criação então responde `201`, e a resposta carrega `name`,
{"errors":[{"code":"10007","title":"Method Not Allowed","detail":"Method \"DELETE\" not allowed.","status":"405","source":{"pointer":"/data"},"meta":{"method":"DELETE"}}]}
```
-Três operações existem no recurso e nenhuma delas altera um namespace. `OPTIONS` na coleção responde `allow: GET, POST, HEAD, OPTIONS`, e `OPTIONS` em um namespace único responde `allow: GET, HEAD, OPTIONS`. Não há renomeação, nem desativação, nem esvaziamento, nem exclusão, na Azion API ou em qualquer outra interface. Um namespace é, portanto, permanente a partir do momento em que a requisição de criação responde `201`, e o `405` é a resposta inteira em vez de uma permissão a solicitar ou um header a adicionar.
+Três operações existem no recurso e nenhuma delas altera um namespace. `OPTIONS` na coleção responde `allow: GET, POST, HEAD, OPTIONS`, e `OPTIONS` em um namespace único responde `allow: GET, HEAD, OPTIONS`. Não há renomeação, nem desativação, nem esvaziamento, nem exclusão, na Azion API ou em qualquer outra interface. Um namespace é, portanto, permanente a partir do momento em que a requisição de criação responde `201`. O `405` é a resposta inteira, em vez de uma permissão a solicitar ou um header a adicionar.
- **Leia o header `allow` antes de escrever o cliente**: `OPTIONS` em qualquer um dos dois caminhos retorna os métodos que existem.
- **Remova chaves em vez do namespace**: `kv.delete(key)` de dentro de uma função remove uma chave por vez. Para o método, consulte [Cliente KV](/pt-br/documentacao/devtools/runtime/api-reference/kv-store/).
@@ -202,7 +217,7 @@ A conta então trabalha com criar, listar e recuperar, que é toda a superfície
{"state":"error","error":{"code":"internal_error","message":"Internal server error","details":{}}}
```
-Dois erros comuns de cliente chegam ao serviço sem tratamento: um corpo que não é JSON válido, e um `name` carregando um tipo diferente de string, como `{"name":123}`. Os dois pertencem à família `400` que o endpoint usa para cada outra recusa do corpo, e Azion acompanha essa divergência como um defeito do serviço em vez de um comportamento contra o qual escrever código. O que isso significa para você é que esse status não reporta uma indisponibilidade e não justifica uma nova tentativa: o corpo é o que olhar.
+Dois erros comuns de cliente chegam ao serviço sem tratamento: um corpo que não é JSON válido, e um `name` carregando um tipo diferente de string, como `{"name":123}`. Os dois pertencem à família `400` que o endpoint usa para cada outra recusa do corpo. Azion acompanha essa divergência como um defeito do serviço, em vez de um comportamento contra o qual escrever código. O que isso significa para você é que esse status não reporta uma indisponibilidade e não justifica uma nova tentativa: o corpo é o que olhar.
- **Valide o JSON antes de a requisição ser enviada**: um corpo truncado ou uma chave sem aspas produz esse status em vez de um erro de parsing que nomeie o caractere.
- **Envie `name` como uma string**: `{"name":"my-namespace"}`, e nunca um número ou um booleano nesse campo.
@@ -220,7 +235,7 @@ A requisição de criação então responde `201` com o namespace, ou `400` com
{"state":"error","error":{"code":"invalid_page_size","message":"Page size must be between 1 and 100","details":{}}}
```
-`page_size` aceita de 1 a 100 e usa 50 por padrão. Uma requisição acima do teto é recusada em vez de reduzida a ele, então um cliente que pede cada namespace em uma resposta não recebe nada em vez de receber os primeiros cem. A listagem pagina, e o envelope do KV Store não é o que o resto da Azion API v4 usa: os namespaces ficam em `results`, e os campos de paginação ficam sob um objeto `pagination` que carrega `page`, `page_size`, `total_count`, `total_pages`, `has_next` e `has_previous`.
+`page_size` aceita de 1 a 100 e usa 50 por padrão. Uma requisição acima do teto é recusada em vez de reduzida a ele, então um cliente que pede cada namespace em uma resposta não recebe nada em vez de receber os primeiros cem. A listagem pagina. O envelope do KV Store não é o que o resto da Azion API v4 usa. Os namespaces ficam em `results`, e os campos de paginação ficam sob um objeto `pagination`. Esse objeto carrega `page`, `page_size`, `total_count`, `total_pages`, `has_next` e `has_previous`.
- **Mantenha `page_size` entre 1 e 100**: 50 é o que o endpoint usa quando o parâmetro está ausente.
- **Percorra as páginas com `has_next`**: envie `page` uma vez por página até `has_next` ler `false`.