> ## 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 Classic CloudScript et les inscriptions Azure Functions qu'utilise CloudScript.

La famille de commandes `playfab cloudscript` est expérimentale. Son interface CLI pourrait changer
ou être retirée en fonction des commentaires.

Gérez Classic CloudScript, 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; les 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 à téléverser comme nouvelle révision. `--publish` met aussi 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 comportement par défaut d'Azure, a besoin
de sa clé de fonction. Transmettez la clé dans un fichier plutôt que dans l'URL, afin qu'elle n'apparaisse pas dans l'historique de
l'interpréteur de commandes 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 à partir de stdin redirigé. Les espaces autour 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 ne l'acceptent pas. Consultez
[Sortie sous forme de tableau](https://docs.xbox.com/fr-CA/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 et les autres détails d'une inscription, 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
```

Téléverser `main.js` comme nouvelle révision :

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

`create` retourne les valeurs `Version` et `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é à partir de stdin, par exemple à partir d'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-CA/services/playfab/live-service-management/service-gateway/automation/cloudscript/index.md)
- [Execute Cloud Script](https://docs.xbox.com/api-reference/server-side-cloud-script/execute-cloud-script.md)
- [Exécuter Cloud Script](https://docs.xbox.com/fr-CA/services/playfab/api-references/rest/server/server-side-cloud-script/execute-cloud-script.md)
- [Écriture de CloudScript personnalisé](https://docs.xbox.com/fr-CA/services/playfab/live-service-management/service-gateway/automation/cloudscript/writing-custom-cloudscript.md)
- [Démarrage rapide de CloudScript](https://docs.xbox.com/fr-CA/services/playfab/live-service-management/service-gateway/automation/cloudscript/quickstart.md)
