Method updateAccessBindings

Updates access bindings for the specified service account.

HTTP request

POST https://iam.api.cloud.yandex.net/iam/v1/serviceAccounts/{resourceId}:updateAccessBindings

Path parameters

Parameter Description
resourceId Required. ID of the resource for which access bindings are being updated.

Body parameters

{
  "accessBindingDeltas": [
    {
      "action": "string",
      "accessBinding": {
        "roleId": "string",
        "subject": {
          "id": "string",
          "type": "string"
        }
      }
    }
  ]
}
Field Description
accessBindingDeltas[] object

Required. Updates to access bindings.

accessBindingDeltas[].
action
string

Required. The action that is being performed on an access binding.

  • ADD: Addition of an access binding.
  • REMOVE: Removal of an access binding.
accessBindingDeltas[].
accessBinding
object

Required. Access binding. For more information, see Access Bindings.

accessBindingDeltas[].
accessBinding.
roleId
string

ID of the Role that is assigned to the subject.

The maximum string length in characters is 50.

accessBindingDeltas[].
accessBinding.
subject
object

Required. Identity for which access binding is being created. It can represent an account with a unique ID or several accounts with a system identifier.

accessBindingDeltas[].
accessBinding.
subject.
id
string

ID of the subject.

It can contain one of the following values:

  • allAuthenticatedUsers: A special system identifier that represents anyone who is authenticated. It can be used only if the type is system.

  • <cloud generated id>: An identifier that represents a user account. It can be used only if the type is userAccount or serviceAccount.

The maximum string length in characters is 50.

accessBindingDeltas[].
accessBinding.
subject.
type
string

Type of the subject.

It can contain one of the following values:

  • system: System group. This type represents several accounts with a common system identifier.
  • userAccount: An user account (for example, "alice.the.girl@yandex.ru"). This type represents the UserAccount resource.
  • serviceAccount: A service account. This type represents the ServiceAccount resource.

For more information, see Subject to which the role is assigned.

Response

HTTP Code: 200 - OK

{
  "id": "string",
  "description": "string",
  "createdAt": "string",
  "createdBy": "string",
  "modifiedAt": "string",
  "done": true,
  "metadata": "object",

  //  includes only one of the fields `error`, `response`
  "error": {
    "code": "integer",
    "message": "string",
    "details": [
      "object"
    ]
  },
  "response": "object",
  // end of the list of possible fields

}

An Operation resource. For more information, see Operation.

Field Description
id string

ID of the operation.

description string

Description of the operation. 0-256 characters long.

createdAt string (date-time)

Creation timestamp.

String in RFC3339 text format.

createdBy string

ID of the user or service account who initiated the operation.

modifiedAt string (date-time)

The time when the Operation resource was last modified.

String in RFC3339 text format.

done boolean (boolean)

If the value is false, it means the operation is still in progress. If true, the operation is completed, and either error or response is available.

metadata object

Service-specific metadata associated with the operation. It typically contains the ID of the target resource that the operation is performed on. Any method that returns a long-running operation should document the metadata type, if any.

error object
The error result of the operation in case of failure or cancellation.
includes only one of the fields error, response

The error result of the operation in case of failure or cancellation.

error.
code
integer (int32)

Error code. An enum value of google.rpc.Code.

error.
message
string

An error message.

error.
details[]
object

A list of messages that carry the error details.

response object
includes only one of the fields error, response

The normal response of the operation in case of success. If the original method returns no data on success, such as Delete, the response is google.protobuf.Empty. If the original method is the standard Create/Update, the response should be the target resource of the operation. Any method that returns a long-running operation should document the response type, if any.