Compartir recurso del espacio de trabajo

POST

/v1/workspace/resources/:resource_id/share

Asigna un rol (uno de ‘admin’, ‘editor’, ‘commenter’ o ‘viewer’) sobre un recurso del espacio de trabajo a un usuario, grupo o clave de API del espacio de trabajo (cuenta de servicio). Esto reemplaza cualquier rol existente que el destinatario tenga sobre el recurso. Para seleccionar un usuario o una cuenta de servicio, proporciona solo el correo electrónico del usuario; el usuario debe pertenecer a tu espacio de trabajo. Para seleccionar un grupo, proporciona solo el ID del grupo. Para seleccionar una clave de API del espacio de trabajo (cuenta de servicio), proporciona el ID de la clave de API; el recurso se compartirá con la cuenta de servicio asociada a esa clave. Debes tener acceso de administrador al recurso para compartirlo.

Asigna un rol (uno de 'admin', 'editor', 'commenter' o 'viewer') sobre un recurso del espacio de trabajo a un usuario, grupo o clave de API del espacio de trabajo (cuenta de servicio). Esto reemplaza cualquier rol existente que el destinatario tenga sobre el recurso. Para seleccionar un usuario o una cuenta de servicio, proporciona solo el correo electrónico del usuario; el usuario debe pertenecer a tu espacio de trabajo. Para seleccionar un grupo, proporciona solo el ID del grupo. Para seleccionar una clave de API del espacio de trabajo (cuenta de servicio), proporciona el ID de la clave de API; el recurso se compartirá con la cuenta de servicio asociada a esa clave. Debes tener acceso de administrador al recurso para compartirlo.

Parámetros de ruta

resource_idstringRequerido

El ID del recurso de destino.

Solicitud

This endpoint expects an object.

roleenumRequerido

Rol que se concederá al destino: ‘admin’, ‘editor’, ‘commenter’ o ‘viewer’.

Valores permitidos:

resource_typeenumRequerido

Tipo de recurso del recurso de destino.

user_emailstring or nullOpcional

El correo electrónico del usuario o de la cuenta de servicio.

group_idstring or nullOpcional

El ID del grupo de destino. Usa «default» para establecer el rol base del recurso: todos los miembros del espacio de trabajo reciben este rol, salvo que tengan uno superior mediante una asignación directa de usuario, la pertenencia a un grupo o una clave de API del espacio de trabajo (cuenta de servicio).

workspace_api_key_idstring or nullOpcional

El ID de la clave de API del espacio de trabajo de destino (cuenta de servicio). No es la propia cadena de la clave de API que pasas en la cabecera para autenticarte, sino el ID de la clave, que los administradores del espacio de trabajo pueden encontrar en Desarrolladores → Cuentas de servicio.

Respuesta

Respuesta correcta.

Errores

422

Unprocessable Entity Error

Parámetros de ruta

Encabezados

Solicitud

Respuesta

Errores