google_api_iam v0.26.4 GoogleApi.IAM.V1.Api.Organizations View Source
API calls for all endpoints tagged Organizations
.
Link to this section Summary
Functions
Creates a new custom Role.
Deletes a custom Role.
Gets the definition of a Role.
Lists every predefined Role that IAM supports, or every custom role that is defined for an organization or project.
Updates the definition of a custom Role.
Link to this section Functions
iam_organizations_roles_create(connection, organizations_id, optional_params \\ [], opts \\ [])
View SourceSpecs
iam_organizations_roles_create( Tesla.Env.client(), String.t(), keyword(), keyword() ) :: {:ok, GoogleApi.IAM.V1.Model.Role.t()} | {:ok, Tesla.Env.t()} | {:error, any()}
Creates a new custom Role.
Parameters
connection
(type:GoogleApi.IAM.V1.Connection.t
) - Connection to serverorganizations_id
(type:String.t
) - Part ofparent
. Theparent
parameter's value depends on the target resource for the request, namelyprojects
ororganizations
. Each resource type'sparent
value format is described below:projects.roles.create()
:projects/{PROJECT_ID}
. This method creates project-level custom roles. Example request URL:https://iam.googleapis.com/v1/projects/{PROJECT_ID}/roles
organizations.roles.create()
:organizations/{ORGANIZATION_ID}
. This method creates organization-level custom roles. Example request URL:https://iam.googleapis.com/v1/organizations/{ORGANIZATION_ID}/roles
Note: Wildcard (*) values are invalid; you must specify a complete project ID or organization ID.
optional_params
(type:keyword()
) - Optional parameters-
:"$.xgafv"
(type:String.t
) - V1 error format. -
:access_token
(type:String.t
) - OAuth access token. -
:alt
(type:String.t
) - Data format for response. -
:callback
(type:String.t
) - JSONP -
:fields
(type:String.t
) - Selector specifying which fields to include in a partial response. -
:key
(type:String.t
) - API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. -
:oauth_token
(type:String.t
) - OAuth 2.0 token for the current user. -
:prettyPrint
(type:boolean()
) - Returns response with indentations and line breaks. -
:quotaUser
(type:String.t
) - Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. -
:uploadType
(type:String.t
) - Legacy upload protocol for media (e.g. "media", "multipart"). -
:upload_protocol
(type:String.t
) - Upload protocol for media (e.g. "raw", "multipart"). -
:body
(type:GoogleApi.IAM.V1.Model.CreateRoleRequest.t
) -
-
opts
(type:keyword()
) - Call options
Returns
-
{:ok, %GoogleApi.IAM.V1.Model.Role{}}
on success -
{:error, info}
on failure
iam_organizations_roles_delete(connection, organizations_id, roles_id, optional_params \\ [], opts \\ [])
View SourceSpecs
iam_organizations_roles_delete( Tesla.Env.client(), String.t(), String.t(), keyword(), keyword() ) :: {:ok, GoogleApi.IAM.V1.Model.Role.t()} | {:ok, Tesla.Env.t()} | {:error, any()}
Deletes a custom Role.
When you delete a custom role, the following changes occur immediately:
- You cannot bind a member to the custom role in an IAM Policy.
- Existing bindings to the custom role are not changed, but they have no effect.
- By default, the response from ListRoles does not include the custom role.
You have 7 days to undelete the custom role. After 7 days, the following changes occur:
- The custom role is permanently deleted and cannot be recovered.
- If an IAM policy contains a binding to the custom role, the binding is permanently removed.
Parameters
connection
(type:GoogleApi.IAM.V1.Connection.t
) - Connection to serverorganizations_id
(type:String.t
) - Part ofname
. Thename
parameter's value depends on the target resource for the request, namelyprojects
ororganizations
. Each resource type'sname
value format is described below:projects.roles.delete()
:projects/{PROJECT_ID}/roles/{CUSTOM_ROLE_ID}
. This method deletes only custom roles that have been created at the project level. Example request URL:https://iam.googleapis.com/v1/projects/{PROJECT_ID}/roles/{CUSTOM_ROLE_ID}
organizations.roles.delete()
:organizations/{ORGANIZATION_ID}/roles/{CUSTOM_ROLE_ID}
. This method deletes only custom roles that have been created at the organization level. Example request URL:https://iam.googleapis.com/v1/organizations/{ORGANIZATION_ID}/roles/{CUSTOM_ROLE_ID}
Note: Wildcard (*) values are invalid; you must specify a complete project ID or organization ID.
roles_id
(type:String.t
) - Part ofname
. See documentation oforganizationsId
.optional_params
(type:keyword()
) - Optional parameters-
:"$.xgafv"
(type:String.t
) - V1 error format. -
:access_token
(type:String.t
) - OAuth access token. -
:alt
(type:String.t
) - Data format for response. -
:callback
(type:String.t
) - JSONP -
:fields
(type:String.t
) - Selector specifying which fields to include in a partial response. -
:key
(type:String.t
) - API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. -
:oauth_token
(type:String.t
) - OAuth 2.0 token for the current user. -
:prettyPrint
(type:boolean()
) - Returns response with indentations and line breaks. -
:quotaUser
(type:String.t
) - Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. -
:uploadType
(type:String.t
) - Legacy upload protocol for media (e.g. "media", "multipart"). -
:upload_protocol
(type:String.t
) - Upload protocol for media (e.g. "raw", "multipart"). -
:etag
(type:String.t
) - Used to perform a consistent read-modify-write.
-
opts
(type:keyword()
) - Call options
Returns
-
{:ok, %GoogleApi.IAM.V1.Model.Role{}}
on success -
{:error, info}
on failure
iam_organizations_roles_get(connection, organizations_id, roles_id, optional_params \\ [], opts \\ [])
View SourceSpecs
iam_organizations_roles_get( Tesla.Env.client(), String.t(), String.t(), keyword(), keyword() ) :: {:ok, GoogleApi.IAM.V1.Model.Role.t()} | {:ok, Tesla.Env.t()} | {:error, any()}
Gets the definition of a Role.
Parameters
connection
(type:GoogleApi.IAM.V1.Connection.t
) - Connection to serverorganizations_id
(type:String.t
) - Part ofname
. Thename
parameter's value depends on the target resource for the request, namelyroles
,projects
, ororganizations
. Each resource type'sname
value format is described below:roles.get()
:roles/{ROLE_NAME}
. This method returns results from all predefined roles in Cloud IAM. Example request URL:https://iam.googleapis.com/v1/roles/{ROLE_NAME}
projects.roles.get()
:projects/{PROJECT_ID}/roles/{CUSTOM_ROLE_ID}
. This method returns only custom roles that have been created at the project level. Example request URL:https://iam.googleapis.com/v1/projects/{PROJECT_ID}/roles/{CUSTOM_ROLE_ID}
organizations.roles.get()
:organizations/{ORGANIZATION_ID}/roles/{CUSTOM_ROLE_ID}
. This method returns only custom roles that have been created at the organization level. Example request URL:https://iam.googleapis.com/v1/organizations/{ORGANIZATION_ID}/roles/{CUSTOM_ROLE_ID}
Note: Wildcard (*) values are invalid; you must specify a complete project ID or organization ID.
roles_id
(type:String.t
) - Part ofname
. See documentation oforganizationsId
.optional_params
(type:keyword()
) - Optional parameters-
:"$.xgafv"
(type:String.t
) - V1 error format. -
:access_token
(type:String.t
) - OAuth access token. -
:alt
(type:String.t
) - Data format for response. -
:callback
(type:String.t
) - JSONP -
:fields
(type:String.t
) - Selector specifying which fields to include in a partial response. -
:key
(type:String.t
) - API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. -
:oauth_token
(type:String.t
) - OAuth 2.0 token for the current user. -
:prettyPrint
(type:boolean()
) - Returns response with indentations and line breaks. -
:quotaUser
(type:String.t
) - Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. -
:uploadType
(type:String.t
) - Legacy upload protocol for media (e.g. "media", "multipart"). -
:upload_protocol
(type:String.t
) - Upload protocol for media (e.g. "raw", "multipart").
-
opts
(type:keyword()
) - Call options
Returns
-
{:ok, %GoogleApi.IAM.V1.Model.Role{}}
on success -
{:error, info}
on failure
iam_organizations_roles_list(connection, organizations_id, optional_params \\ [], opts \\ [])
View SourceSpecs
iam_organizations_roles_list( Tesla.Env.client(), String.t(), keyword(), keyword() ) :: {:ok, GoogleApi.IAM.V1.Model.ListRolesResponse.t()} | {:ok, Tesla.Env.t()} | {:error, any()}
Lists every predefined Role that IAM supports, or every custom role that is defined for an organization or project.
Parameters
connection
(type:GoogleApi.IAM.V1.Connection.t
) - Connection to serverorganizations_id
(type:String.t
) - Part ofparent
. Theparent
parameter's value depends on the target resource for the request, namelyroles
,projects
, ororganizations
. Each resource type'sparent
value format is described below:roles.list()
: An empty string. This method doesn't require a resource; it simply returns all predefined roles in Cloud IAM. Example request URL:https://iam.googleapis.com/v1/roles
projects.roles.list()
:projects/{PROJECT_ID}
. This method lists all project-level custom roles. Example request URL:https://iam.googleapis.com/v1/projects/{PROJECT_ID}/roles
organizations.roles.list()
:organizations/{ORGANIZATION_ID}
. This method lists all organization-level custom roles. Example request URL:https://iam.googleapis.com/v1/organizations/{ORGANIZATION_ID}/roles
Note: Wildcard (*) values are invalid; you must specify a complete project ID or organization ID.
optional_params
(type:keyword()
) - Optional parameters:"$.xgafv"
(type:String.t
) - V1 error format.:access_token
(type:String.t
) - OAuth access token.:alt
(type:String.t
) - Data format for response.:callback
(type:String.t
) - JSONP:fields
(type:String.t
) - Selector specifying which fields to include in a partial response.:key
(type:String.t
) - API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.:oauth_token
(type:String.t
) - OAuth 2.0 token for the current user.:prettyPrint
(type:boolean()
) - Returns response with indentations and line breaks.:quotaUser
(type:String.t
) - Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.:uploadType
(type:String.t
) - Legacy upload protocol for media (e.g. "media", "multipart").:upload_protocol
(type:String.t
) - Upload protocol for media (e.g. "raw", "multipart").:pageSize
(type:integer()
) - Optional limit on the number of roles to include in the response.The default is 300, and the maximum is 1,000.
:pageToken
(type:String.t
) - Optional pagination token returned in an earlier ListRolesResponse.:showDeleted
(type:boolean()
) - Include Roles that have been deleted.:view
(type:String.t
) - Optional view for the returned Role objects. WhenFULL
is specified, theincludedPermissions
field is returned, which includes a list of all permissions in the role. The default value isBASIC
, which does not return theincludedPermissions
field.
opts
(type:keyword()
) - Call options
Returns
-
{:ok, %GoogleApi.IAM.V1.Model.ListRolesResponse{}}
on success -
{:error, info}
on failure
iam_organizations_roles_patch(connection, organizations_id, roles_id, optional_params \\ [], opts \\ [])
View SourceSpecs
iam_organizations_roles_patch( Tesla.Env.client(), String.t(), String.t(), keyword(), keyword() ) :: {:ok, GoogleApi.IAM.V1.Model.Role.t()} | {:ok, Tesla.Env.t()} | {:error, any()}
Updates the definition of a custom Role.
Parameters
connection
(type:GoogleApi.IAM.V1.Connection.t
) - Connection to serverorganizations_id
(type:String.t
) - Part ofname
. Thename
parameter's value depends on the target resource for the request, namelyprojects
ororganizations
. Each resource type'sname
value format is described below:projects.roles.patch()
:projects/{PROJECT_ID}/roles/{CUSTOM_ROLE_ID}
. This method updates only custom roles that have been created at the project level. Example request URL:https://iam.googleapis.com/v1/projects/{PROJECT_ID}/roles/{CUSTOM_ROLE_ID}
organizations.roles.patch()
:organizations/{ORGANIZATION_ID}/roles/{CUSTOM_ROLE_ID}
. This method updates only custom roles that have been created at the organization level. Example request URL:https://iam.googleapis.com/v1/organizations/{ORGANIZATION_ID}/roles/{CUSTOM_ROLE_ID}
Note: Wildcard (*) values are invalid; you must specify a complete project ID or organization ID.
roles_id
(type:String.t
) - Part ofname
. See documentation oforganizationsId
.optional_params
(type:keyword()
) - Optional parameters-
:"$.xgafv"
(type:String.t
) - V1 error format. -
:access_token
(type:String.t
) - OAuth access token. -
:alt
(type:String.t
) - Data format for response. -
:callback
(type:String.t
) - JSONP -
:fields
(type:String.t
) - Selector specifying which fields to include in a partial response. -
:key
(type:String.t
) - API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. -
:oauth_token
(type:String.t
) - OAuth 2.0 token for the current user. -
:prettyPrint
(type:boolean()
) - Returns response with indentations and line breaks. -
:quotaUser
(type:String.t
) - Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. -
:uploadType
(type:String.t
) - Legacy upload protocol for media (e.g. "media", "multipart"). -
:upload_protocol
(type:String.t
) - Upload protocol for media (e.g. "raw", "multipart"). -
:updateMask
(type:String.t
) - A mask describing which fields in the Role have changed. -
:body
(type:GoogleApi.IAM.V1.Model.Role.t
) -
-
opts
(type:keyword()
) - Call options
Returns
-
{:ok, %GoogleApi.IAM.V1.Model.Role{}}
on success -
{:error, info}
on failure
iam_organizations_roles_undelete(connection, organizations_id, roles_id, optional_params \\ [], opts \\ [])
View SourceSpecs
iam_organizations_roles_undelete( Tesla.Env.client(), String.t(), String.t(), keyword(), keyword() ) :: {:ok, GoogleApi.IAM.V1.Model.Role.t()} | {:ok, Tesla.Env.t()} | {:error, any()}
Undeletes a custom Role.
Parameters
connection
(type:GoogleApi.IAM.V1.Connection.t
) - Connection to serverorganizations_id
(type:String.t
) - Part ofname
. Thename
parameter's value depends on the target resource for the request, namelyprojects
ororganizations
. Each resource type'sname
value format is described below:projects.roles.undelete()
:projects/{PROJECT_ID}/roles/{CUSTOM_ROLE_ID}
. This method undeletes only custom roles that have been created at the project level. Example request URL:https://iam.googleapis.com/v1/projects/{PROJECT_ID}/roles/{CUSTOM_ROLE_ID}
organizations.roles.undelete()
:organizations/{ORGANIZATION_ID}/roles/{CUSTOM_ROLE_ID}
. This method undeletes only custom roles that have been created at the organization level. Example request URL:https://iam.googleapis.com/v1/organizations/{ORGANIZATION_ID}/roles/{CUSTOM_ROLE_ID}
Note: Wildcard (*) values are invalid; you must specify a complete project ID or organization ID.
roles_id
(type:String.t
) - Part ofname
. See documentation oforganizationsId
.optional_params
(type:keyword()
) - Optional parameters-
:"$.xgafv"
(type:String.t
) - V1 error format. -
:access_token
(type:String.t
) - OAuth access token. -
:alt
(type:String.t
) - Data format for response. -
:callback
(type:String.t
) - JSONP -
:fields
(type:String.t
) - Selector specifying which fields to include in a partial response. -
:key
(type:String.t
) - API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. -
:oauth_token
(type:String.t
) - OAuth 2.0 token for the current user. -
:prettyPrint
(type:boolean()
) - Returns response with indentations and line breaks. -
:quotaUser
(type:String.t
) - Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. -
:uploadType
(type:String.t
) - Legacy upload protocol for media (e.g. "media", "multipart"). -
:upload_protocol
(type:String.t
) - Upload protocol for media (e.g. "raw", "multipart"). -
:body
(type:GoogleApi.IAM.V1.Model.UndeleteRoleRequest.t
) -
-
opts
(type:keyword()
) - Call options
Returns
-
{:ok, %GoogleApi.IAM.V1.Model.Role{}}
on success -
{:error, info}
on failure