[Vista previa] Actualizar una cuenta de robot

Actualiza la información sobre la cuenta de robot especificada.

Punto final de API

PUT https://{yourDomain}/identity/api/Setting

Ámbitos

Necesita los siguientes ámbitos:

• PM.RobotAccount
• PM.RobotAccount.Write

Solicitar encabezados.

--header 'Authorization: Bearer {access_token}'\
--header 'Content-Type: application/json'

Nota: para obtener el {access_token}, asegúrate de autenticar a través de uno de los métodos descritos aquí.

Parámetros de ruta

Parámetros	Tipo de datos	Descripción
robotAccountId (obligatorio)	Cadena	El ID de la cuenta de UiPath Robot que quieres actualizar.

Solicitar cuerpo

El cuerpo de la solicitud contiene el ID de la organización a la que pertenece la cuenta de UiPath Robot y la información que quieres actualizar, como, por ejemplo, la pertenencia a un grupo.

{
  "partitionGlobalId": "string",
  "displayName": "string",
  "groupIDsToAdd": [
    "string"
  ],
  "groupIDsToRemove": [
    "string"
  ]
}

Respuesta

200 OK

El grupo personalizado se actualiza con la información que has proporcionado.

Solicitud de ejemplo

Supongamos que has recopilado toda la información necesaria para crear la llamada a la API.

• Tu {baseURL} es: https://{yourDomain}/{organizationName}/{tenantName}/
• Tu {access_token} es: 1234 (para consideraciones de longitud)
• El {partitionGlobalId} es: magic-7
• Quieres asignar la cuenta de UiPath Robot con ID 88-uv al grupo con ID alumni-02.

La llamada debe ser similar a lo que mostramos a continuación (cURL):

curl --location --request PUT 'https://{yourDomain}/{organizationName}/{tenantName}/identity_/api/RobotAccount/88-uv' \
--header 'Authorization: Bearer 1234' \
--header 'Content-Type: application/json'
--data-raw '{
    "partitionGlobalId": "magic-7",
    "displayName": "Roby",
    "groupIDsToAdd": [
        "alumni-02"
    ],
    "groupIDsToRemove": []
}'

Esta es la respuesta para una llamada exitosa:

{
    "id": "88-uv",
    "name": "Roby",
    "displayName": "Roby",
    "creationTime": "2021-10-20T12:16:16.6492925",
    "lastLoginTime": null,
    "groupIds": [
        "alumni-02",
        "gryff-01"
    ]
}