REST Resource: matters

Recurso: Matter

Representa un asunto.

Para trabajar con los recursos de Vault, la cuenta debe tener los privilegios de Vault necesarios y acceso al asunto. Para acceder a un asunto, la cuenta debe haberlo creado, compartido con ella o tener el privilegio Ver todos los asuntos.

Representación JSON
{
  "matterId": string,
  "name": string,
  "description": string,
  "state": enum (State),
  "matterPermissions": [
    {
      object (MatterPermission)
    }
  ]
  "matter_region": enum (MatterRegion),
}
Campos
matterId

string

El ID del asunto, que genera el servidor. Deja este campo en blanco cuando crees un asunto.

name

string

El nombre del asunto.

description

string

Una descripción opcional para el asunto.

state

enum (State)

El estado del asunto.

matterPermissions[]

object (MatterPermission)

Enumera los usuarios y sus permisos para el asunto. Actualmente, no hay un límite definido por el programador para la cantidad de permisos que puede tener un asunto.

matter_region

enum (MatterRegion)

La región de datos del asunto.

Estado

El estado de un asunto.

Enumeraciones
STATE_UNSPECIFIED El asunto no tiene un estado especificado.
OPEN El asunto está abierto.
CLOSED El asunto está cerrado.
DELETED Se borró el asunto.

MatterPermission

Los usuarios pueden ser propietarios o colaboradores de asuntos. Cada asunto tiene solo un propietario. Todos los demás usuarios que pueden acceder al asunto son colaboradores. Cuando se borra definitivamente una cuenta, sus recursos MatterPermission correspondientes dejan de existir.

Representación JSON
{
  "role": enum (AclRole),
  "accountId": string
}
Campos
role

enum (AclRole)

El rol del usuario para el asunto.

accountId

string

El ID de la cuenta, tal como lo proporciona el SDK de Admin.

AclRole

Los posibles permisos del usuario para un asunto, en orden de aumento de los permisos.

Enumeraciones
ROLE_UNSPECIFIED No se asignaron funciones.
COLLABORATOR Un colaborador en el asunto.
OWNER El propietario del asunto.

Región de Matter

La región de datos de un asunto.

Enumeraciones
MATTER_REGION_UNSPECIFIED El asunto no tiene una región de datos especificada.
ANY El asunto no tiene una región de datos especificada.
US El asunto tiene una región de datos de EE.UU.
EU El asunto tiene una región de datos de la UE.

Métodos

addPermissions

Agrega una cuenta como colaborador del asunto.

close

Cierra el asunto especificado.

count

Cuenta las cuentas que se procesaron según la consulta especificada.

create

Crea un asunto con el nombre y la descripción especificados.

delete

Borra el asunto especificado.

get

Obtiene el asunto especificado.

list

Las listas son asuntos a los que el solicitante tiene acceso.

removePermissions

Quitar una cuenta como colaborador del asunto

reopen

Vuelve a abrir el asunto especificado.

undelete

Recupera el asunto especificado.

update

Actualiza el asunto especificado.