> ## 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

> Gérez les révisions JavaScript de CloudScript classique et les inscriptions Azure Functions qu'utilise CloudScript.

La famille de commandes `playfab cloudscript` est expérimentale. Son interface CLI peut changer
ou être supprimée en fonction des retours.

Gérez CloudScript classique, le JavaScript qu'héberge PlayFab, avec `classic`, et les Azure
Functions qu'appelle CloudScript, avec `function`. Aucune de ces commandes ne demande de confirmation avant de
s'exécuter.

## `playfab cloudscript classic`

| Commande | Chemin de l'API PlayFab | Options |
| - | - | - |
| `playfab cloudscript classic revision get` | `/Admin/GetCloudScriptRevision` | `--version` et `--revision` facultatives ; toutes deux correspondent par défaut à la plus récente. |
| `playfab cloudscript classic version list` | `/Admin/GetCloudScriptVersions` | Aucune. |
| `playfab cloudscript classic revision create` | `/Admin/UpdateCloudScript` | `--file` (obligatoire), un fichier JavaScript à charger en tant que nouvelle révision. `--publish` met également la nouvelle révision en ligne. |
| `playfab cloudscript classic revision publish` | `/Admin/SetPublishedRevision` | `--version` et `--revision` (toutes deux obligatoires). |

## `playfab cloudscript function`

`function` inscrit des Azure Functions existantes auprès de PlayFab, afin que CloudScript puisse les appeler. Elle
ne crée et ne modifie rien dans Azure.

| Commande | Chemin de l'API PlayFab | Options |
| - | - | - |
| `playfab cloudscript function list` | `/CloudScript/ListFunctions`, ou avec `--type`, `/CloudScript/ListHttpFunctions`, `/CloudScript/ListQueuedFunctions` ou `/CloudScript/ListEventHubFunctions` | `--type` facultative : `http`, `queued` ou `eventhub`. Omettez-la pour répertorier toutes les inscriptions. |
| `playfab cloudscript function register` | `/CloudScript/RegisterHttpFunction` | `--type http`, `--name` et `--url` (toutes obligatoires) ; `--key-file` facultative. `http` est le seul type que vous pouvez inscrire. |
| `playfab cloudscript function unregister` | `/CloudScript/UnregisterFunction` | `--name` (obligatoire). |

### Clés de fonction

Une Azure Function déclenchée par HTTP avec une autorisation au niveau de la fonction, le paramètre par défaut d'Azure, a besoin
de sa clé de fonction. Passez la clé dans un fichier plutôt que dans l'URL, afin qu'elle n'apparaisse pas dans l'historique du shell
ni dans les listes de processus :

| Option | Description |
| - | - |
| `--url <url>` | L'URL de la fonction, sans sa clé. Une URL comportant un paramètre de requête `code` est refusée. |
| `--key-file <path>` | Un fichier contenant la clé de fonction, telle que l'affiche le portail Azure, ou `-` pour la lire depuis stdin redirigé. Les espaces blancs qui l'entourent sont supprimés. Omettez-la pour une fonction qui n'a pas besoin de clé. |

La CLI ajoute la clé à l'URL sous la forme `code`, et inscrit la même URL que celle qu'affiche
**Get function URL** dans le portail Azure.

## Sortie sous forme de tableau

Ces commandes acceptent `--output table` ; les autres non. Consultez
[Sortie sous forme de tableau](https://docs.xbox.com/fr/tools/xbox-cli/commands.md#table-output).

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

Pour voir l'URL d'une inscription et d'autres détails, utilisez la sortie 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
```

## Exemples

Vérifier la version publiée et lire une révision :

```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
```

Charger `main.js` en tant que nouvelle révision :

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

`create` renvoie le `Version` et le `Revision` de la nouvelle révision. Après avoir examiné la révision,
publiez-la avec ces numéros :

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

Répertorier les inscriptions de fonctions HTTP :

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

Inscrire une fonction dont la clé se trouve dans `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
```

Pour lire plutôt la clé depuis stdin, par exemple depuis un magasin de secrets :

```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 -
```

Inscrire une fonction qui n'a pas besoin de clé :

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

Désinscrire `MatchWebhook` :

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


## Related topics

- [CloudScript](https://docs.xbox.com/fr/services/playfab/live-service-management/service-gateway/automation/cloudscript/index.md)
- [Exécuter Cloud Script](https://docs.xbox.com/fr/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)
- [Écriture de CloudScript personnalisé](https://docs.xbox.com/fr/services/playfab/live-service-management/service-gateway/automation/cloudscript/writing-custom-cloudscript.md)
- [Démarrage rapide de CloudScript](https://docs.xbox.com/fr/services/playfab/live-service-management/service-gateway/automation/cloudscript/quickstart.md)
