REST Resource: projects.locations.aclPolicies

Resource: AclPolicy

The ACL policy resource.

JSON representation
{
  "name": string,
  "rules": [
    {
      object (AclRule)
    }
  ],
  "state": enum (State),
  "instanceAclPolicyAttachments": [
    {
      object (InstanceAclPolicyAttachment)
    }
  ],
  "createTime": string,
  "updateTime": string,
  "version": string,
  "etag": string
}
Fields
name

string

Identifier. Full resource path of the ACL policy.

rules[]

object (AclRule)

Required. The ACL rules within the ACL policy.

state

enum (State)

Output only. The state of the ACL policy.

instanceAclPolicyAttachments[]

object (InstanceAclPolicyAttachment)

Output only. The ACL policy attachment status for each attached instance.

createTime

string (Timestamp format)

Output only. The timestamp that the ACL policy was created.

Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" or "2014-10-02T15:01:23+05:30".

updateTime

string (Timestamp format)

Output only. The timestamp that the ACL policy was last updated.

Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" or "2014-10-02T15:01:23+05:30".

version
(deprecated)

string (int64 format)

Output only. Deprecated: Used in drift resolution.

etag

string

Output only. Etag of the ACL policy.

AclRule

A single ACL rule which defines the policy for a user.

JSON representation
{
  "username": string,
  "rule": string
}
Fields
username

string

Required. Specifies the IAM user or service account to be added to the ACL policy. This username will be directly set on the Valkey OSS.

rule

string

Required. The rule to be applied to the username. Ex: "on >password123 ~* +@all" The format of the rule is defined by Valkey OSS: https://valkey.io/topics/acl/

State

Represents the different states of an ACL policy.

Enums
STATE_UNSPECIFIED Not set.
ACTIVE ACL policy has been created and is fully usable.
UPDATING ACL policy is being updated.
DELETING ACL policy is being deleted.

InstanceAclPolicyAttachment

InstanceAclPolicyAttachment stores the ACL policy status for an attached instance for the revisions successfully applied, under application or failed.

JSON representation
{
  "instance": string,
  "aclPolicyRevisionStatuses": [
    {
      object (AclPolicyRevisionStatus)
    }
  ]
}
Fields
instance

string

Output only. The resource name of the attached instance. Format: "projects/{project}/locations/{location}/instances/{instance}"

aclPolicyRevisionStatuses[]

object (AclPolicyRevisionStatus)

Output only. A list of status for various revisions of this ACL policy on the instance.

Methods

create

Creates an ACL policy.

delete

Deletes a specific ACL policy.

get

Gets the details of a specific Memorystore ACL policy.

list

Lists all ACL policies owned by a project in either the specified location (region) or all locations.

patch

Updates the ACL policy.