REST Resource: roleAssignments

資源：RoleAssignment

定義角色指派作業。

JSON 表示法 
{
  "roleAssignmentId": string,
  "roleId": string,
  "kind": string,
  "etag": string,
  "assignedTo": string,
  "assigneeType": enum (AssigneeType),
  "scopeType": string,
  "orgUnitId": string,
  "condition": string,
  "expirationDetails": {
    object (ExpirationDetails)
  }
}
欄位
roleAssignmentId

string (int64 format)

這個 roleAssignment 的 ID。
roleId

string (int64 format)

指派角色的 ID。
kind

string

API 資源的類型。這個值一律為 admin#directory#roleAssignment。
etag

string

資源的 ETag。
assignedTo

string

這個角色指派對象的專屬 ID，可以是使用者的 userId、群組的 groupId，或是身分與存取權管理 (IAM) 中定義的服務帳戶 uniqueId。
assigneeType

enum (AssigneeType)

僅供輸出。指派對象類型 (USER 或 GROUP)。
scopeType

string

指派這個角色的範圍。

可接受的值如下：

  • CUSTOMER
  • ORG_UNIT
orgUnitId

string

如果角色僅限於機構單位，這個欄位會包含角色行使權限的機構單位 ID。
condition

string

(選用步驟) 與這項角色指派相關聯的條件。

注意：這項功能適用於 Enterprise Standard、Enterprise Plus、Google Workspace for Education Plus 和 Cloud Identity 進階版客戶。

如果 RoleAssignment 設有 condition 欄位，只有在存取的資源符合條件時才會生效。如果 condition 為空，系統會無條件將角色 (roleId) 套用至範圍 (scopeType) 中的參與者 (assignedTo)。

目前支援的條件如下：

  • 如要讓 RoleAssignment 僅適用於安全性群組：api.getAttribute('cloudidentity.googleapis.com/groups.labels', []).hasAny(['groups.security']) && resource.type == 'cloudidentity.googleapis.com/Group'

  • 如要讓 RoleAssignment 不適用於安全性群組，請按照下列步驟操作：!api.getAttribute('cloudidentity.googleapis.com/groups.labels', []).hasAny(['groups.security']) && resource.type == 'cloudidentity.googleapis.com/Group'

目前條件字串必須完全相同，且僅適用於下列預先建立的管理員角色：

  • 群組編輯者
  • 群組讀取者

條件遵循 Cloud IAM 條件語法。

  • 如要讓 RoleAssignment 不適用於鎖定群組，請按照下列步驟操作：!api.getAttribute('cloudidentity.googleapis.com/groups.labels', []).hasAny(['groups.locked']) && resource.type == 'cloudidentity.googleapis.com/Group'

這項條件也可以搭配安全性相關條件使用。
expirationDetails

object (ExpirationDetails)

(選用步驟) 這項角色指派作業的到期詳細資料。

AssigneeType

指派角色的身分類型。

列舉
USER 網域中的個別使用者。
GROUP 網域中的群組。

ExpirationDetails

這個角色指派作業的到期詳細資料。時間到期時，系統會自動撤銷存取權。

JSON 表示法 
{

  "expireTime": string
}
欄位

聯集欄位 expiration。

expiration 只能是下列其中一項：
expireTime

string (Timestamp format)

角色指派作業到期的確切時間戳記。

使用 RFC 3339，產生的輸出內容一律會經過 Z 正規化，並使用 0、3、6 或 9 個小數位數，也接受「Z」以外的偏移量。範例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。

方法

delete

 刪除角色指派。

get

 擷取角色指派。

insert

 建立角色指派。

list

 擷取所有 roleAssignments 的分頁清單。