Privileged Access Manager (PAM) 可讓您在固定時間內,要求授權,暫時提升權限。授權要求成功後,Privileged Access Manager 會授予您授權中的角色,並在授權結束時移除這些角色。
授權要求注意事項
要求授予權限時,須遵守下列規則和限制:
- 您只能針對已加入的授權申請授權。如要新增至授權,請與管理授權的主體聯絡。
- 一項授權一次最多可有 10 個開放授權。這些授權可能處於
Active、Scheduled或Approval awaited狀態。 - 您無法要求與
Active、Scheduled或Approval awaited狀態中現有授權範圍相同的授權。 - 如果兩個排定的授權範圍和啟用時間重疊,則無法在同一個授權上排定這兩個授權。此外,如果現有授權的範圍與新授權相同,新授權的開始時間不得早於現有授權的結束時間。
- 視設定方式而定,授權要求可能需要核准才能授予。
如果授權要求需要核准,則必須在到期前核准或拒絕。期限取決於啟用類型:
- 立即啟用:在提出要求後 24 小時內啟用。
- 排定啟用:排定的啟用時間之前。
如果要求未在期限前獲准或遭拒,狀態會變更為
Expired。Privileged Access Manager 會使用以時間為準的 Identity and Access Management (IAM) 條件,並遵循標準存取權變更傳播,因此成功的授權要求、授權啟用和角色移除作業需要一些時間,才能在系統中傳播。
申請補助
控制台
前往「Privileged Access Manager」頁面。
選取要要求授權的組織、資料夾或專案。
在「My entitlements」(我的授權) 分頁中,找出要要求的授權,然後按一下同一列中的「Request grant」(要求授予)。
如果授權是從上層資料夾或組織繼承而來,授予範圍會自動調整為所選組織、資料夾或專案。您可以在子資源層級要求授予沿用的授權。這項功能目前為預先發布版。
如果啟用 Security Command Center Premium 或 Enterprise 級別,則可自訂授予要求範圍,僅納入特定角色和資源。這項功能目前為預先發布版。
- 開啟「自訂範圍」切換鈕。
- 新增必要的資源篩選器。最多可以新增五個資源篩選器。
- 選取必要角色。
提供下列詳細資料:
授權所需時間長度,最長為授權設定的時間長度上限。
選用:如要排定授予項目在日後啟用,請按一下「Schedule grants」(排定授予項目),並指定啟用時間 (最多可提前七天)。如未排定時間,則會在建立或核准後立即啟用。
如有需要,請說明授予權限的理由。
選用:接收通知的電子郵件地址。
與授權相關聯的 Google Identity (例如核准者和要求者) 會自動收到通知。不過,如要通知其他使用者,可以新增他們的電子郵件地址。如果您使用的是員工身分而非 Google 帳戶,這項功能就特別實用。
點選「要求授予權限」。
gcloud
您可以透過下列任一方式要求授權:
要求授予權限
gcloud alpha pam grants create 指令會要求授權。
使用下列任何指令資料前,請先替換以下項目:
ENTITLEMENT_ID:要建立 授權的授權 ID。GRANT_DURATION:要求的授權時間長度,以秒為單位。SCHEDULED_ACTIVATION_TIME:選用。需要啟用授權的時間,格式為 RFC 3339。如未指定,則會在建立或核准後立即啟用。JUSTIFICATION:要求授權的理由。EMAIL_ADDRESS:選用。要接收授予要求通知的其他電子郵件地址。系統會自動通知與核准者相關聯的 Google 身分。不過,您可能需要通知另一組電子郵件地址,尤其是使用員工身分聯盟時。RESOURCE_TYPE:選用。授權所屬的資源類型。請使用organization、folder或project值。RESOURCE_ID:與RESOURCE_TYPE搭配使用。要管理授權的 Google Cloud專案、資料夾或組織 ID。專案 ID 是英數字串,例如my-project。 資料夾和組織 ID 則為數字,例如123456789012。
執行下列指令:
Linux、macOS 或 Cloud Shell
gcloud alpha pam grants create \ --entitlement=ENTITLEMENT_ID \ --requested-duration="GRANT_DURATIONs" \ [--scheduled-activation-time=SCHEDULED_ACTIVATION_TIME] \ --justification="JUSTIFICATION" \ --location=global \ [--additional-email-recipients=EMAIL_ADDRESS_1, EMAIL_ADDRESS_2] \ --RESOURCE_TYPE=RESOURCE_ID
Windows (PowerShell)
gcloud alpha pam grants create ` --entitlement=ENTITLEMENT_ID ` --requested-duration="GRANT_DURATIONs" ` [--scheduled-activation-time=SCHEDULED_ACTIVATION_TIME] ` --justification="JUSTIFICATION" ` --location=global ` [--additional-email-recipients=EMAIL_ADDRESS_1, EMAIL_ADDRESS_2] ` --RESOURCE_TYPE=RESOURCE_ID
Windows (cmd.exe)
gcloud alpha pam grants create ^ --entitlement=ENTITLEMENT_ID ^ --requested-duration="GRANT_DURATIONs" ^ [--scheduled-activation-time=SCHEDULED_ACTIVATION_TIME] ^ --justification="JUSTIFICATION" ^ --location=global ^ [--additional-email-recipients=EMAIL_ADDRESS_1, EMAIL_ADDRESS_2] ^ --RESOURCE_TYPE=RESOURCE_ID
您應該會收到類似以下的回應:
Created [GRANT_ID].
要求授予權利的子項資源
gcloud alpha pam grants create 指令會要求授權。
使用下列任何指令資料前,請先替換以下項目:
ENTITLEMENT_ID:要建立 授權的授權 ID。GRANT_DURATION:要求的授權時間長度,以秒為單位。SCHEDULED_ACTIVATION_TIME:選用。需要啟用授權的時間,格式為 RFC 3339。如未指定,則會在建立或核准後立即啟用。JUSTIFICATION:要求授權的理由。EMAIL_ADDRESS:選用。要接收授予要求通知的其他電子郵件地址。系統會自動通知與核准者相關聯的 Google 身分。不過,您可能需要通知另一組電子郵件地址,尤其是使用員工身分聯盟時。RESOURCE_TYPE:選用。要授予存取權的 Google Cloud 資源類型。這項設定可用來自訂子資源的授權範圍。RESOURCE_ID:與RESOURCE_TYPE搭配使用。要管理授權的 Google Cloud專案、資料夾或組織 ID。專案 ID 是英數字串,例如my-project。 資料夾和組織 ID 則為數字,例如123456789012。REQUESTED_RESOURCE:選用。您要授予存取權的 Google Cloud 資源。這項設定可用來自訂子資源的授權範圍。格式:RESOURCE_TYPE/RESOURCE_ID。例如:projects/PROJECT_ID、folders/FOLDER_ID或organizations/ORGANIZATION_ID。
執行下列指令:
Linux、macOS 或 Cloud Shell
gcloud alpha pam grants create \ --entitlement=ENTITLEMENT_ID \ --requested-duration="GRANT_DURATIONs" \ [--scheduled-activation-time=SCHEDULED_ACTIVATION_TIME] \ --justification="JUSTIFICATION" \ --location=global \ [--additional-email-recipients=EMAIL_ADDRESS_1, EMAIL_ADDRESS_2] \ --RESOURCE_TYPE=RESOURCE_ID \ --requested-resources=REQUESTED_RESOURCE
Windows (PowerShell)
gcloud alpha pam grants create ` --entitlement=ENTITLEMENT_ID ` --requested-duration="GRANT_DURATIONs" ` [--scheduled-activation-time=SCHEDULED_ACTIVATION_TIME] ` --justification="JUSTIFICATION" ` --location=global ` [--additional-email-recipients=EMAIL_ADDRESS_1, EMAIL_ADDRESS_2] ` --RESOURCE_TYPE=RESOURCE_ID ` --requested-resources=REQUESTED_RESOURCE
Windows (cmd.exe)
gcloud alpha pam grants create ^ --entitlement=ENTITLEMENT_ID ^ --requested-duration="GRANT_DURATIONs" ^ [--scheduled-activation-time=SCHEDULED_ACTIVATION_TIME] ^ --justification="JUSTIFICATION" ^ --location=global ^ [--additional-email-recipients=EMAIL_ADDRESS_1, EMAIL_ADDRESS_2] ^ --RESOURCE_TYPE=RESOURCE_ID ^ --requested-resources=REQUESTED_RESOURCE
您應該會收到類似以下的回應:
Created [GRANT_ID].
要求授予精細範圍的權限
gcloud alpha pam grants create 指令會要求授權。
使用下列任何指令資料前,請先替換以下項目:
ENTITLEMENT_ID:要建立 授權的授權 ID。GRANT_DURATION:要求的授權時間長度,以秒為單位。SCHEDULED_ACTIVATION_TIME:選用。需要啟用授權的時間,格式為 RFC 3339。如未指定,則會在建立或核准後立即啟用。JUSTIFICATION:要求授權的理由。EMAIL_ADDRESS:選用。要接收授予要求通知的其他電子郵件地址。系統會自動通知與核准者相關聯的 Google 身分。不過,您可能需要通知另一組電子郵件地址,尤其是使用員工身分聯盟時。ENTITLEMENT_ROLE_BINDING_ID:選用。要透過授權授予的角色繫結 ID。ACCESS_RESTRICTION_NAME:選用。要限制存取權的資源名稱。如要瞭解格式,請參閱「資源名稱格式」。ACCESS_RESTRICTION_PREFIX:選用。要限制存取權的資源名稱前置字串。如要瞭解格式,請參閱「資源名稱格式」。RESOURCE_TYPE:選用。授權所屬的資源類型。請使用organization、folder或project值。RESOURCE_ID:與RESOURCE_TYPE搭配使用。要管理授權的 Google Cloud專案、資料夾或組織 ID。專案 ID 是英數字串,例如my-project。 資料夾和組織 ID 則為數字,例如123456789012。REQUESTED_RESOURCE_TYPE。選用。要授予存取權的 Google Cloud 資源類型。這項設定可用來自訂子資源的授權範圍。REQUESTED_RESOURCE:選用。您要授予存取權的 Google Cloud 資源。這項設定可用來自訂子資源的授權範圍。格式:RESOURCE_TYPE/RESOURCE_ID。例如:projects/PROJECT_ID、folders/FOLDER_ID或organizations/ORGANIZATION_ID。
將下列內容儲存至名為 requested-scope.yaml
的檔案:
- gcpIamAccess: resource: REQUESTED_RESOURCE resourceType: REQUESTED_RESOURCE_TYPE roleBindings: - entitlementRoleBindingId: ENTITLEMENT_ROLE_BINDING_ID_1 accessRestrictions: resourceNames: - ACCESS_RESTRICTION_NAME_1 - ACCESS_RESTRICTION_NAME_2 - entitlementRoleBindingId: ENTITLEMENT_ROLE_BINDING_ID_2 accessRestrictions: resourceNamePrefixes: - ACCESS_RESTRICTION_PREFIX_1 - ACCESS_RESTRICTION_PREFIX_2
執行下列指令:
Linux、macOS 或 Cloud Shell
gcloud alpha pam grants create \ --entitlement=ENTITLEMENT_ID \ --requested-duration="GRANT_DURATIONs" \ [--scheduled-activation-time=SCHEDULED_ACTIVATION_TIME] \ --justification="JUSTIFICATION" \ --location=global \ [--additional-email-recipients=EMAIL_ADDRESS_1, EMAIL_ADDRESS_2] \ --RESOURCE_TYPE=RESOURCE_ID \ --requested-access-from-file=requested-scope.yaml
Windows (PowerShell)
gcloud alpha pam grants create ` --entitlement=ENTITLEMENT_ID ` --requested-duration="GRANT_DURATIONs" ` [--scheduled-activation-time=SCHEDULED_ACTIVATION_TIME] ` --justification="JUSTIFICATION" ` --location=global ` [--additional-email-recipients=EMAIL_ADDRESS_1, EMAIL_ADDRESS_2] ` --RESOURCE_TYPE=RESOURCE_ID ` --requested-access-from-file=requested-scope.yaml
Windows (cmd.exe)
gcloud alpha pam grants create ^ --entitlement=ENTITLEMENT_ID ^ --requested-duration="GRANT_DURATIONs" ^ [--scheduled-activation-time=SCHEDULED_ACTIVATION_TIME] ^ --justification="JUSTIFICATION" ^ --location=global ^ [--additional-email-recipients=EMAIL_ADDRESS_1, EMAIL_ADDRESS_2] ^ --RESOURCE_TYPE=RESOURCE_ID ^ --requested-access-from-file=requested-scope.yaml
您應該會收到類似以下的回應:
Created [GRANT_ID].
REST
- 搜尋您有權索取的授權。
Privileged Access Manager API 的
searchEntitlements方法搭配GRANT_REQUESTER呼叫端存取權類型,可搜尋您能要求授權的權益。使用任何要求資料之前,請先修改下列項目的值:
SCOPE:權利所在的組織、資料夾或專案,格式為organizations/ORGANIZATION_ID、folders/FOLDER_ID或projects/PROJECT_ID。專案 ID 是英數字串,例如my-project。資料夾和組織 ID 則為數字,例如123456789012。FILTER:選用。傳回欄位值符合 AIP-160 運算式的授權。PAGE_SIZE:選用。回應中要傳回的項目數量。PAGE_TOKEN:選用。使用先前回應中傳回的頁面權杖,指定要從哪個頁面開始回應。
HTTP 方法和網址:
GET https://privilegedaccessmanager.googleapis.com/v1beta/SCOPE/locations/global/entitlements:search?callerAccessType=GRANT_REQUESTER&filter=FILTER&pageSize=PAGE_SIZE&pageToken=PAGE_TOKEN
請展開以下其中一個選項,以傳送要求:
您應該會收到如下的 JSON 回覆:
{ "name": "SCOPE/locations/global/operations/OPERATION_ID", "metadata": { "@type": "type.googleapis.com/google.cloud.privilegedaccessmanager.v1beta.OperationMetadata", "createTime": "2024-03-05T03:35:14.596739353Z", "target": "SCOPE/locations/global/entitlements/ENTITLEMENT_ID", "verb": "create", "requestedCancellation": false, "apiVersion": "v1beta" }, "done": false } - 要求授予權限。
Privileged Access Manager API 的
createGrant方法會要求授予權限。使用任何要求資料之前,請先修改下列項目的值:
SCOPE:權利所在的組織、資料夾或專案,格式為organizations/ORGANIZATION_ID、folders/FOLDER_ID或projects/PROJECT_ID。專案 ID 是英數字串,例如my-project。資料夾和組織 ID 則為數字,例如123456789012。ENTITLEMENT_ID:要建立 授權的授權 ID。REQUEST_ID:選用。必須是非零 UUID。 如果伺服器收到含有要求 ID 的要求,就會檢查過去 60 分鐘內是否已完成具有該 ID 的其他要求。如果是,系統會忽略新要求。GRANT_DURATION:要求的授權時間長度,以秒為單位。SCHEDULED_ACTIVATION_TIME:選用。需要啟用授權的時間,格式為 RFC 3339。如未指定,則會在建立或核准後立即啟用。JUSTIFICATION:要求授權的理由。EMAIL_ADDRESS:選用。要接收授予要求通知的其他電子郵件地址。系統會自動通知與核准者相關聯的 Google 身分。不過,您可能需要通知一組不同的電子郵件地址,尤其是使用員工身分聯盟時。ENTITLEMENT_ROLE_BINDING_ID:選用。要透過授權授予的角色繫結 ID。ACCESS_RESTRICTION_NAME:選用。要限制存取權的資源名稱。如要瞭解格式,請參閱「資源名稱格式」。ACCESS_RESTRICTION_PREFIX:選用。要限制存取權的資源名稱前置字串。如要瞭解格式,請參閱「資源名稱格式」。
HTTP 方法和網址:
POST https://privilegedaccessmanager.googleapis.com/v1beta/SCOPE/locations/global/entitlements/ENTITLEMENT_ID/grants?requestId=REQUEST_ID
JSON 要求主體:
{ "requestedDuration": "GRANT_DURATIONs", "activationTrigger": { "requestedActivationTime": "SCHEDULED_ACTIVATION_TIME" }, "justification": { "unstructuredJustification": "JUSTIFICATION" }, "additionalEmailRecipients": [ "EMAIL_ADDRESS_1", "EMAIL_ADDRESS_2", ], "requestedPrivilegedAccess": { "gcpIamAccess": { "resourceType": "REQUESTED_RESOURCE_TYPE", "resource": "REQUESTED_RESOURCE", "roleBindings": [ { "entitlementRoleBindingId": "ENTITLEMENT_ROLE_BINDING_ID", "accessRestrictions": { "resourceNames": [ "ACCESS_RESTRICTION_NAME" ], "resourceNamePrefixes": [ "ACCESS_RESTRICTION_PREFIX" ], }, } ], } }, }請展開以下其中一個選項,以傳送要求:
您應該會收到如下的 JSON 回覆:
{ "name": "SCOPE/locations/global/entitlements/ENTITLEMENT_ID/grants/GRANT_ID", "createTime": "2024-03-06T03:08:49.330577625Z", "updateTime": "2024-03-06T03:08:49.625874598Z", "requester": "alex@example.com", "requestedDuration": "3600s", "justification": { "unstructuredJustification": "Emergency service for outage" }, "state": "APPROVAL_AWAITED", "timeline": { "events": [ { "eventTime": "2024-03-06T03:08:49.462765846Z", "requested": { "expireTime": "2024-03-07T03:08:49.462765846Z" } } ] }, "privilegedAccess": { "gcpIamAccess": { "resourceType": "cloudresourcemanager.googleapis.com/Project", "resource": "//cloudresourcemanager.googleapis.com/SCOPE", "roleBindings": [ { "role": "roles/storage.admin", "id": "hwqrt_1", "conditionExpression": "resource.name == \"//cloudresourcemanager.googleapis.com/SCOPE/buckets/bucket-1\" && resource.name.startsWith(\"//cloudresourcemanager.googleapis.com/SCOPE/compute/vms\")" } ] } }, "requestedPrivilegedAccess": { "gcpIamAccess": { "resourceType": "cloudresourcemanager.googleapis.com/Project", "resource": "//cloudresourcemanager.googleapis.com/SCOPE", "roleBindings": [ { "role": "roles/storage.admin", "entitlementRoleBindingId": "hwqrt_1", "accessRestrictions": { "resourceNames": [ "//cloudresourcemanager.googleapis.com/SCOPE/buckets/bucket-1" ], "resourceNamePrefixes": [ "//cloudresourcemanager.googleapis.com/SCOPE/compute/vms" ] } } ] } }, "additionalEmailRecipients": [ "bola@google.com" ] }
查看補助申請狀態
控制台
前往「Privileged Access Manager」頁面。
選取要查看授權的組織、資料夾或專案。
在「補助金」分頁中,按一下「我的補助金」。
補助金可能顯示下列其中一種狀態:
狀態 說明 啟用中 正在啟用授予項目。 啟用失敗 發生無法重試的錯誤,因此 Privileged Access Manager 無法授予角色。 有效 授權已生效,主體可存取角色允許的資源。 等待核准 授予要求正在等待核准者做出決定。 已遭拒 核准者已拒絕授權要求。 已結束 授權已結束,且已從主體移除角色。 已過期 授權要求已過期,因為未在 24 小時內或排定的啟用時間前獲得核准。 已撤銷 系統會撤銷授予的權限,主體也無法再存取角色允許的資源。 撤銷中 正在撤銷授權。 排定傳送時間: DATE系統會排定授權時間,並在所選啟用時間啟用,前提是屆時已取得所有核准 (如有需要)。 撤回中 正在撤銷授權。 已撤銷 撤銷授權,主體不再具有角色允許的資源存取權。
gcloud
搭配 had-created 呼叫端關係使用的 gcloud alpha pam grants search 指令會搜尋您建立的授權。如要查看狀態,請在回應中尋找 state 欄位。
使用下列任何指令資料前,請先替換以下項目:
ENTITLEMENT_ID:授權所屬授權的 ID。RESOURCE_TYPE:選用。授權所屬的資源類型。請使用organization、folder或project值。RESOURCE_ID:與RESOURCE_TYPE搭配使用。要管理授權的 Google Cloud專案、資料夾或組織 ID。專案 ID 是英數字串,例如my-project。 資料夾和組織 ID 則為數字,例如123456789012。
執行下列指令:
Linux、macOS 或 Cloud Shell
gcloud alpha pam grants search \ --entitlement=ENTITLEMENT_ID \ --caller-relationship=had-created \ --location=global \ --RESOURCE_TYPE=RESOURCE_ID
Windows (PowerShell)
gcloud alpha pam grants search ` --entitlement=ENTITLEMENT_ID ` --caller-relationship=had-created ` --location=global ` --RESOURCE_TYPE=RESOURCE_ID
Windows (cmd.exe)
gcloud alpha pam grants search ^ --entitlement=ENTITLEMENT_ID ^ --caller-relationship=had-created ^ --location=global ^ --RESOURCE_TYPE=RESOURCE_ID
您應該會收到類似以下的回應:
additionalEmailRecipients:
- bola@example.com
createTime: '2024-03-07T00:34:32.557017289Z'
justification:
unstructuredJustification: Renaming a file to mitigate issue #312
name: SCOPE/locations/global/entitlements/ENTITLEMENT_ID/grants/GRANT_ID
privilegedAccess:
gcpIamAccess:
resource: //cloudresourcemanager.googleapis.com/RESOURCE_TYPE/RESOURCE_ID
resourceType: cloudresourcemanager.googleapis.com/Project
roleBindings:
- role: roles/storage.admin
id: hwqrt_1
conditionExpression: resource.name == "//cloudresourcemanager.googleapis.com/RESOURCE_TYPE/RESOURCE_ID/buckets/bucket-1" && resource.name.startsWith("//cloudresourcemanager.googleapis.com/RESOURCE_TYPE/RESOURCE_ID/compute/vms")
requestedPrivilegedAccess:
gcpIamAccess:
resource: //cloudresourcemanager.googleapis.com/RESOURCE_TYPE/RESOURCE_ID
resourceType: cloudresourcemanager.googleapis.com/Project
roleBindings:
- role: roles/storage.admin
entitlementRoleBindingId: hwqrt_1
accessRestrictions:
resourceNames:
- //cloudresourcemanager.googleapis.com/RESOURCE_TYPE/RESOURCE_ID/buckets/bucket-1
resourceNamePrefixes:
- //cloudresourcemanager.googleapis.com/RESOURCE_TYPE/RESOURCE_ID/compute/vms
requestedDuration: 3600s
requester: cruz@example.com
state: DENIED
timeline:
events:
- eventTime: '2024-03-07T00:34:32.793769042Z'
requested:
expireTime: '2024-03-08T00:34:32.793769042Z'
- denied:
actor: alex@example.com
reason: Issue has already been resolved
eventTime: '2024-03-07T00:36:08.309116203Z'
updateTime: '2024-03-07T00:34:32.926967128Z'
授權可能呈現下列狀態:
| 狀態 | 說明 |
|---|---|
| 啟用中 | 正在啟用授予項目。 |
| ACTIVATION_FAILED | 發生無法重試的錯誤,因此 Privileged Access Manager 無法授予角色。 |
| ACTIVE | 授權已生效,主體可存取角色允許的資源。 |
| APPROVAL_AWAITED | 授予要求正在等待核准者做出決定。 |
| 禁止所有人使用 | 核准者已拒絕授權要求。 |
| 已結束 | 授權已結束,且已從主體移除角色。 |
| 已過期 | 授權要求已過期,因為未在 24 小時內或排定的啟用時間前獲得核准。 |
| REVOKED | 系統會撤銷授予的權限,主體也無法再存取角色允許的資源。 |
| 撤銷 | 正在撤銷授權。 |
| 已排定 | 系統會排定授權時間,並在所選啟用時間啟用,前提是屆時已取得所有核准 (如有需要)。 |
| 撤回 | 正在撤銷授權。 |
| 已撤回 | 撤銷授權,主體不再具有角色允許的資源存取權。 |
REST
Privileged Access Manager API 的 searchGrants 方法與 HAD_CREATED 呼叫端關係搭配使用,可搜尋您建立的授權。如要查看狀態,請在回應中尋找 state 欄位。
使用任何要求資料之前,請先修改下列項目的值:
SCOPE:權利所在的組織、資料夾或專案,格式為organizations/ORGANIZATION_ID、folders/FOLDER_ID或projects/PROJECT_ID。專案 ID 是英數字串,例如my-project。資料夾和組織 ID 則為數字,例如123456789012。ENTITLEMENT_ID:授權所屬授權的 ID。FILTER:選用。傳回欄位值符合 AIP-160 運算式的授權。PAGE_SIZE:選用。回應中要傳回的項目數量。PAGE_TOKEN:選用。使用先前回應中傳回的頁面權杖,指定要從哪個頁面開始回應。
HTTP 方法和網址:
GET https://privilegedaccessmanager.googleapis.com/v1beta/SCOPE/locations/global/entitlements/ENTITLEMENT_ID/grants:search?callerRelationship=HAD_CREATED&filter=FILTER&pageSize=PAGE_SIZE&pageToken=PAGE_TOKEN
請展開以下其中一個選項,以傳送要求:
您應該會收到如下的 JSON 回覆:
{
"grants": [
{
"name": "SCOPE/locations/global/entitlements/ENTITLEMENT_ID/grants/GRANT_ID",
"createTime": "2024-03-06T03:08:49.330577625Z",
"updateTime": "2024-03-06T03:08:49.625874598Z",
"requester": "alex@example.com",
"requestedDuration": "3600s",
"justification": {
"unstructuredJustification": "Emergency service for outage"
},
"state": "APPROVAL_AWAITED",
"timeline": {
"events": [
{
"eventTime": "2024-03-06T03:08:49.462765846Z",
"requested": {
"expireTime": "2024-03-07T03:08:49.462765846Z"
}
}
]
},
"privilegedAccess": {
"gcpIamAccess": {
"resourceType": "cloudresourcemanager.googleapis.com/Project",
"resource": "//cloudresourcemanager.googleapis.com/SCOPE",
"roleBindings": [
{
"role": "roles/storage.admin",
"id": "hwqrt_1",
"conditionExpression": "resource.name == \"//cloudresourcemanager.googleapis.com/SCOPE/buckets/bucket-1\" && resource.name.startsWith(\"//cloudresourcemanager.googleapis.com/SCOPE/compute/vms\")"
"conditionExpression": "resource.name == \"//cloudresourcemanager.googleapis.com/SCOPE/buckets/bucket-1\" && resource.name.startsWith(\"//cloudresourcemanager.googleapis.com/SCOPE/compute/vms\")"
}
]
}
},
"requestedPrivilegedAccess": {
"gcpIamAccess": {
"resourceType": "cloudresourcemanager.googleapis.com/Project",
"resource": "//cloudresourcemanager.googleapis.com/SCOPE",
"roleBindings": [
{
"role": "roles/storage.admin",
"entitlementRoleBindingId": "hwqrt_1",
"accessRestrictions": {
"resourceNames": ["//cloudresourcemanager.googleapis.com/SCOPE/buckets/bucket-1"
],
"resourceNamePrefixes": ["//cloudresourcemanager.googleapis.com/SCOPE/compute/vms"
]
}
}
]
}
},
"additionalEmailRecipients": [
"bola@google.com"
]
}
]
}
下表詳細說明補助狀態。
| 狀態 | 說明 |
|---|---|
| 啟用中 | 正在啟用授予項目。 |
| ACTIVATION_FAILED | 發生無法重試的錯誤,因此 Privileged Access Manager 無法授予角色。 |
| ACTIVE | 授權已生效,主體可存取角色允許的資源。 |
| APPROVAL_AWAITED | 授予要求正在等待核准者做出決定。 |
| 禁止所有人使用 | 核准者已拒絕授權要求。 |
| 已結束 | 授權已結束,且已從主體移除角色。 |
| 已過期 | 授權要求已過期,因為未在 24 小時內或排定的啟用時間前獲得核准。 |
| REVOKED | 系統會撤銷授予的權限,主體也無法再存取角色允許的資源。 |
| 撤銷 | 正在撤銷授權。 |
| 已排定 | 系統會排定授權時間,並在所選啟用時間啟用,前提是屆時已取得所有核准 (如有需要)。 |
| 撤回 | 正在撤銷授權。 |
| 已撤回 | 撤銷授權,主體不再具有角色允許的資源存取權。 |