索引
IAMPolicy
(接口)Binding
(消息)GetIamPolicyRequest
(消息)Policy
(消息)SetIamPolicyRequest
(消息)TestIamPermissionsRequest
(消息)TestIamPermissionsResponse
(消息)
IAMPolicy
API 概览
此接口管理 Identity and Access Management (IAM) 政策。
任何提供访问权限控制功能的 API 的实现都会实现 google.iam.v1.IAMPolicy 接口。
数据模型
当主体(用户或服务帐号)对服务提供的资源执行操作时,系统就会执行访问权限控制。由类似 URI 的名称标识的资源是访问权限控制规范的基本单元。服务实现可以选择访问权限控制的粒度以及其资源支持的权限。例如,一个数据库服务可能仅允许在表级层指定访问权限控制,而另一个数据库服务可能还允许在列级层指定访问权限控制。
政策结构
请参阅 google.iam.v1.Policy
我们特意不采用 CRUD 样式的 API,因为访问控制政策是与其附加到的资源一并隐式创建和删除的。
GetIamPolicy | |
---|---|
获取资源的访问权限控制政策。如果资源存在但未设置政策,则返回空政策。
|
SetIamPolicy | |
---|---|
设置对指定资源的访问权限控制政策。替换任何现有政策。
|
TestIamPermissions | |
---|---|
返回调用者对指定资源拥有的权限。如果资源不存在,则返回一个空权限集,而非返回 NOT_FOUND 错误。 注意:此操作旨在用于构建权限感知型界面和命令行工具,而不是用于授权检查。此操作可能会在没有警告的情况下“应急开启”。
|
Binding
将 members
与 role
关联。
字段 | |
---|---|
role |
分配给 |
members[] |
指定请求访问 Cloud Platform 资源的身份。
|
condition |
未实现。与此绑定关联的条件。注意:若不满足条件,则不允许用户通过当前绑定进行访问。不同的绑定(包括其条件)是独立检查的。 |
GetIamPolicyRequest
GetIamPolicy
方法的请求消息。
字段 | |
---|---|
resource |
必需字段:要为其请求政策的资源。如需了解此字段的适当值,请参阅操作文档。 |
政策
定义 Identity and Access Management (IAM) 政策,用于指定 Cloud Platform 资源的访问权限控制政策。
Policy
由一系列 bindings
组成。binding
会将 members
列表绑定到 role
,其中成员可以是用户帐号、Google 群组、Google 网域和服务帐号。role
是 IAM 定义的指定权限的列表。
JSON 示例
{
"bindings": [
{
"role": "roles/owner",
"members": [
"user:mike@example.com",
"group:admins@example.com",
"domain:google.com",
"serviceAccount:my-other-app@appspot.gserviceaccount.com"
]
},
{
"role": "roles/viewer",
"members": ["user:sean@example.com"]
}
]
}
YAML 示例
bindings:
- members:
- user:mike@example.com
- group:admins@example.com
- domain:google.com
- serviceAccount:my-other-app@appspot.gserviceaccount.com
role: roles/owner
- members:
- user:sean@example.com
role: roles/viewer
如需了解 IAM 及其功能,请参阅 IAM 开发者指南。
字段 | |
---|---|
version |
已弃用。 |
bindings[] |
将一系列 |
etag |
如果在调用 |
SetIamPolicyRequest
SetIamPolicy
方法的请求消息。
字段 | |
---|---|
resource |
必需:要为其指定政策的资源。如需了解此字段的适当值,请参阅操作文档。 |
policy |
必需:要应用于 |
TestIamPermissionsRequest
TestIamPermissions
方法的请求消息。
字段 | |
---|---|
resource |
必需字段:要为其请求政策详情的资源。如需了解此字段的适当值,请参阅操作文档。 |
permissions[] |
要用于检查 |
TestIamPermissionsResponse
TestIamPermissions
方法的响应消息。
字段 | |
---|---|
permissions[] |
调用者可以使用的 |