Endpoints de roles (2022/06)

42 min

estos endpoints permiten a los usuarios administrar roles en una red url base para estos endpoints https //api bsn cloud/2022/06/rest/roles get / devuelve una lista de roles en una red token de scope requerido bsn api main roles retrieve parámetros de query string marcador \string\ \opcional \ un valor que especifica qué página recuperar este valor es útil si la entrada istruncated en el cuerpo de respuesta de la llamada get anterior indica que la cantidad de instancias de roles excede el pagesize este parámetro solo es requerido si necesita más elementos en la lista paginada que el pagesize (100) pagesize \int\ \opcional \ la cantidad máxima de instancias de roles que pueden incluirse en el cuerpo de respuesta de forma predeterminada, esto utiliza el tamaño máximo de página permitido (100) ejemplo de solicitud los parámetros y encabezados de la solicitud de ejemplo se establecen de la siguiente manera marcador el valor se establece en el valor de la propiedad \[pagedlist] \[nextmarker] de la respuesta anterior de la api de bsn cloud pagesize se establece en 1 get /2022/06/rest/roles/?marker=4kfak45jfk0915nve\&pagesize=1 http/1 1 host api bsn cloud connection keep alive authorization bearer {{useraccesstoken}} accept application/json, application/vnd bsn error+json accept encoding gzip,deflate c uerpo de respuesta exitoso \200\ devuelve una lista paginada docid 1gsmbtulb07tf6mcfqcxp de instancias de entidad de rol docid\ ki9 37ik0ur5jiixwtcho en una red esto devolverá no más de 100 entidades junto con la información necesaria para devolver cualquier otra página restante ejemplo { "items" \[ { "id" 12345, "iscustom" true, "name" "custom role 20231115", "description" "", "creationdate" "2023 11 15t19 14 10 087z", "usercount" 0, "users" null, "permissions" \[ { "entityid" null, "operationuid" "d430853f c05f 61b4 d137 0237a6984032", "principal" { "name" "custom role 20231115", "iscustom" true, "type" "role", "id" 12345 }, "isfixed" false, "isinherited" false, "isallowed" false, "creationdate" "2023 11 15t19 14 10 097z" } ] } ], "totalitemcount" 8, "matchingitemcount" 8, "pagesize" 1, "nextmarker" "cu20afjksdun78q932", "prevmarker" "cu20afjksdun7813rf", "istruncated" true, "sortexpression" "\[role] \[name] asc", "filterexpression" "" } respuesta de error \300\ la representación solicitada no pudo devolverse porque es ambigua (hay múltiples representaciones solicitadas) \400\ la solicitud tiene un formato incorrecto y, por lo tanto, no es válida \401\ el token de acceso no es válido o no se especificó \403\ el token de acceso proporcionado, aunque válido, no proporciona acceso a este método \406\ el servidor no puede devolver la representación de datos que usted solicitó (como se especifica en el encabezado "accept") \5xx\ cualquier código 500 es un error interno del servidor post / crea un rol en una red token de alcance requerido bsn api main roles create cuerpo de la solicitud la entidad de rol docid\ ki9 37ik0ur5jiixwtcho ejemplo de solicitud los parámetros y encabezados de la solicitud de ejemplo se establecen de la siguiente manera post /2022/06/rest/roles/ http/1 1 host api bsn cloud connection keep alive authorization bearer {{useraccesstoken}} accept application/json, application/vnd bsn error+json accept encoding gzip,deflate content type application/json content length 962 este es el cuerpo de la solicitud de ejemplo { "id" 0, "iscustom" true, "name" "custom role 20231115", "description" "", "creationdate" "0001 01 01t00 00 00", "usercount" 0, "users" null, "permissions" \[] } cuerpo de la respuesta exitosa \201\ devuelve la entidad de rol docid\ ki9 37ik0ur5jiixwtcho creada y referenciada por el uri (proporcionado por el campo de encabezado location) en la respuesta ejemplo { "id" 12345, "iscustom" true, "name" "custom role 20231115", "description" "", "creationdate" "2023 11 15t19 14 10 087z", "usercount" 0, "users" null, "permissions" \[] } respuesta de error \300\ la representación solicitada no pudo devolverse porque es ambigua (hay múltiples representaciones solicitadas) \400\ la solicitud o el cuerpo de la solicitud tienen un formato incorrecto y, por lo tanto, no son válidos, o se rechazan de acuerdo con las reglas de negocio \401\ el token de acceso no es válido o no se especificó \403\ el token de acceso proporcionado, aunque válido, no proporciona acceso a este método \406\ el servidor no puede devolver la representación de datos que usted solicitó (como se especifica en el encabezado "accept") \415\ el servidor no puede aceptar la representación de datos que usted envió (como se especifica en el encabezado "content type") \5xx\ cualquier código 500 es un error interno del servidor get /{id}/ devuelve un rol especificado en una red token de alcance requerido bsn api main roles retrieve segmento id \int \ un identificador único para un rol ejemplo de solicitud los parámetros y encabezados de la solicitud de ejemplo se establecen de la siguiente manera id se establece en 12345 get /2022/06/rest/roles/12345/ http/1 1 host api bsn cloud connection keep alive authorization bearer {{useraccesstoken}} accept application/json, application/vnd bsn error+json accept encoding gzip,deflate respuesta correcta con cuerpo \200\ devuelve la entidad de rol docid\ ki9 37ik0ur5jiixwtcho ejemplo este es un ejemplo de una respuesta de nivel 200 { "id" 12345, "iscustom" true, "name" "custom role 20231115", "description" "", "creationdate" "2023 11 15t19 14 10 087z", "usercount" 1, "users" \[ { "login" "janedoe\@brightsign biz", "type" "user", "id" 54321 } ], "permissions" \[ { "entityid" null, "operationuid" "3a67ae65 aa94 477b acab 5291347cef2c", "principal" { "name" "custom role 20231115", "iscustom" true, "type" "role", "id" 12345 }, "isfixed" false, "isinherited" false, "isallowed" false, "creationdate" "2023 12 01t16 37 19 553z" } ] } respuesta de error \300\ no se pudo devolver la representación solicitada porque es ambigua (hay varias representaciones solicitadas) \400\ la solicitud tiene un formato incorrecto y, por lo tanto, no es válida \401\ el token de acceso no es válido o no se especificó \403\ el token de acceso proporcionado, aunque válido, no proporciona acceso a este método \404\ el servidor no puede encontrar el recurso solicitado (la ruta no existe) \406\ el servidor no puede devolver la representación de datos que solicitó (según se especifica en el encabezado "accept") \5xx\ cualquier código 500 es un error interno del servidor put /{id}/ actualiza el rol especificado en una red token de alcance requerido bsn api main roles update segmento id \int \ un identificador único para un rol cuerpo de la solicitud la entidad de rol docid\ ki9 37ik0ur5jiixwtcho ejemplo de solicitud los parámetros y encabezados de la solicitud de ejemplo se establecen de la siguiente manera id se establece en 12345 put /2022/06/rest/roles/12345/ http/1 1 host api bsn cloud connection keep alive authorization bearer {{useraccesstoken}} accept application/json, application/vnd bsn error+json accept encoding gzip,deflate content type application/json content length 756 este es el cuerpo de solicitud de ejemplo { "id" 0, "iscustom" true, "name" "custom role 20231115", "description" "", "creationdate" "0001 01 01t00 00 00", "usercount" 0, "users" null, "permissions" \[ { "entityid" null, "operationuid" "3a67ae65 aa94 477b acab 5291347cef2c", "principal" { "name" "custom role 20231115", "iscustom" true, "type" "role", "id" 12345 }, "isfixed" false, "isinherited" false, "isallowed" false, "creationdate" "0001 01 01t00 00 00" } ] } respuesta correcta \204\ el rol se actualizó correctamente respuesta de error \300\ no se pudo devolver la representación solicitada porque es ambigua (hay múltiples representaciones solicitadas) \400\ la solicitud o el cuerpo de la solicitud tienen un formato incorrecto y, por lo tanto, son inválidos, o se rechazan de acuerdo con las reglas de negocio \401\ el token de acceso es inválido o no se especificó \403\ el token de acceso proporcionado, aunque válido, no proporciona acceso a este método \404\ el servidor no puede encontrar el recurso solicitado (la ruta no existe) \406\ el servidor no puede devolver la representación de datos que usted solicitó (según se especifica en el encabezado "accept") \415\ el servidor no puede aceptar la representación de datos que usted envió (según se especifica en el encabezado "content type") \5xx\ cualquier código 500 es un error interno del servidor delete /{id}/ elimina el rol personalizado especificado en una red token de alcance requerido bsn api main roles delete segmento id \int \ un identificador único para un rol personalizado ejemplo de solicitud los parámetros y encabezados de la solicitud de ejemplo se establecen de la siguiente manera id se establece en 12345 delete /2022/06/rest/roles/12345/ http/1 1 host api bsn cloud connection keep alive authorization bearer {{useraccesstoken}} accept application/json, application/vnd bsn error+json accept encoding gzip,deflate respuesta correcta \204\ el rol especificado ha sido eliminado respuesta de error \300\ no se pudo devolver la representación solicitada porque es ambigua (hay múltiples representaciones solicitadas) \400\ la solicitud o el cuerpo de la solicitud tienen un formato incorrecto y, por lo tanto, son inválidos, o se rechazan de acuerdo con las reglas de negocio (por ejemplo, si el usuario intenta eliminar un rol del sistema) \401\ el token de acceso es inválido o no se especificó \403\ el token de acceso proporcionado, aunque válido, no proporciona acceso a este método \404\ el servidor no puede encontrar el recurso solicitado (la ruta no existe) \406\ el servidor no puede devolver la representación de datos que solicitó (como se especifica en el encabezado "accept") \5xx\ cualquier código 500 es un error interno del servidor get /{name}/ devuelve el rol especificado en una red token de alcance requerido bsn api main roles retrieve segmento nombre \string \ el nombre del rol ejemplo de solicitud los parámetros y encabezados de la solicitud de ejemplo se establecen de la siguiente manera nombre se establece en rol personalizado 20231115 get /2022/06/rest/roles/custom role 20231115/ http/1 1 host api bsn cloud connection keep alive authorization bearer {{useraccesstoken}} accept application/json, application/vnd bsn error+json accept encoding gzip,deflate respuesta correcta con cuerpo \200\ devuelve la entidad de rol docid\ ki9 37ik0ur5jiixwtcho ejemplo este es un ejemplo de una respuesta de nivel 200 { "id" 12345, "iscustom" true, "name" "custom role 20231115", "description" "", "creationdate" "2023 11 15t19 14 10 087z", "usercount" 1, "users" \[ { "login" "janedoe\@brightsign biz", "type" "user", "id" 54321 } ], "permissions" \[ { "entityid" null, "operationuid" "3a67ae65 aa94 477b acab 5291347cef2c", "principal" { "name" "custom role 20231115", "iscustom" true, "type" "role", "id" 12345 }, "isfixed" false, "isinherited" false, "isallowed" false, "creationdate" "2023 12 01t16 37 19 553z" } ] } respuesta de error \300\ la representación solicitada no pudo devolverse porque es ambigua (hay múltiples representaciones solicitadas) \400\ la solicitud tiene un formato incorrecto y, por lo tanto, no es válida \401\ el token de acceso no es válido o no se especificó \403\ el token de acceso proporcionado, aunque válido, no proporciona acceso a este método \404\ el servidor no puede encontrar el recurso solicitado (la ruta no existe) \406\ el servidor no puede devolver la representación de datos que solicitó (como se especifica en el encabezado "accept") \5xx\ cualquier código 500 es un error interno del servidor put /{name}/ actualiza el rol especificado en una red token de alcance requerido bsn api main roles update segmento nombre \string \ el nombre del rol cuerpo de la solicitud la entidad de rol docid\ ki9 37ik0ur5jiixwtcho ejemplo de solicitud los parámetros y encabezados de la solicitud de ejemplo se establecen de la siguiente manera nombre se establece en rol personalizado 20231115 put /2022/06/rest/roles/custom role 20231115/ http/1 1 host api bsn cloud connection keep alive authorization bearer {{useraccesstoken}} accept application/json, application/vnd bsn error+json accept encoding gzip,deflate content type application/json content length 756 este es el cuerpo de la solicitud de ejemplo { "id" 0, "iscustom" true, "name" "custom role 20231115", "description" "", "creationdate" "0001 01 01t00 00 00", "usercount" 0, "users" null, "permissions" \[ { "entityid" null, "operationuid" "3a67ae65 aa94 477b acab 5291347cef2c", "principal" { "name" "custom role 20231115", "iscustom" true, "type" "role", "id" 12345 }, "isfixed" false, "isinherited" false, "isallowed" false, "creationdate" "0001 01 01t00 00 00" } ] } respuesta correcta \204\ el rol se actualizó correctamente respuesta de error \300\ la representación solicitada no pudo devolverse porque es ambigua (hay múltiples representaciones solicitadas) \400\ la solicitud o el cuerpo de la solicitud tienen un formato incorrecto y, por lo tanto, son inválidos, o se rechazan de acuerdo con las reglas de negocio \401\ el token de acceso es inválido o no se especificó \403\ el token de acceso proporcionado, aunque válido, no proporciona acceso a este método \404\ el servidor no puede encontrar el recurso solicitado (la ruta no existe) \406\ el servidor no puede devolver la representación de datos que usted solicitó (según se especifica en el encabezado "accept") \415\ el servidor no puede aceptar la representación de datos que usted envió (según se especifica en el encabezado "content type") \5xx\ cualquier código 500 es un error interno del servidor delete /{name}/ elimina el rol personalizado especificado en una red token de alcance requerido bsn api main roles delete segmento nombre \string \ el nombre del rol personalizado ejemplo de solicitud los parámetros y encabezados de la solicitud de ejemplo se establecen de la siguiente manera nombre se establece en rol personalizado 20231116 delete /2022/06/rest/roles/custom role 20231116/ http/1 1 host api bsn cloud connection keep alive authorization bearer {{useraccesstoken}} accept application/json, application/vnd bsn error+json accept encoding gzip,deflate respuesta correcta \204\ el rol especificado ha sido eliminado respuesta de error \300\ la representación solicitada no pudo devolverse porque es ambigua (hay múltiples representaciones solicitadas) \400\ la solicitud está mal formada y, por lo tanto, no es válida, o se rechaza de acuerdo con las reglas de negocio (por ejemplo, si el usuario intenta eliminar un rol del sistema) \401\ el token de acceso no es válido o no se especificó \403\ el token de acceso proporcionado, aunque válido, no proporciona acceso a este método \404\ el servidor no puede encontrar el recurso solicitado (la ruta no existe) \406\ el servidor no puede devolver la representación de datos que usted solicitó (como se especifica en el encabezado "accept") \5xx\ cualquier código 500 es un error interno del servidor get /operations/ devuelve permisos operativos otorgados a roles para operaciones empresariales específicas token de alcance requerido bsn api main operations retrieve ejemplo de solicitud los parámetros y encabezados de la solicitud de ejemplo se configuran de la siguiente manera get /2022/06/rest/roles/operations/ http/1 1 host api bsn cloud connection keep alive authorization bearer {{useraccesstoken}} accept application/json, application/vnd bsn error+json accept encoding gzip,deflate cuerpo de la respuesta exitosa \200\ devuelve la entidad de operaciones empresariales docid\ bb tauffplmvkrodv93i7 ejemplo { "uid" "027a307a a29d d674 a935 da468ef03091", "singularname" "full control", "pluralname" "role (full control)", "fullname" "role (full control)", "targetentity" "role", "appliance" "instance, collection", "parent" null, "descendants" \[ { "uid" "0b943c8f f889 2074 f152 014cff8c2e5d", "singularname" "view role", "pluralname" "view roles", "fullname" "role (full control) view roles", "targetentity" "role", "appliance" "instance, collection", "parent" { "uid" "027a307a a29d d674 a935 da468ef03091", "singularname" "full control", "pluralname" "role (full control)", "fullname" "role (full control)", "targetentity" "role", "appliance" "instance, collection", "parent" null, "descendants" null, "permissions" null }, "descendants" \[], "permissions" \[ { "entityid" null, "operationuid" "0b943c8f f889 2074 f152 014cff8c2e5d", "principal" { "name" "administrators", "iscustom" false, "type" "role", "id" 1 }, "isfixed" true, "isinherited" true, "isallowed" true, "creationdate" "2024 01 03t01 44 13 16z" }, { "entityid" null, "operationuid" "0b943c8f f889 2074 f152 014cff8c2e5d", "principal" { "name" "general managers", "iscustom" false, "type" "role", "id" 2 }, "isfixed" true, "isinherited" true, "isallowed" false, "creationdate" "2024 01 03t01 44 13 283z" }, { "entityid" null, "operationuid" "0b943c8f f889 2074 f152 014cff8c2e5d", "principal" { "name" "creators", "iscustom" false, "type" "role", "id" 3 }, "isfixed" true, "isinherited" true, "isallowed" false, "creationdate" "2024 01 03t01 44 13 38z" }, { "entityid" null, "operationuid" "0b943c8f f889 2074 f152 014cff8c2e5d", "principal" { "name" "publishers", "iscustom" false, "type" "role", "id" 4 }, "isfixed" true, "isinherited" true, "isallowed" false, "creationdate" "2024 01 03t01 44 13 45z" }, { "entityid" null, "operationuid" "0b943c8f f889 2074 f152 014cff8c2e5d", "principal" { "name" "network managers", "iscustom" false, "type" "role", "id" 5 }, "isfixed" true, "isinherited" true, "isallowed" false, "creationdate" "2024 01 03t01 44 13 62z" }, { "entityid" null, "operationuid" "0b943c8f f889 2074 f152 014cff8c2e5d", "principal" { "name" "viewers", "iscustom" false, "type" "role", "id" 6 }, "isfixed" true, "isinherited" true, "isallowed" false, "creationdate" "2024 01 03t01 44 13 803z" } ] }, { "uid" "f7d768be c485 b4d4 5d98 bc80c329922c", "singularname" "view users", "pluralname" "view users", "fullname" "role (full control) view users", "targetentity" "role", "appliance" "instance, collection", "parent" { "uid" "027a307a a29d d674 a935 da468ef03091", "singularname" "full control", "pluralname" "role (full control)", "fullname" "role (full control)", "targetentity" "role", "appliance" "instance, collection", "parent" null, "descendants" null, "permissions" null }, "descendants" \[], "permissions" \[ { "entityid" null, "operationuid" "f7d768be c485 b4d4 5d98 bc80c329922c", "principal" { "name" "administrators", "iscustom" false, "type" "role", "id" 1 }, "isfixed" true, "isinherited" true, "isallowed" true, "creationdate" "2024 01 03t01 44 13 16z" }, { "entityid" null, "operationuid" "f7d768be c485 b4d4 5d98 bc80c329922c", "principal" { "name" "general managers", "iscustom" false, "type" "role", "id" 2 }, "isfixed" true, "isinherited" true, "isallowed" false, "creationdate" "2024 01 03t01 44 13 283z" }, { "entityid" null, "operationuid" "f7d768be c485 b4d4 5d98 bc80c329922c", "principal" { "name" "creators", "iscustom" false, "type" "role", "id" 3 }, "isfixed" true, "isinherited" true, "isallowed" false, "creationdate" "2024 01 03t01 44 13 38z" }, { "entityid" null, "operationuid" "f7d768be c485 b4d4 5d98 bc80c329922c", "principal" { "name" "publishers", "iscustom" false, "type" "role", "id" 4 }, "isfixed" true, "isinherited" true, "isallowed" false, "creationdate" "2024 01 03t01 44 13 45z" }, { "entityid" null, "operationuid" "f7d768be c485 b4d4 5d98 bc80c329922c", "principal" { "name" "network managers", "iscustom" false, "type" "role", "id" 5 }, "isfixed" true, "isinherited" true, "isallowed" false, "creationdate" "2024 01 03t01 44 13 62z" }, { "entityid" null, "operationuid" "f7d768be c485 b4d4 5d98 bc80c329922c", "principal" { "name" "viewers", "iscustom" false, "type" "role", "id" 6 }, "isfixed" true, "isinherited" true, "isallowed" false, "creationdate" "2024 01 03t01 44 13 803z" } ] }, { "uid" "f2293374 b9bb 2a04 b192 e1e3fb9b013a", "singularname" "create role", "pluralname" "create role", "fullname" "role (full control) create role", "targetentity" "role", "appliance" "instance, collection", "parent" { "uid" "027a307a a29d d674 a935 da468ef03091", "singularname" "full control", "pluralname" "role (full control)", "fullname" "role (full control)", "targetentity" "role", "appliance" "instance, collection", "parent" null, "descendants" null, "permissions" null }, "descendants" \[], "permissions" \[ { "entityid" null, "operationuid" "f2293374 b9bb 2a04 b192 e1e3fb9b013a", "principal" { "name" "administrators", "iscustom" false, "type" "role", "id" 1 }, "isfixed" true, "isinherited" true, "isallowed" true, "creationdate" "2024 01 03t01 44 13 16z" }, { "entityid" null, "operationuid" "f2293374 b9bb 2a04 b192 e1e3fb9b013a", "principal" { "name" "general managers", "iscustom" false, "type" "role", "id" 2 }, "isfixed" true, "isinherited" true, "isallowed" false, "creationdate" "2024 01 03t01 44 13 283z" }, { "entityid" null, "operationuid" "f2293374 b9bb 2a04 b192 e1e3fb9b013a", "principal" { "name" "creators", "iscustom" false, "type" "role", "id" 3 }, "isfixed" true, "isinherited" true, "isallowed" false, "creationdate" "2024 01 03t01 44 13 38z" }, { "entityid" null, "operationuid" "f2293374 b9bb 2a04 b192 e1e3fb9b013a", "principal" { "name" "publishers", "iscustom" false, "type" "role", "id" 4 }, "isfixed" true, "isinherited" true, "isallowed" false, "creationdate" "2024 01 03t01 44 13 45z" }, { "entityid" null, "operationuid" "f2293374 b9bb 2a04 b192 e1e3fb9b013a", "principal" { "name" "network managers", "iscustom" false, "type" "role", "id" 5 }, "isfixed" true, "isinherited" true, "isallowed" false, "creationdate" "2024 01 03t01 44 13 62z" }, { "entityid" null, "operationuid" "f2293374 b9bb 2a04 b192 e1e3fb9b013a", "principal" { "name" "viewers", "iscustom" false, "type" "role", "id" 6 }, "isfixed" true, "isinherited" true, "isallowed" false, "creationdate" "2024 01 03t01 44 13 803z" } ] }, { "uid" "5cd2960f 5361 a504 81bf 9496384d1c24", "singularname" "add user", "pluralname" "add user", "fullname" "role (full control) add user", "targetentity" "role", "appliance" "instance, collection", "parent" { "uid" "027a307a a29d d674 a935 da468ef03091", "singularname" "full control", "pluralname" "role (full control)", "fullname" "role (full control)", "targetentity" "role", "appliance" "instance, collection", "parent" null, "descendants" null, "permissions" null }, "descendants" \[], "permissions" \[ { "entityid" null, "operationuid" "5cd2960f 5361 a504 81bf 9496384d1c24", "principal" { "name" "administrators", "iscustom" false, "type" "role", "id" 1 }, "isfixed" true, "isinherited" true, "isallowed" true, "creationdate" "2024 01 03t01 44 13 16z" }, { "entityid" null, "operationuid" "5cd2960f 5361 a504 81bf 9496384d1c24", "principal" { "name" "general managers", "iscustom" false, "type" "role", "id" 2 }, "isfixed" true, "isinherited" true, "isallowed" false, "creationdate" "2024 01 03t01 44 13 283z" }, { "entityid" null, "operationuid" "5cd2960f 5361 a504 81bf 9496384d1c24", "principal" { "name" "creators", "iscustom" false, "type" "role", "id" 3 }, "isfixed" true, "isinherited" true, "isallowed" false, "creationdate" "2024 01 03t01 44 13 38z" }, { "entityid" null, "operationuid" "5cd2960f 5361 a504 81bf 9496384d1c24", "principal" { "name" "publishers", "iscustom" false, "type" "role", "id" 4 }, "isfixed" true, "isinherited" true, "isallowed" false, "creationdate" "2024 01 03t01 44 13 45z" }, { "entityid" null, "operationuid" "5cd2960f 5361 a504 81bf 9496384d1c24", "principal" { "name" "network managers", "iscustom" false, "type" "role", "id" 5 }, "isfixed" true, "isinherited" true, "isallowed" false, "creationdate" "2024 01 03t01 44 13 62z" }, { "entityid" null, "operationuid" "5cd2960f 5361 a504 81bf 9496384d1c24", "principal" { "name" "viewers", "iscustom" false, "type" "role", "id" 6 }, "isfixed" true, "isinherited" true, "isallowed" false, "creationdate" "2024 01 03t01 44 13 803z" } ] }, { "uid" "a81a32c6 4291 05c4 71a2 6f899dc6da15", "singularname" "remove user", "pluralname" "remove user", "fullname" "role (full control) remove user", "targetentity" "role", "appliance" "instance, collection", "parent" { "uid" "027a307a a29d d674 a935 da468ef03091", "singularname" "full control", "pluralname" "role (full control)", "fullname" "role (full control)", "targetentity" "role", "appliance" "instance, collection", "parent" null, "descendants" null, "permissions" null }, "descendants" \[], "permissions" \[ { "entityid" null, "operationuid" "a81a32c6 4291 05c4 71a2 6f899dc6da15", "principal" { "name" "administrators", "iscustom" false, "type" "role", "id" 1 }, "isfixed" true, "isinherited" true, "isallowed" true, "creationdate" "2024 01 03t01 44 13 16z" }, { "entityid" null, "operationuid" "a81a32c6 4291 05c4 71a2 6f899dc6da15", "principal" { "name" "general managers", "iscustom" false, "type" "role", "id" 2 }, "isfixed" true, "isinherited" true, "isallowed" false, "creationdate" "2024 01 03t01 44 13 283z" }, { "entityid" null, "operationuid" "a81a32c6 4291 05c4 71a2 6f899dc6da15", "principal" { "name" "creators", "iscustom" false, "type" "role", "id" 3 }, "isfixed" true, "isinherited" true, "isallowed" false, "creationdate" "2024 01 03t01 44 13 38z" }, { "entityid" null, "operationuid" "a81a32c6 4291 05c4 71a2 6f899dc6da15", "principal" { "name" "publishers", "iscustom" false, "type" "role", "id" 4 }, "isfixed" true, "isinherited" true, "isallowed" false, "creationdate" "2024 01 03t01 44 13 45z" }, { "entityid" null, "operationuid" "a81a32c6 4291 05c4 71a2 6f899dc6da15", "principal" { "name" "network managers", "iscustom" false, "type" "role", "id" 5 }, "isfixed" true, "isinherited" true, "isallowed" false, "creationdate" "2024 01 03t01 44 13 62z" }, { "entityid" null, "operationuid" "a81a32c6 4291 05c4 71a2 6f899dc6da15", "principal" { "name" "viewers", "iscustom" false, "type" "role", "id" 6 }, "isfixed" true, "isinherited" true, "isallowed" false, "creationdate" "2024 01 03t01 44 13 803z" } ] }, { "uid" "b38189a5 84d8 fba4 bd56 f71a5dfba6e6", "singularname" "edit permissions", "pluralname" "edit permissions", "fullname" "role (full control) edit permissions", "targetentity" "role", "appliance" "collection", "parent" { "uid" "027a307a a29d d674 a935 da468ef03091", "singularname" "full control", "pluralname" "role (full control)", "fullname" "role (full control)", "targetentity" "role", "appliance" "instance, collection", "parent" null, "descendants" null, "permissions" null }, "descendants" \[], "permissions" \[ { "entityid" null, "operationuid" "b38189a5 84d8 fba4 bd56 f71a5dfba6e6", "principal" { "name" "administrators", "iscustom" false, "type" "role", "id" 1 }, "isfixed" true, "isinherited" true, "isallowed" true, "creationdate" "2024 01 03t01 44 13 16z" }, { "entityid" null, "operationuid" "b38189a5 84d8 fba4 bd56 f71a5dfba6e6", "principal" { "name" "general managers", "iscustom" false, "type" "role", "id" 2 }, "isfixed" true, "isinherited" true, "isallowed" false, "creationdate" "2024 01 03t01 44 13 283z" }, { "entityid" null, "operationuid" "b38189a5 84d8 fba4 bd56 f71a5dfba6e6", "principal" { "name" "creators", "iscustom" false, "type" "role", "id" 3 }, "isfixed" true, "isinherited" true, "isallowed" false, "creationdate" "2024 01 03t01 44 13 38z" }, { "entityid" null, "operationuid" "b38189a5 84d8 fba4 bd56 f71a5dfba6e6", "principal" { "name" "publishers", "iscustom" false, "type" "role", "id" 4 }, "isfixed" true, "isinherited" true, "isallowed" false, "creationdate" "2024 01 03t01 44 13 45z" }, { "entityid" null, "operationuid" "b38189a5 84d8 fba4 bd56 f71a5dfba6e6", "principal" { "name" "network managers", "iscustom" false, "type" "role", "id" 5 }, "isfixed" true, "isinherited" true, "isallowed" false, "creationdate" "2024 01 03t01 44 13 62z" }, { "entityid" null, "operationuid" "b38189a5 84d8 fba4 bd56 f71a5dfba6e6", "principal" { "name" "viewers", "iscustom" false, "type" "role", "id" 6 }, "isfixed" true, "isinherited" true, "isallowed" false, "creationdate" "2024 01 03t01 44 13 803z" } ] }, { "uid" "0a9b49c6 74a4 2834 15c6 606964e01f8b", "singularname" "update role", "pluralname" "update role", "fullname" "role (full control) update role", "targetentity" "role", "appliance" "collection", "parent" { "uid" "027a307a a29d d674 a935 da468ef03091", "singularname" "full control", "pluralname" "role (full control)", "fullname" "role (full control)", "targetentity" "role", "appliance" "instance, collection", "parent" null, "descendants" null, "permissions" null }, "descendants" \[], "permissions" \[ { "entityid" null, "operationuid" "0a9b49c6 74a4 2834 15c6 606964e01f8b", "principal" { "name" "administrators", "iscustom" false, "type" "role", "id" 1 }, "isfixed" true, "isinherited" true, "isallowed" true, "creationdate" "2024 01 03t01 44 13 16z" }, { "entityid" null, "operationuid" "0a9b49c6 74a4 2834 15c6 606964e01f8b", "principal" { "name" "general managers", "iscustom" false, "type" "role", "id" 2 }, "isfixed" true, "isinherited" true, "isallowed" false, "creationdate" "2024 01 03t01 44 13 283z" }, { "entityid" null, "operationuid" "0a9b49c6 74a4 2834 15c6 606964e01f8b", "principal" { "name" "creators", "iscustom" false, "type" "role", "id" 3 }, "isfixed" true, "isinherited" true, "isallowed" false, "creationdate" "2024 01 03t01 44 13 38z" }, { "entityid" null, "operationuid" "0a9b49c6 74a4 2834 15c6 606964e01f8b", "principal" { "name" "publishers", "iscustom" false, "type" "role", "id" 4 }, "isfixed" true, "isinherited" true, "isallowed" false, "creationdate" "2024 01 03t01 44 13 45z" }, { "entityid" null, "operationuid" "0a9b49c6 74a4 2834 15c6 606964e01f8b", "principal" { "name" "network managers", "iscustom" false, "type" "role", "id" 5 }, "isfixed" true, "isinherited" true, "isallowed" false, "creationdate" "2024 01 03t01 44 13 62z" }, { "entityid" null, "operationuid" "0a9b49c6 74a4 2834 15c6 606964e01f8b", "principal" { "name" "viewers", "iscustom" false, "type" "role", "id" 6 }, "isfixed" true, "isinherited" true, "isallowed" false, "creationdate" "2024 01 03t01 44 13 803z" } ] }, { "uid" "30af3135 5514 2f64 75e1 d31e074c16d5", "singularname" "delete role", "pluralname" "delete role", "fullname" "role (full control) delete role", "targetentity" "role", "appliance" "instance, collection", "parent" { "uid" "027a307a a29d d674 a935 da468ef03091", "singularname" "full control", "pluralname" "role (full control)", "fullname" "role (full control)", "targetentity" "role", "appliance" "instance, collection", "parent" null, "descendants" null, "permissions" null }, "descendants" \[], "permissions" \[ { "entityid" null, "operationuid" "30af3135 5514 2f64 75e1 d31e074c16d5", "principal" { "name" "administrators", "iscustom" false, "type" "role", "id" 1 }, "isfixed" true, "isinherited" true, "isallowed" true, "creationdate" "2024 01 03t01 44 13 16z" }, { "entityid" null, "operationuid" "30af3135 5514 2f64 75e1 d31e074c16d5", "principal" { "name" "general managers", "iscustom" false, "type" "role", "id" 2 }, "isfixed" true, "isinherited" true, "isallowed" false, "creationdate" "2024 01 03t01 44 13 283z" }, { "entityid" null, "operationuid" "30af3135 5514 2f64 75e1 d31e074c16d5", "principal" { "name" "creators", "iscustom" false, "type" "role", "id" 3 }, "isfixed" true, "isinherited" true, "isallowed" false, "creationdate" "2024 01 03t01 44 13 38z" }, { "entityid" null, "operationuid" "30af3135 5514 2f64 75e1 d31e074c16d5", "principal" { "name" "publishers", "iscustom" false, "type" "role", "id" 4 }, "isfixed" true, "isinherited" true, "isallowed" false, "creationdate" "2024 01 03t01 44 13 45z" }, { "entityid" null, "operationuid" "30af3135 5514 2f64 75e1 d31e074c16d5", "principal" { "name" "network managers", "iscustom" false, "type" "role", "id" 5 }, "isfixed" true, "isinherited" true, "isallowed" false, "creationdate" "2024 01 03t01 44 13 62z" }, { "entityid" null, "operationuid" "30af3135 5514 2f64 75e1 d31e074c16d5", "principal" { "name" "viewers", "iscustom" false, "type" "role", "id" 6 }, "isfixed" true, "isinherited" true, "isallowed" false, "creationdate" "2024 01 03t01 44 13 803z" } ] } ], "permissions" \[ { "entityid" null, "operationuid" "027a307a a29d d674 a935 da468ef03091", "principal" { "name" "administrators", "iscustom" false, "type" "role", "id" 1 }, "isfixed" true, "isinherited" false, "isallowed" true, "creationdate" "2024 01 03t01 44 13 16z" }, { "entityid" null, "operationuid" "027a307a a29d d674 a935 da468ef03091", "principal" { "name" "general managers", "iscustom" false, "type" "role", "id" 2 }, "isfixed" true, "isinherited" false, "isallowed" false, "creationdate" "2024 01 03t01 44 13 283z" }, { "entityid" null, "operationuid" "027a307a a29d d674 a935 da468ef03091", "principal" { "name" "creators", "iscustom" false, "type" "role", "id" 3 }, "isfixed" true, "isinherited" false, "isallowed" false, "creationdate" "2024 01 03t01 44 13 38z" }, { "entityid" null, "operationuid" "027a307a a29d d674 a935 da468ef03091", "principal" { "name" "publishers", "iscustom" false, "type" "role", "id" 4 }, "isfixed" true, "isinherited" false, "isallowed" false, "creationdate" "2024 01 03t01 44 13 45z" }, { "entityid" null, "operationuid" "027a307a a29d d674 a935 da468ef03091", "principal" { "name" "network managers", "iscustom" false, "type" "role", "id" 5 }, "isfixed" true, "isinherited" false, "isallowed" false, "creationdate" "2024 01 03t01 44 13 62z" }, { "entityid" null, "operationuid" "027a307a a29d d674 a935 da468ef03091", "principal" { "name" "viewers", "iscustom" false, "type" "role", "id" 6 }, "isfixed" true, "isinherited" false, "isallowed" false, "creationdate" "2024 01 03t01 44 13 803z" } ] } respuesta de error \300\ la representación solicitada no pudo devolverse porque es ambigua (hay múltiples representaciones solicitadas) \400\ la solicitud está mal formada y, por lo tanto, no es válida \401\ el token de acceso no es válido o no se especificó \403\ el token de acceso proporcionado, aunque válido, no proporciona acceso a este método \406\ el servidor no puede devolver la representación de datos que solicitó (según se especifica en el encabezado "accept") \5xx\ cualquier código 500 es un error interno del servidor get /{id}/permissions/ incluye permisos de objeto otorgados a un rol determinado token de alcance requerido bsn api main roles retrieve segmento id \int \ un identificador único para un rol ejemplo de solicitud los parámetros y encabezados de la solicitud de ejemplo se establecen de la siguiente manera id se establece en 12345 get /2022/06/rest/roles/12345/permissions/ http/1 1 host api bsn cloud connection keep alive authorization bearer {{useraccesstoken}} accept application/json, application/vnd bsn error+json accept encoding gzip,deflate cuerpo de la respuesta exitosa \200\ devuelve una matriz de entidades de permiso docid\ hc70cptqcofqdzw2spaek otorgadas a un rol determinado ejemplo \[ { "entityid" null, "operationuid" "b41ac545 d505 7014 edde 51bc4c0d21a0", "principal" { "name" "creators", "iscustom" false, "type" "role", "id" 12345 }, "isfixed" true, "isinherited" false, "isallowed" false, "creationdate" "2020 08 17t20 49 46 35z" } ] respuesta de error \300\ la representación solicitada no pudo devolverse porque es ambigua (hay múltiples representaciones solicitadas) \400\ la solicitud está mal formada y, por lo tanto, no es válida \401\ el token de acceso no es válido o no se especificó \403\ el token de acceso proporcionado, aunque válido, no proporciona acceso a este método \404\ el servidor no puede encontrar el recurso solicitado (la ruta no existe) \406\ el servidor no puede devolver la representación de datos que solicitó (según se especifica en el encabezado "accept") \5xx\ cualquier código 500 es un error interno del servidor post /{id}/permissions/ agregar permisos para roles especificados en una red token de alcance requerido bsn api main roles update segmento id \int \ un identificador único para un rol cuerpo de la solicitud una matriz de permiso docid\ hc70cptqcofqdzw2spaek entidades ejemplo de solicitud los parámetros y encabezados de la solicitud de ejemplo se establecen de la siguiente manera id se establece en 12345 post /2022/06/rest/roles/12345/permissions/ http/1 1 host api bsn cloud connection keep alive authorization bearer {{useraccesstoken}} accept application/json, application/vnd bsn error+json accept encoding gzip,deflate content type application/json content length 292 este es el cuerpo de la solicitud de ejemplo { "entityid" null, "operationuid" "b41ac545 d505 7014 edde 51bc4c0d21a0", "principal" { "name" "creators", "iscustom" false, "type" "role", "id" 12345 }, "isfixed" false, "isinherited" false, "isallowed" false, "creationdate" "0001 01 01t00 00 00" } respuesta correcta \204\ los permisos se agregaron correctamente al rol especificado respuesta de error \400\ la solicitud o el cuerpo de la solicitud tiene un formato incorrecto y, por lo tanto, no es válido, o se rechaza de acuerdo con las reglas comerciales \401\ el token de acceso no es válido o no se especificó \403\ el token de acceso proporcionado, aunque válido, no proporciona acceso a este método \404\ el servidor no puede encontrar el recurso solicitado (la ruta no existe) \415\ el servidor no puede aceptar la representación de datos que usted envió (según se especifica en el encabezado "content type") \5xx\ cualquier código 500 es un error interno del servidor delete /{id}/permissions/ elimina permisos para roles especificados en una red token de alcance requerido bsn api main roles delete segmento id \int \ un identificador único para un rol cuerpo de la solicitud una matriz de permiso docid\ hc70cptqcofqdzw2spaek entidades ejemplo de solicitud los parámetros y encabezados de la solicitud de ejemplo se establecen de la siguiente manera id se establece en 12345 delete /2022/06/rest/roles/12345/permissions/ http/1 1 host api bsn cloud connection keep alive authorization bearer {{useraccesstoken}} accept application/json, application/vnd bsn error+json accept encoding gzip,deflate content type application/json content length 359 este es el cuerpo de solicitud de ejemplo { "entityid" null, "operationuid" "b41ac545 d505 7014 edde 51bc4c0d21a0", "principal" { "name" "creators", "iscustom" false, "type" "role", "id" 12345 }, "isfixed" false, "isinherited" false, "isallowed" false, "creationdate" "0001 01 01t00 00 00" } respuesta correcta \204\ los permisos especificados se han eliminado del rol respuesta de error \300\ la representación solicitada no pudo devolverse porque es ambigua (hay múltiples representaciones solicitadas) \400\ la solicitud o el cuerpo de la solicitud tienen un formato incorrecto y, por lo tanto, no son válidos, o se rechazan de acuerdo con las reglas de negocio \401\ el token de acceso no es válido o no se ha especificado \403\ el token de acceso proporcionado, aunque válido, no proporciona acceso a este método \404\ el servidor no puede encontrar el recurso solicitado (la ruta no existe) \406\ el servidor no puede devolver la representación de datos que solicitó (según lo especificado en el encabezado "accept") \5xx\ cualquier código 500 es un error interno del servidor get /{name}/permissions/ incluye permisos de objetos otorgados a un rol determinado token de alcance requerido bsn api main roles retrieve segmento nombre \string \ el nombre del rol ejemplo de solicitud los parámetros y encabezados de la solicitud de ejemplo se establecen de la siguiente manera nombre se establece en creadores get /2022/06/rest/roles/creators/permissions/ http/1 1 host api bsn cloud connection keep alive authorization bearer {{useraccesstoken}} accept application/json, application/vnd bsn error+json accept encoding gzip,deflate cuerpo de respuesta correcta \200\ devuelve una matriz de entidades permiso docid\ hc70cptqcofqdzw2spaek otorgadas a un rol determinado ejemplo \[ { "entityid" null, "operationuid" "b41ac545 d505 7014 edde 51bc4c0d21a0", "principal" { "name" "creators", "iscustom" false, "type" "role", "id" 12345 }, "isfixed" true, "isinherited" false, "isallowed" false, "creationdate" "2020 08 17t20 49 46 35z" } ] respuesta de error \300\ la representación solicitada no pudo devolverse porque es ambigua (hay múltiples representaciones solicitadas) \400\ la solicitud tiene un formato incorrecto y, por lo tanto, no es válida \401\ el token de acceso es inválido o no se especificó \403\ el token de acceso proporcionado, aunque válido, no proporciona acceso a este método \404\ el servidor no puede encontrar el recurso solicitado (la ruta no existe) \406\ el servidor no puede devolver la representación de datos que solicitó (como se especifica en el encabezado "accept") \5xx\ cualquier código 500 es un error interno del servidor post /{name}/permissions/ agrega permisos para roles especificados en una red token de scope requerido bsn api main roles update segmento nombre \string \ el nombre del rol cuerpo de la solicitud una matriz de entidades permiso docid\ hc70cptqcofqdzw2spaek ejemplo de solicitud los parámetros y encabezados de la solicitud de ejemplo se establecen de la siguiente manera nombre se establece en creadores post /2022/06/rest/roles/creators/permissions/ http/1 1 host api bsn cloud connection keep alive authorization bearer {{useraccesstoken}} accept application/json, application/vnd bsn error+json accept encoding gzip,deflate content type application/json content length 292 este es el cuerpo de la solicitud de ejemplo { "entityid" null, "operationuid" "b41ac545 d505 7014 edde 51bc4c0d21a0", "principal" { "name" "creators", "iscustom" false, "type" "role", "id" 12345 }, "isfixed" false, "isinherited" false, "isallowed" false, "creationdate" "0001 01 01t00 00 00" } respuesta exitosa \204\ los permisos se agregaron correctamente al rol especificado respuesta de error \400\ la solicitud o el cuerpo de la solicitud tiene un formato incorrecto y, por lo tanto, es inválido, o se rechaza de acuerdo con las reglas de negocio \401\ el token de acceso es inválido o no se especificó \403\ el token de acceso proporcionado, aunque válido, no proporciona acceso a este método \404\ el servidor no puede encontrar el recurso solicitado (la ruta no existe) \415\ el servidor no puede aceptar la representación de datos que envió (como se especifica en el encabezado "content type") \5xx\ cualquier código 500 es un error interno del servidor delete /{name}/permissions/ elimina permisos para el rol especificado en una red token de scope requerido bsn api main roles delete segmento nombre \string \ el nombre del rol cuerpo de la solicitud una matriz de entidades de permiso docid\ hc70cptqcofqdzw2spaek ejemplo de solicitud los parámetros y encabezados de la solicitud de ejemplo se establecen de la siguiente manera nombre se establece en creadores delete /2022/06/rest/roles/creators/permissions/ http/1 1 host api bsn cloud connection keep alive authorization bearer {{useraccesstoken}} accept application/json, application/vnd bsn error+json accept encoding gzip,deflate content type application/json content length 359 este es el cuerpo de la solicitud de ejemplo { "entityid" null, "operationuid" "b41ac545 d505 7014 edde 51bc4c0d21a0", "principal" { "name" "creators", "iscustom" false, "type" "role", "id" 12345 }, "isfixed" false, "isinherited" false, "isallowed" false, "creationdate" "0001 01 01t00 00 00" } respuesta correcta \204\ los permisos especificados se han eliminado del rol respuesta de error \300\ la representación solicitada no pudo devolverse porque es ambigua (hay múltiples representaciones solicitadas) \400\ la solicitud o el cuerpo de la solicitud tiene un formato incorrecto y, por lo tanto, no es válido, o se rechaza de acuerdo con las reglas de negocio \401\ el token de acceso no es válido o no se especificó \403\ el token de acceso proporcionado, aunque válido, no proporciona acceso a este método \404\ el servidor no puede encontrar el recurso solicitado (la ruta no existe) \406\ el servidor no puede devolver la representación de datos que usted solicitó (según se especifica en el encabezado "accept") \5xx\ cualquier código 500 es un error interno del servidor