> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# CloudScript

> Administra las revisiones de JavaScript de Classic CloudScript y los registros de Azure Functions que usa CloudScript.

La familia de comandos `playfab cloudscript` es experimental. Su interfaz de la CLI puede cambiar
o quitarse en función de los comentarios.

Administra Classic CloudScript, el JavaScript que hospeda PlayFab, con `classic`, y las funciones de Azure
Functions a las que llama CloudScript, con `function`. Ninguno de estos comandos pregunta antes de
ejecutarse.

## `playfab cloudscript classic`

| Comando | Ruta de la API de PlayFab | Opciones |
| - | - | - |
| `playfab cloudscript classic revision get` | `/Admin/GetCloudScriptRevision` | `--version` y `--revision` opcionales; ambas tienen como valor predeterminado la más reciente. |
| `playfab cloudscript classic version list` | `/Admin/GetCloudScriptVersions` | Ninguna. |
| `playfab cloudscript classic revision create` | `/Admin/UpdateCloudScript` | `--file` (obligatoria), un archivo JavaScript que se carga como una nueva revisión. `--publish` también hace que la nueva revisión pase a estar activa. |
| `playfab cloudscript classic revision publish` | `/Admin/SetPublishedRevision` | `--version` y `--revision` (ambas obligatorias). |

## `playfab cloudscript function`

`function` registra funciones de Azure Functions existentes con PlayFab, para que CloudScript pueda llamarlas.
No crea ni cambia nada en Azure.

| Comando | Ruta de la API de PlayFab | Opciones |
| - | - | - |
| `playfab cloudscript function list` | `/CloudScript/ListFunctions` o, con `--type`, `/CloudScript/ListHttpFunctions`, `/CloudScript/ListQueuedFunctions` o `/CloudScript/ListEventHubFunctions` | `--type` opcional: `http`, `queued` o `eventhub`. Omítela para enumerar todos los registros. |
| `playfab cloudscript function register` | `/CloudScript/RegisterHttpFunction` | `--type http`, `--name` y `--url` (todas obligatorias); `--key-file` opcional. `http` es el único tipo que puedes registrar. |
| `playfab cloudscript function unregister` | `/CloudScript/UnregisterFunction` | `--name` (obligatoria). |

### Claves de función

Una función de Azure Functions desencadenada por HTTP con autorización de nivel de función, el valor predeterminado de Azure, necesita
su clave de función. Pasa la clave en un archivo en lugar de en la URL, para que no quede en el historial
del shell ni en las listas de procesos:

| Opción | Descripción |
| - | - |
| `--url <url>` | La URL de la función, sin su clave. Se rechaza una URL con un parámetro de consulta `code`. |
| `--key-file <path>` | Un archivo que contiene la clave de función, tal como la muestra Azure Portal, o `-` para leerla de stdin canalizado. Se recortan los espacios en blanco iniciales y finales. Omítela para una función que no necesita clave. |

La CLI agrega la clave a la URL como `code` y registra la misma URL que muestra
**Obtener la dirección URL de la función** (**Get function URL**) en Azure Portal.

## Salida en tabla

Estos comandos aceptan `--output table`; los demás no. Consulta
[Salida en tabla](https://docs.xbox.com/es/tools/xbox-cli/commands.md#table-output).

| Comando | Columnas |
| - | - |
| `playfab cloudscript classic version list` | `VERSION`, `PUBLISHED REVISION`, `LATEST REVISION` |
| `playfab cloudscript function list` | `FUNCTION NAME` |

Para ver la URL y otros detalles de un registro, usa la salida JSON.

```bash theme={null}
xbox --playfab-title-id ABC123 playfab cloudscript classic version list --output table
```

```text theme={null}
VERSION  PUBLISHED REVISION  LATEST REVISION
-------  ------------------  ---------------
1        3                   5
2        1                   1
```

## Ejemplos

Comprobar la versión publicada y leer una revisión:

```bash theme={null}
xbox --playfab-title-id ABC123 playfab cloudscript classic version list
xbox --playfab-title-id ABC123 playfab cloudscript classic revision get --version 1 --revision 2
```

Cargar `main.js` como una nueva revisión:

```bash theme={null}
xbox --playfab-title-id ABC123 playfab cloudscript classic revision create --file main.js
```

`create` devuelve los valores `Version` y `Revision` de la nueva revisión. Después de revisarla,
publícala con esos números:

```bash theme={null}
xbox --playfab-title-id ABC123 playfab cloudscript classic revision publish --version 1 --revision 3
```

Enumerar los registros de funciones HTTP:

```bash theme={null}
xbox --playfab-title-id ABC123 playfab cloudscript function list --type http
```

Registrar una función cuya clave está en `function-key.txt`:

```bash theme={null}
xbox --playfab-title-id ABC123 playfab cloudscript function register --type http --name MatchWebhook --url https://nodpublishers.azurewebsites.net/api/MatchWebhook --key-file ./function-key.txt
```

Para leer la clave de stdin, por ejemplo desde un almacén de secretos:

```bash theme={null}
get-function-key | xbox --playfab-title-id ABC123 playfab cloudscript function register --type http --name MatchWebhook --url https://nodpublishers.azurewebsites.net/api/MatchWebhook --key-file -
```

Registrar una función que no necesita clave:

```bash theme={null}
xbox --playfab-title-id ABC123 playfab cloudscript function register --type http --name PublicStatus --url https://nodpublishers.azurewebsites.net/api/PublicStatus
```

Anular el registro de `MatchWebhook`:

```bash theme={null}
xbox --playfab-title-id ABC123 playfab cloudscript function unregister --name MatchWebhook
```


## Related topics

- [CloudScript](https://docs.xbox.com/es/services/playfab/live-service-management/service-gateway/automation/cloudscript/index.md)
- [Escribir CloudScript personalizado](https://docs.xbox.com/es/services/playfab/live-service-management/service-gateway/automation/cloudscript/writing-custom-cloudscript.md)
- [Ejecutar Cloud Script](https://docs.xbox.com/es/services/playfab/api-references/rest/client/server-side-cloud-script/execute-cloud-script.md)
- [Execute Cloud Script](https://docs.xbox.com/api-reference/server-side-cloud-script/execute-cloud-script.md)
- [Inicio rápido de CloudScript](https://docs.xbox.com/es/services/playfab/live-service-management/service-gateway/automation/cloudscript/quickstart.md)
