---
sourceDocument: Référence de l’API Xanadu
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/fr-FR/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - fr-FR

ft:publication_title :

    - Référence de l’API Xanadu

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# API REST de l'utilisateur test de l'exécuteur dans le cloud

# API REST de l'utilisateur test de l'exécuteur dans le cloud {#ariaid-title1}

* Rversion finale: Xanadu
* 
* Mis à jour 1 août 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 12 minutes de lecture

Gère les tâches de l'utilisateur test à exécuter dans un exécuteur dans le cloud pour Framework de tests automatisés (ATF).
L'API utilisateur de test de l'exécuteur cloud nécessite le module d'extension [ATF Test Generator and Cloud Runner](https://www.servicenow.com/docs/access?context=atf-tg-cr-intro&version=xanadu&pubname=xanadu-servicenow-platform&ft:locale=en-US) (sn_atf_tg). Les méthodes disponibles avec cette API s'exécutent dans l'espace de noms Now et peuvent être appelées à l'aide de Nom d'API, Test de régression en un clic pour ATF, dans l'explorateur d'API REST. Le rôle administrateur est requis pour accéder à cette API.  
Vous pouvez utiliser cette API pour les tâches suivantes :

* Démarrez la tâche de test de l'utilisateur.
* Définissez l'utilisateur du cloud.
* Vérifiez si l'utilisateur spécifié est valide.
* Vérifiez la progression de la tâche de test de l'utilisateur.
* Annulez la tâche de test.
{#cloudrunner-testuser-api__cloudrnr-TestUserAPI-scoped_ul_vwb_wvn_31c}

L'API de test exécutable Cloud Runner peut être utilisée en tandem avec le [API REST de génération du test de l'exécuteur dans le cloud](https://servicenow-prod.fluidtopics.net/LzsfFVawGYcOPu7tJcrYqA#cloudrunner-testgeneration-api "Gère la génération de tâches de test à exécuter dans un exécuteur dans le cloud pour Framework de tests automatisés (ATF).") et [API REST de l'utilisateur test de l'exécuteur dans le cloud](https://servicenow-prod.fluidtopics.net/NZcWhnv_11ZWmrNp7fooZg#cloudrunner-testuser-api "Gère les tâches de l’utilisateur test à exécuter dans un exécuteur dans le cloud pour Framework de tests automatisés (ATF)."). Par exemple, vous pouvez générer un test (API de génération de tests de l'exécuteur cloud), puis obtenir la progression du test dans la file d'attente d'orchestration du navigateur (API de génération de tests de l'exécuteur cloud) et vérifier le nombre de tests qui ont réussi ou échoué.

Pour afficher la documentation de référence de l'API serveur de cette API, reportez-vous à la section [TestUserAPI de l'exécuteur dans le cloud : délimité, global](https://servicenow-prod.fluidtopics.net/fG_00zkvb3lrJnKxtgmoog#cloudrnr-TestUserAPI-scoped "Gère les tâches de l’utilisateur test à exécuter dans un exécuteur dans le cloud pour Framework de tests automatisés (ATF). Cette API fait partie de l’include de script CloudRunnerApi.").

## Utilisateur test de l'exécuteur dans le cloud : GET /now/sn_atf_tg/test_user_progress {#ariaid-title2}

Fournit l'état de la tâche d'utilisateur de test pour un enregistrement de file d'attente d'orchestration du navigateur (BOQ) fourni.

### Format d'URL

URL par défaut : GET /api/now/sn_atf_tg/test_user_progress

### Paramètres de demande pris en charge

{#cr-TestUserAPI-GET-test-user-progress__entry__2}

| Nom | Description |
|-|-|
| Aucun |   |
[Tableau 1. Paramètres de chemin d'accès]

{#cr-TestUserAPI-GET-test-user-progress__entry__6}

| Nom | Description |
|-|-|
| snboqId | Requis. L'enregistrement BOQ sys_id de la tâche d'utilisateur test dont vous souhaitez obtenir la progression. Situé dans la table BOQ \[sn_atf_tg_sn_boq\]. Type de données : chaîne |
[Tableau 2. Paramètres de requête]

{#cr-TestUserAPI-GET-test-user-progress__entry__10}

| Nom | Description |
|-|-|
| Aucun |   |
[Tableau 3. Paramètres de corps de demande (XML ou JSON)]

### En-têtes

Les en-têtes de demande et de réponse suivants s'appliquent à cette action HTTP uniquement ou s'appliquent à cette action d'une manière distincte. Pour obtenir la liste des en-têtes généraux utilisés dans l'API REST, consultez [En-têtes d'API REST pris en charge](https://servicenow-prod.fluidtopics.net/CFQa7z9NIrhoOq1u1cRN7g "REST (REpresentational State Transfer) est une architecture simple sans état qui fournit des normes entre les systèmes informatiques sur le Web, ce qui leur permet de communiquer plus facilement les uns avec les autres.").
{#cr-TestUserAPI-GET-test-user-progress__entry__14}{#cr-TestUserAPI-GET-test-user-progress__accept-RESTAPI}

| En-tête | Description |
|-|-|
| Accepter | Format de données du corps de la réponse. Types pris en charge : application/json ou application/xml. Valeur par défaut : application/json |
[Tableau 4. En-têtes de demandes]

{#cr-TestUserAPI-GET-test-user-progress__entry__18}

| En-tête | Description |
|-|-|
| Aucun |   |
[Tableau 5. En-têtes de réponses]

### Codes d'état

Les codes d'état suivants s'appliquent à cette action HTTP. Pour obtenir la liste des codes d'état possibles utilisés dans l'API REST, consultez [Codes de réponse HTTP de l'API REST](https://servicenow-prod.fluidtopics.net/CFQa7z9NIrhoOq1u1cRN7g "REST (REpresentational State Transfer) est une architecture simple sans état qui fournit des normes entre les systèmes informatiques sur le Web, ce qui leur permet de communiquer plus facilement les uns avec les autres.").
{#cr-TestUserAPI-GET-test-user-progress__table_u3v_zh3_j1c__entry__2}

| Code d'état | Description |
|-|-|
| 200 | La progression de la tâche de l'utilisateur de test a été récupérée avec succès. |
| 400 | Erreur lors de l'obtention de l'état de l'enregistrement BOQ. Renvoie l'un des messages suivants : * Aucun ID de BOQ transmis -- Aucun ID de BOQ n'a été fourni. Ajoutez l'ID BOQ au corps de la demande. * Impossible de trouver l'enregistrement BOQ -- ID système non valide. Vérifiez que la sys_id de l'enregistrement BOQ est valide et que l'enregistrement existe. {#cr-TestUserAPI-GET-test-user-progress__ul_d5p_btk_p1c} |
| 403 | Erreur lors de l'octroi de l'accès de l'utilisateur au point de terminaison. Assurez-vous que l'utilisateur dispose du rôle administrateur. |
[Tableau 6. Codes d'état]

{#cr-TestUserAPI-GET-test-user-progress__table_u3v_zh3_j1c}

### Paramètres du corps de réponse (JSON ou XML)

{#cr-TestUserAPI-GET-test-user-progress__entry__30}

| Nom | Description |
|-|-|
| résultat | Objet contenant les résultats de progression de la tâche de test exécutable ou un message expliquant pourquoi la demande a échoué. "result": { "progress": 100, "state": "completed" } {#cr-TestUserAPI-GET-test-user-progress__codeblock_tqb_gth_41c} Ou: "result": { "message": "String" } Type de données : objet |
| résultat.message | Message d'erreur expliquant pourquoi la progression du test exécutable ne peut pas être récupérée. Le paramètre de message n'est pas renvoyé dans une réponse réussie. Type de données : chaîne |
| résultat.progrès | Pourcentage indiquant à quel point un test est proche de l'achèvement lorsqu'il est à l'état En cours d'exécution. Type de données : nombre |
| résultat.état | État actuel de l'enregistrement de la nomenclature. Valeurs possibles : * En attente : l'activité de test demandée a été créée et attend d'être exécutée. * Traitement : l'instance recherche les enregistrements pour s'assurer que les suivis des exécutions sont marqués pour l'exécuteur dans le cloud avant que la demande ne soit envoyée à l'infrastructure dans le cloud. * Navigateurs demandés : une demande a été envoyée à l'infrastructure dans le cloud pour démarrer les navigateurs pour la génération ou l'exécution de tests. * En cours d'exécution : les navigateurs d'infrastructure cloud trouvent et exécutent les tests en attente. * Terminée : la tâche de test est terminée. * État d'échec : échec de la tâche de test. {#cr-TestUserAPI-GET-test-user-progress__ul_hph_y5h_41c} Type de données : chaîne |
[ ]

### Demande cURL

L'exemple de demande suivant montre comment vérifier la progression d'une tâche d'utilisateur test.

    curl "https://instance.service-now.com/api/now/sn_atf_tg/test_user_progress?snboqId=<sys_id of SNBOQ record>" \ 
    --request GET \ 
    --header "Accept:application/json" \ 
    --user "username:password"

Corps de réponse :

    { 
      "result": { 
        "progress": 100, 
        "state": "completed" 
      } 
    }

## Utilisateur test de l'exécuteur dans le cloud : GET /now/sn_atf_tg/is_valid_cloud_user {#ariaid-title3}

Vérifie si un utilisateur fourni est un utilisateur cloud valide.
Cette méthode vérifie si l'utilisateur répond aux critères suivants :

* Existe
* Est actif,
* N'est pas verrouillé,
* Nécessite une réinitialisation du mot de passe,
* Est administrateur,
* Est en lecture seule,
* Est uniquement un service web

### Format d'URL

URL par défaut : GET /api/now/sn_atf_tg/is_valid_cloud_user

### Paramètres de demande pris en charge

{#cr-TestUserAPI-GET-is_valid_cloud_user__entry__2}

| Nom | Description |
|-|-|
| Aucun |   |
[Tableau 7. Paramètres de chemin d'accès]

{#cr-TestUserAPI-GET-is_valid_cloud_user__entry__6}

| Nom | Description |
|-|-|
| nom d'utilisateur | Requis. Nom d'utilisateur du sys_user pour vérifier si l'utilisateur répond aux critères de base de référence suivants. * Existe * Est actif, * N'est pas verrouillé, * Nécessite une réinitialisation du mot de passe, * Est administrateur, * Est en lecture seule, * Est uniquement un service web {#cr-TestUserAPI-GET-is_valid_cloud_user__ul_orh_qnl_p1c} Si l'une de ces conditions échoue, l'API renvoie un faux booléen avec un message indiquant quel critère a échoué. Type de données : chaîne |
[Tableau 8. Paramètres de requête]

{#cr-TestUserAPI-GET-is_valid_cloud_user__entry__10}

| Nom | Description |
|-|-|
| Aucun |   |
[Tableau 9. Paramètres de corps de demande (XML ou JSON)]

### En-têtes

Les en-têtes de demande et de réponse suivants s'appliquent à cette action HTTP uniquement ou s'appliquent à cette action d'une manière distincte. Pour obtenir la liste des en-têtes généraux utilisés dans l'API REST, consultez [En-têtes d'API REST pris en charge](https://servicenow-prod.fluidtopics.net/CFQa7z9NIrhoOq1u1cRN7g "REST (REpresentational State Transfer) est une architecture simple sans état qui fournit des normes entre les systèmes informatiques sur le Web, ce qui leur permet de communiquer plus facilement les uns avec les autres.").
{#cr-TestUserAPI-GET-is_valid_cloud_user__entry__14}{#cr-TestUserAPI-GET-is_valid_cloud_user__accept-RESTAPI}

| En-tête | Description |
|-|-|
| Accepter | Format de données du corps de la réponse. Types pris en charge : application/json ou application/xml. Valeur par défaut : application/json |
[Tableau 10. En-têtes de demandes]

{#cr-TestUserAPI-GET-is_valid_cloud_user__entry__18}

| En-tête | Description |
|-|-|
| Aucun |   |
[Tableau 11. En-têtes de réponses]

### Codes d'état

Les codes d'état suivants s'appliquent à cette action HTTP. Pour obtenir la liste des codes d'état possibles utilisés dans l'API REST, consultez [Codes de réponse HTTP de l'API REST](https://servicenow-prod.fluidtopics.net/CFQa7z9NIrhoOq1u1cRN7g "REST (REpresentational State Transfer) est une architecture simple sans état qui fournit des normes entre les systèmes informatiques sur le Web, ce qui leur permet de communiquer plus facilement les uns avec les autres.").
{#cr-TestUserAPI-GET-is_valid_cloud_user__table_u3v_zh3_j1c__entry__2}

| Code d'état | Description |
|-|-|
| 200 | Renvoie vrai ou faux si l'utilisateur est valide et répond aux critères d'utilisateur du cloud. |
| 403 | Erreur lors de l'octroi de l'accès de l'utilisateur au point de terminaison. Assurez-vous que l'utilisateur dispose du rôle administrateur. |
[Tableau 12. Codes d'état]

{#cr-TestUserAPI-GET-is_valid_cloud_user__table_u3v_zh3_j1c}

### Paramètres du corps de réponse (JSON ou XML)

{#cr-TestUserAPI-GET-is_valid_cloud_user__entry__28}

| Nom | Description |
|-|-|
| résultat | Objet contenant les résultats de la demande. "result": { "validUser": Boolean } {#cr-TestUserAPI-GET-is_valid_cloud_user__codeblock_hhp_4k2_p1c} Type de données : objet |
| result.validUser | Marqueur indiquant si l'utilisateur répond aux critères d'utilisateur du cloud. Si la valeur est vrai, indique que l'utilisateur répond aux critères. Type de données : booléennes |
[ ]

### Demande cURL

La demande suivante vérifie si le sys_user fourni répond aux critères d'utilisation de la fonctionnalité cloud.

    curl "http://instance.service-now.com/api/now/sn_atf_tg/is_valid_cloud_user?username=<username of sys_user to check>" \ 
    --request GET \ 
    --header "Accept:application/json" \ 
    --user "username:password"

Corps de réponse :

    { 
      "result": { 
        "validUser": <Boolean value indicating whether user is valid cloud user> 
      } 
    }

## Utilisateur test de l'exécuteur dans le cloud : POST /now/sn_atf_tg/test_user {#ariaid-title4}

Insère une tâche d'utilisateur test dans la table BOQ \[sn_atf_tg_sn_boq\] pour un nom d'utilisateur donné, qui est ensuite exécutée sur l'exécuteur dans le cloud.

### Format d'URL

URL par défaut : POST /api/now/sn_atf_tg/test_user

### Paramètres de demande pris en charge

{#cr-TestUserAPI-POST-test-user__entry__2}

| Nom | Description |
|-|-|
| Aucun |   |
[Tableau 13. Paramètres de chemin d'accès]

{#cr-TestUserAPI-POST-test-user__entry__6}

| Nom | Description |
|-|-|
| Aucun |   |
[Tableau 14. Paramètres de requête]

{#cr-TestUserAPI-POST-test-user__entry__10}

| Nom | Description |
|-|-|
| nom d'utilisateur | Requis. Nom d'utilisateur du sys_user pour tester l'infrastructure de bout en bout de l'exécuteur dans le cloud. Type de données : chaîne |
[Tableau 15. Paramètres de corps de demande (XML ou JSON)]

### En-têtes

Les en-têtes de demande et de réponse suivants s'appliquent à cette action HTTP uniquement ou s'appliquent à cette action d'une manière distincte. Pour obtenir la liste des en-têtes généraux utilisés dans l'API REST, consultez [En-têtes d'API REST pris en charge](https://servicenow-prod.fluidtopics.net/CFQa7z9NIrhoOq1u1cRN7g "REST (REpresentational State Transfer) est une architecture simple sans état qui fournit des normes entre les systèmes informatiques sur le Web, ce qui leur permet de communiquer plus facilement les uns avec les autres.").
{#cr-TestUserAPI-POST-test-user__table_xh4_cfj_41c__entry__2}{#cr-TestUserAPI-POST-test-user__accept-RESTAPI}{#cr-TestUserAPI-POST-test-user__content_type-RESTAPI}

| En-tête | Description |
|-|-|
| Accepter | Format de données du corps de la réponse. Types pris en charge : application/json ou application/xml. Valeur par défaut : application/json |
| Content-Type | Format de données du corps de la demande. Types pris en charge : application/json ou application/xml. Valeur par défaut : application/json |
[Tableau 16. En-têtes de demandes]

{#cr-TestUserAPI-POST-test-user__table_xh4_cfj_41c} {#cr-TestUserAPI-POST-test-user__entry__20}

| En-tête | Description |
|-|-|
| Aucun |   |
[Tableau 17. En-têtes de réponses]

### Codes d'état

Les codes d'état suivants s'appliquent à cette action HTTP. Pour obtenir la liste des codes d'état possibles utilisés dans l'API REST, consultez [Codes de réponse HTTP de l'API REST](https://servicenow-prod.fluidtopics.net/CFQa7z9NIrhoOq1u1cRN7g "REST (REpresentational State Transfer) est une architecture simple sans état qui fournit des normes entre les systèmes informatiques sur le Web, ce qui leur permet de communiquer plus facilement les uns avec les autres.").
{#cr-TestUserAPI-POST-test-user__entry__24}

| Code d'état | Description |
|-|-|
| 200 | Une tâche BOQ d'utilisateur test a été insérée avec succès. |
| 400 | Erreur lors du démarrage de la tâche de l'utilisateur de test. Si un nom d'utilisateur vide est fourni ou si un utilisateur est introuvable dans sys_user table, le serveur génère une erreur. |
| 403 | Erreur lors de l'octroi de l'accès de l'utilisateur au point de terminaison. Assurez-vous que l'utilisateur dispose du rôle administrateur. |
[Tableau 18. Codes d'état]

### Paramètres du corps de réponse (JSON ou XML)

{#cr-TestUserAPI-POST-test-user__entry__32}

| Nom | Description |
|-|-|
| résultat | Objet contenant les résultats de la demande. "result": { "snboqId": String } Ou: "result": { "message": "String" } Type de données : objet |
| résultat.message | Message d'erreur expliquant pourquoi des options de test ne peuvent pas être affectées au nom d'utilisateur. Le paramètre de message n'est pas renvoyé dans une réponse réussie. Type de données : chaîne |
| result.snboqId | Sys_id de l'enregistrement BOQ qui est inséré lorsque le travail de l'utilisateur test démarre avec succès. Situé dans la table BOQ \[sn_atf_tg_sn_boq\]. Type de données : chaîne |
[ ]

### Demande cURL

L'exemple de demande suivant montre comment insérer une tâche d'utilisateur test dans la table BOQ \[sn_atf_tg_sn_boq\] pour un nom d'utilisateur donné.

    curl "http://instance.service-now.com/api/now/sn_atf_tg/test_user" \ 
    --request POST \ 
    --header "Accept:application/json" \ 
    --header "Content-Type:application/json" \ 
    --data "{\"username\":\"<username of sys_user to test cloud infrastructure>\"}" \ 
    --user "username:password"

La réponse renvoie une sys_id de l'enregistrement BOQ qui est inséré au démarrage du travail de l'utilisateur test.

    { 
      "result": { 
        "snboqId": "<sys_id of newly inserted BOQ record>" 
      } 
    }

L'exemple suivant renvoie un message d'erreur 400 lorsqu'aucun nom d'utilisateur ou un nom d'utilisateur non valide n'est transmis.

    curl "https://instance.service-now.com/api/now/sn_atf_tg/test_user" \
    --request POST \
    --header "Accept:application/json" \
    --user "username:password"

Réponse :

    {
      "result": {
        "message": "Unable to set cloud user as cloud user not valid"
      }
    }

## Utilisateur test de l'exécuteur dans le cloud : POST /now/sn_atf_tg/cancel_test_user {#ariaid-title5}

Définit l'état de la tâche de l'utilisateur test dans la table File d'attente Orchestration du navigateur (BOQ) \[sn_atf_tg_sn_boq\] pour terminer.

### Format d'URL

URL par défaut : POST /api/now/sn_atf_tg/cancel_test_user

### Paramètres de demande pris en charge

{#cr-TestUserAPI-POST-cancel-test-user__entry__2}

| Nom | Description |
|-|-|
| Aucun |   |
[Tableau 19. Paramètres de chemin d'accès]

{#cr-TestUserAPI-POST-cancel-test-user__entry__6}

| Nom | Description |
|-|-|
| Aucun |   |
[Tableau 20. Paramètres de requête]

{#cr-TestUserAPI-POST-cancel-test-user__entry__10}

| Nom | Description |
|-|-|
| snboqId | Requis. Sys_id de l'enregistrement BOQ à annuler associé à la tâche d'utilisateur test. Situé dans la table SNBOQ \[sn_atf_tg_sn_boq\]. Type de données : chaîne |
[Tableau 21. Paramètres de corps de demande (XML ou JSON)]

### En-têtes

Les en-têtes de demande et de réponse suivants s'appliquent à cette action HTTP uniquement ou s'appliquent à cette action d'une manière distincte. Pour obtenir la liste des en-têtes généraux utilisés dans l'API REST, consultez [En-têtes d'API REST pris en charge](https://servicenow-prod.fluidtopics.net/CFQa7z9NIrhoOq1u1cRN7g "REST (REpresentational State Transfer) est une architecture simple sans état qui fournit des normes entre les systèmes informatiques sur le Web, ce qui leur permet de communiquer plus facilement les uns avec les autres.").
{#cr-TestUserAPI-POST-cancel-test-user__table_m4k_dfj_41c__entry__2}{#cr-TestUserAPI-POST-cancel-test-user__accept-RESTAPI}{#cr-TestUserAPI-POST-cancel-test-user__content_type-RESTAPI}

| En-tête | Description |
|-|-|
| Accepter | Format de données du corps de la réponse. Types pris en charge : application/json ou application/xml. Valeur par défaut : application/json |
| Content-Type | Format de données du corps de la demande. Types pris en charge : application/json ou application/xml. Valeur par défaut : application/json |
[Tableau 22. En-têtes de demandes]

{#cr-TestUserAPI-POST-cancel-test-user__table_m4k_dfj_41c} {#cr-TestUserAPI-POST-cancel-test-user__entry__20}

| En-tête | Description |
|-|-|
| Aucun |   |
[Tableau 23. En-têtes de réponses]

### Codes d'état

Les codes d'état suivants s'appliquent à cette action HTTP. Pour obtenir la liste des codes d'état possibles utilisés dans l'API REST, consultez [Codes de réponse HTTP de l'API REST](https://servicenow-prod.fluidtopics.net/CFQa7z9NIrhoOq1u1cRN7g "REST (REpresentational State Transfer) est une architecture simple sans état qui fournit des normes entre les systèmes informatiques sur le Web, ce qui leur permet de communiquer plus facilement les uns avec les autres.").
{#cr-TestUserAPI-POST-cancel-test-user__table_u3v_zh3_j1c__entry__2}

| Code d'état | Description |
|-|-|
| 200 | La tâche BOQ a été annulée avec succès. |
| 400 | Erreur lors de l'annulation de la tâche. Renvoie l'un des messages suivants : * Aucun ID de BOQ transmis -- Aucun ID de BOQ n'a été fourni. Ajoutez l'ID BOQ au corps de la demande. * Impossible de trouver l'enregistrement BOQ -- ID système non valide. Vérifiez que la sys_id de l'enregistrement BOQ est valide et que l'enregistrement existe. {#cr-TestUserAPI-POST-cancel-test-user__ul_fzp_ztk_p1c} |
| 403 | Erreur lors de l'octroi de l'accès de l'utilisateur au point de terminaison. Assurez-vous que l'utilisateur dispose du rôle administrateur. |
[Tableau 24. Codes d'état]

{#cr-TestUserAPI-POST-cancel-test-user__table_u3v_zh3_j1c}

### Paramètres du corps de réponse (JSON ou XML)

{#cr-TestUserAPI-POST-cancel-test-user__entry__32}

| Nom | Description |
|-|-|
| résultat | Objet contenant les résultats de la demande. "result": { "message": String } {#cr-TestUserAPI-POST-cancel-test-user__codeblock_hhp_4k2_p1c} Type de données : objet |
| résultat.message | Message détaillant si l'annulation de l'utilisateur test a réussi. Type de données : chaîne |
[ ]

### Demande cURL

La demande suivante montre comment annuler une tâche d'utilisateur test dans la table File d'attente Orchestration du navigateur \[sn_atf_tg_sn_boq\].

    curl "https://instance.service-now.com/api/now/sn_atf_tg/cancel_test_user" \ 
    --request POST \ 
    --header "Accept:application/json" \ 
    --header "Content-Type:application/json" \ 
    --data "{\"snboqId\":\"<sys_id of BOQ record>\"}" \ 
    --user "username:password"

Corps de réponse correct :

    { 
      "result": { 
        "message": "success" 
      } 
    }

## Utilisateur test de l'exécuteur dans le cloud : POST /now/sn_atf_tg/select_cloud_user {#ariaid-title6}

Démarre une tâche d'utilisateur test de bout en bout sur l'exécuteur dans le cloud. Si l'utilisateur est en mesure de se connecter avec le rôle administrateur, la propriété d'utilisateur cloud est définie par défaut sur cet utilisateur pour les exécutions et générations de tests futures.

### Format d'URL

URL par défaut : POST /api/now/sn_atf_tg/select_cloud_user

### Paramètres de demande pris en charge

{#cr-TestUserAPI-POST-select-cloud-user__entry__2}

| Nom | Description |
|-|-|
| Aucun |   |
[Tableau 25. Paramètres de chemin d'accès]

{#cr-TestUserAPI-POST-select-cloud-user__entry__6}

| Nom | Description |
|-|-|
| Aucun |   |
[Tableau 26. Paramètres de requête]

{#cr-TestUserAPI-POST-select-cloud-user__entry__10}

| Nom | Description |
|-|-|
| nom d'utilisateur | Requis. Nom d'utilisateur du sys_user à tester et définir l'utilisateur du cloud pour les futures tâches d'exécution de test et de génération de test. Type de données : chaîne |
[Tableau 27. Paramètres de corps de demande (XML ou JSON)]

### En-têtes

Les en-têtes de demande et de réponse suivants s'appliquent à cette action HTTP uniquement ou s'appliquent à cette action d'une manière distincte. Pour obtenir la liste des en-têtes généraux utilisés dans l'API REST, consultez [En-têtes d'API REST pris en charge](https://servicenow-prod.fluidtopics.net/CFQa7z9NIrhoOq1u1cRN7g "REST (REpresentational State Transfer) est une architecture simple sans état qui fournit des normes entre les systèmes informatiques sur le Web, ce qui leur permet de communiquer plus facilement les uns avec les autres.").
{#cr-TestUserAPI-POST-select-cloud-user__table_g43_2fj_41c__entry__2}{#cr-TestUserAPI-POST-select-cloud-user__accept-RESTAPI}{#cr-TestUserAPI-POST-select-cloud-user__content_type-RESTAPI}

| En-tête | Description |
|-|-|
| Accepter | Format de données du corps de la réponse. Types pris en charge : application/json ou application/xml. Valeur par défaut : application/json |
| Content-Type | Format de données du corps de la demande. Types pris en charge : application/json ou application/xml. Valeur par défaut : application/json |
[Tableau 28. En-têtes de demandes]

{#cr-TestUserAPI-POST-select-cloud-user__table_g43_2fj_41c} {#cr-TestUserAPI-POST-select-cloud-user__entry__20}

| En-tête | Description |
|-|-|
| Aucun |   |
[Tableau 29. En-têtes de réponses]

### Codes d'état

Les codes d'état suivants s'appliquent à cette action HTTP. Pour obtenir la liste des codes d'état possibles utilisés dans l'API REST, consultez [Codes de réponse HTTP de l'API REST](https://servicenow-prod.fluidtopics.net/CFQa7z9NIrhoOq1u1cRN7g "REST (REpresentational State Transfer) est une architecture simple sans état qui fournit des normes entre les systèmes informatiques sur le Web, ce qui leur permet de communiquer plus facilement les uns avec les autres.").
{#cr-TestUserAPI-POST-select-cloud-user__table_u3v_zh3_j1c__entry__2}

| Code d'état | Description |
|-|-|
| 200 | Test réussi de l'infrastructure de l'exécuteur dans le cloud de bout en bout et définition de l'utilisateur du cloud pour les futures tâches d'exécution de test et de génération des tests. |
| 400 | Erreur lors du test de l'infrastructure d'exécution dans le cloud de bout en bout et lors de la définition de l'utilisateur dans le cloud. Assurez-vous que le nom d'utilisateur n'est pas vide ou que l'utilisateur existe dans la table sys_user pour un nom d'utilisateur donné. |
| 403 | Erreur lors de l'octroi de l'accès de l'utilisateur au point de terminaison. Assurez-vous que l'utilisateur dispose du rôle administrateur. |
[Tableau 30. Codes d'état]

{#cr-TestUserAPI-POST-select-cloud-user__table_u3v_zh3_j1c}

### Paramètres du corps de réponse (JSON ou XML)

{#cr-TestUserAPI-POST-select-cloud-user__entry__32}

| Nom | Description |
|-|-|
| résultat | Objet contenant les résultats de la demande. "result": { "message": "String" } {#cr-TestUserAPI-POST-select-cloud-user__codeblock_hhp_4k2_p1c} Type de données : objet |
| résultat.message | Message détaillant si l'utilisateur a été sélectionné avec succès pour les futures exécutions de tests et générations de tests sur l'infrastructure d'exécution dans le cloud. Type de données : chaîne |
[ ]

### Demande cURL

L'exemple suivant montre comment demander la sélection d'un utilisateur spécifique pour de futures exécutions de tests et générations de tests sur l'infrastructure d'exécution dans le cloud.

    curl "https://instance.service-now.com/api/now/sn_atf_tg/select_cloud_user" \ 
    --request POST \ 
    --header "Accept:application/json" \ 
    --header "Content-Type:application/json" \ 
    --data "{\"username\":\"<username of sys_user to set as cloud user>\"}" \ 
    --user "username:password"

Le corps de la réponse renvoie un message de réussite indiquant que l'utilisateur cloud a été sélectionné avec succès pour les exécutions et générations de tests.

    { 
      "result": { 
        "message": "success" 
      } 
    }