索引
Binding(訊息)GetIamPolicyRequest(訊息)GetPolicyOptions(訊息)Policy(訊息)SetIamPolicyRequest(訊息)
繫結
將 members (或主體) 與 role 建立關聯。
| 欄位 | |
|---|---|
role |
指派給 如要瞭解身分與存取權管理角色和權限，請參閱身分與存取權管理說明文件。如需可用預先定義角色的清單，請參閱這篇文章。 |
members[] |
指定向 Google Cloud 資源要求存取權的主體。
|
condition |
與此繫結相關聯的條件。 如果條件評估結果為 如果條件評估結果為 如要瞭解哪些資源支援 IAM 政策中的條件，請參閱 IAM 說明文件。 |
GetIamPolicyRequest
GetIamPolicy 方法的要求訊息。
| 欄位 | |
|---|---|
resource |
必要：要求的政策資源。如要瞭解這個欄位的適當值，請參閱「資源名稱」。 |
options |
選用：用來指定 |
GetPolicyOptions
封裝提供給 GetIamPolicy 的設定。
| 欄位 | |
|---|---|
requested_policy_version |
(選用步驟) 用於設定政策格式的最高政策版本。 有效值為 0、1 和 3。如果要求指定的值無效，系統會拒絕要求。 如果政策含有任何條件式角色繫結，要求就必須指定版本 3。如果政策沒有條件角色繫結，可以指定任何有效值，或將欄位留空。 回應中的政策可能會使用您指定的政策版本，也可能使用較低的政策版本。舉例來說，如果您指定版本 3，但政策沒有條件式角色繫結，回應就會使用版本 1。 如要瞭解哪些資源支援 IAM 政策中的條件，請參閱 IAM 說明文件。 |
政策
Identity and Access Management (IAM) 政策，用於指定 Google Cloud 資源的存取權控管。
Policy 是 bindings 的集合。binding 會將一或多個 members 或主體繫結至單一 role。主體可以是使用者帳戶、服務帳戶、Google 群組和網域 (例如 G Suite)。role 是具名權限清單，每個 role 可以是 IAM 預先定義的角色，也可以是使用者建立的自訂角色。
對於某些類型的 Google Cloud 資源，binding 也可以指定 condition，這是邏輯運算式，只有在運算式評估結果為 true 時，才允許存取資源。條件可根據要求、資源或兩者的屬性新增限制。如要瞭解哪些資源支援 IAM 政策中的條件，請參閱 IAM 說明文件。
JSON 範例：
{
"bindings": [
{
"role": "roles/resourcemanager.organizationAdmin",
"members": [
"user:mike@example.com",
"group:admins@example.com",
"domain:google.com",
"serviceAccount:my-project-id@appspot.gserviceaccount.com"
]
},
{
"role": "roles/resourcemanager.organizationViewer",
"members": [
"user:eve@example.com"
],
"condition": {
"title": "expirable access",
"description": "Does not grant access after Sep 2020",
"expression": "request.time < timestamp('2020-10-01T00:00:00.000Z')",
}
}
],
"etag": "BwWWja0YfJA=",
"version": 3
}
YAML 範例：
bindings:
- members:
- user:mike@example.com
- group:admins@example.com
- domain:google.com
- serviceAccount:my-project-id@appspot.gserviceaccount.com
role: roles/resourcemanager.organizationAdmin
- members:
- user:eve@example.com
role: roles/resourcemanager.organizationViewer
condition:
title: expirable access
description: Does not grant access after Sep 2020
expression: request.time < timestamp('2020-10-01T00:00:00.000Z')
etag: BwWWja0YfJA=
version: 3
如需 IAM 及其功能的說明，請參閱 IAM 說明文件。
| 欄位 | |
|---|---|
version |
指定政策格式。 有效值為 凡是會影響條件式角色繫結的作業，都必須指定版本
重要事項：如果您使用 IAM 條件，每次呼叫 如果政策不含任何條件，對該政策執行的作業可以指定任何有效版本，或將欄位留空。 如要瞭解哪些資源支援 IAM 政策中的條件，請參閱 IAM 說明文件。 |
bindings[] |
將
|
etag |
重要事項：如果您使用 IAM 條件，每次呼叫 |
SetIamPolicyRequest
SetIamPolicy 方法的要求訊息。
| 欄位 | |
|---|---|
resource |
必要：指定政策的資源。如要瞭解這個欄位的適當值，請參閱「資源名稱」。 |
policy |
必要：要套用至 |