REST Resource: projects.locations.clusters

리소스: 클러스터

클러스터 인스턴스입니다.

JSON 표현
{
  "name": string,
  "createTime": string,
  "state": enum (State),
  "uid": string,
  "authorizationMode": enum (AuthorizationMode),
  "transitEncryptionMode": enum (TransitEncryptionMode),
  "pscConfigs": [
    {
      object (PscConfig)
    }
  ],
  "discoveryEndpoints": [
    {
      object (DiscoveryEndpoint)
    }
  ],
  "pscConnections": [
    {
      object (PscConnection)
    }
  ],
  "stateInfo": {
    object (StateInfo)
  },
  "nodeType": enum (NodeType),
  "persistenceConfig": {
    object (ClusterPersistenceConfig)
  },
  "redisConfigs": {
    string: string,
    ...
  },
  "zoneDistributionConfig": {
    object (ZoneDistributionConfig)
  },
  "crossClusterReplicationConfig": {
    object (CrossClusterReplicationConfig)
  },
  "pscServiceAttachments": [
    {
      object (PscServiceAttachment)
    }
  ],
  "clusterEndpoints": [
    {
      object (ClusterEndpoint)
    }
  ],
  "automatedBackupConfig": {
    object (AutomatedBackupConfig)
  },
  "encryptionInfo": {
    object (EncryptionInfo)
  },
  "allowFewerZonesDeployment": boolean,

  // Union field import_sources can be only one of the following:
  "gcsSource": {
    object (GcsBackupSource)
  },
  "managedBackupSource": {
    object (ManagedBackupSource)
  }
  // End of list of possible types for union field import_sources.
  "replicaCount": integer,
  "sizeGb": integer,
  "shardCount": integer,
  "preciseSizeGb": number,
  "deletionProtectionEnabled": boolean,
  "maintenancePolicy": {
    object (ClusterMaintenancePolicy)
  },
  "maintenanceSchedule": {
    object (ClusterMaintenanceSchedule)
  },
  "simulateMaintenanceEvent": boolean,
  "backupCollection": string,
  "kmsKey": string,
  "ondemandMaintenance": boolean,
  "asyncClusterEndpointsDeletionEnabled": boolean
}
필드
name

string

필수 항목입니다. 식별자. projects/{projectId}/locations/{locationId}/clusters/{clusterId} 형식을 사용한 프로젝트 및 위치가 포함된 범위 내 리소스의 고유한 이름입니다.

createTime

string (Timestamp format)

출력 전용입니다. 클러스터 생성 요청과 연결된 타임스탬프입니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.

state

enum (State)

출력 전용입니다. 이 클러스터의 현재 상태입니다. CREATING, READY, UPDATING, DELETING, SUSPENDED일 수 있습니다.

uid

string

출력 전용입니다. 클러스터에 대해 시스템에서 할당한 고유 식별자입니다.

authorizationMode

enum (AuthorizationMode)

선택사항입니다. Redis 클러스터의 승인 모드입니다. 제공되지 않으면 클러스터의 인증 기능이 사용 중지됩니다.

transitEncryptionMode

enum (TransitEncryptionMode)

선택사항입니다. Redis 클러스터의 전송 중인 데이터 암호화입니다. 제공되지 않으면 클러스터의 암호화가 사용 중지됩니다.

pscConfigs[]

object (PscConfig)

선택사항입니다. 각 PscConfig는 Private Service Connect 자동화를 통해 클라이언트 액세스를 위해 클러스터에 IP가 지정될 소비자 네트워크를 구성합니다. 현재는 하나의 PscConfig만 지원됩니다.

discoveryEndpoints[]

object (DiscoveryEndpoint)

출력 전용입니다. Redis 클라이언트가 클러스터에 연결하기 위해 각 지정된 네트워크에 생성된 엔드포인트입니다. 현재 탐색 엔드포인트는 하나만 지원됩니다.

pscConnections[]

object (PscConnection)

출력 전용입니다. 서비스 연결 자동화를 통해 자동 생성된 PSC 연결 목록입니다.

stateInfo

object (StateInfo)

출력 전용입니다. 클러스터의 현재 상태에 대한 추가 정보입니다.

nodeType

enum (NodeType)

선택사항입니다. 클러스터의 Redis 노드 유형입니다. NodeType은 Redis 노드의 기본 머신 유형을 결정합니다.

persistenceConfig

object (ClusterPersistenceConfig)

선택사항입니다. 클러스터의 지속성 구성 (RDB, AOF)입니다.

redisConfigs

map (key: string, value: string)

선택사항입니다. 변경 가능한 Redis 구성에 대한 고객 재정의의 키/값 쌍

"key": value 쌍 목록을 포함하는 객체입니다. 예: { "name": "wrench", "mass": "1.3kg", "count": "3" }

zoneDistributionConfig

object (ZoneDistributionConfig)

선택사항입니다. 이 구성은 고객이 리전 내에서 클러스터 리소스를 분산하기 원하는 방식을 결정하는 데 사용됩니다.

crossClusterReplicationConfig

object (CrossClusterReplicationConfig)

선택사항입니다. 크로스 클러스터 복제 구성입니다.

pscServiceAttachments[]

object (PscServiceAttachment)

출력 전용입니다. PSC 연결을 구성하는 서비스 연결 세부정보

clusterEndpoints[]

object (ClusterEndpoint)

선택사항입니다. 클러스터 엔드포인트 목록입니다.

automatedBackupConfig

object (AutomatedBackupConfig)

선택사항입니다. 클러스터의 자동 백업 구성입니다.

encryptionInfo

object (EncryptionInfo)

출력 전용입니다. 클러스터의 저장 데이터 암호화 정보입니다.

allowFewerZonesDeployment

boolean

선택사항입니다. 변경할 수 없습니다. 고객이 3개 미만의 영역에 멀티 영역 클러스터를 배포해도 되는지 지정할 수 있습니다. 설정 후 클러스터 생성 중에 영역 장애가 발생하면 클러스터는 2개 영역에만 배포되고 수명 주기 동안 2개 영역 내에 유지됩니다.

통합 필드 import_sources. 가져올 소스입니다. import_sources은 다음 중 하나여야 합니다.
gcsSource

object (GcsBackupSource)

선택사항입니다. Cloud Storage 버킷에 저장된 백업 Cloud Storage 버킷은 클러스터와 동일한 리전에 있어야 합니다. 제공된 Cloud Storage 객체에서 가져오려면 읽기 권한이 필요합니다.

managedBackupSource

object (ManagedBackupSource)

선택사항입니다. Memorystore 서비스에서 생성하고 관리하는 백업입니다.

replicaCount

integer

선택사항입니다. 샤드당 복제본 노드 수입니다.

sizeGb

integer

출력 전용입니다. 전체 클러스터의 Redis 메모리 크기(GB)로, 다음 정수로 반올림됩니다.

shardCount

integer

선택사항입니다. Redis 클러스터의 샤드 수입니다.

preciseSizeGb

number

출력 전용입니다. 전체 클러스터의 Redis 메모리 크기(GB)의 정확한 값입니다.

deletionProtectionEnabled

boolean

선택사항입니다. 값이 true로 설정되면 삭제 작업이 실패합니다.

maintenancePolicy

object (ClusterMaintenancePolicy)

선택사항입니다. ClusterMaintenancePolicy는 업데이트를 허용하거나 거부할 시기를 결정합니다.

maintenanceSchedule

object (ClusterMaintenanceSchedule)

출력 전용입니다. ClusterMaintenanceSchedule 출력 전용 게시된 유지보수 일정입니다.

simulateMaintenanceEvent

boolean

선택사항입니다. 입력 전용입니다. 유지보수 이벤트를 시뮬레이션합니다.

backupCollection

string

선택사항입니다. 출력 전용입니다. 백업 컬렉션 전체 리소스 이름입니다. 예: projects/{project}/locations/{location}/backupCollections/{collection}

kmsKey

string

선택사항입니다. 클러스터의 저장 데이터를 암호화하는 데 사용되는 KMS 키입니다.

ondemandMaintenance
(deprecated)

boolean

선택사항입니다. 입력 전용입니다. 클러스터의 주문형 유지보수입니다. 이 필드는 클러스터에서 주문형 중요 업데이트를 트리거하는 데 사용할 수 있습니다.

asyncClusterEndpointsDeletionEnabled

boolean

선택사항입니다. true인 경우 고객이 만들고 등록한 클러스터 엔드포인트를 비동기식으로 삭제할 수 있습니다. 즉, 이러한 클러스터 엔드포인트는 클러스터 엔드포인트의 전달 규칙이 삭제되기 전에 등록 취소될 수 있습니다.

GcsBackupSource

Cloud Storage 버킷에 저장된 백업 Cloud Storage 버킷은 클러스터와 동일한 리전에 있어야 합니다.

JSON 표현
{
  "uris": [
    string
  ]
}
필드
uris[]

string

선택사항입니다. 가져올 Cloud Storage 객체의 URI입니다. 예: gs://bucket1/object1, gs://bucket2/folder2/object2

ManagedBackupSource

Memorystore에서 생성하고 관리하는 백업입니다.

JSON 표현
{
  "backup": string
}
필드
backup

string

선택사항입니다. 예: //redis.googleapis.com/projects/{project}/locations/{location}/backupCollections/{collection}/backups/{backup} 백업 이름의 짧은 버전(접두사 없음)도 지원됩니다(예: projects/{project}/locations/{location}/backupCollections/{collection}/backups/{backupId}). 이 경우 백업이 redis.googleapis.com 아래에 있다고 가정합니다.

Redis 클러스터의 다양한 상태를 나타냅니다.

열거형
STATE_UNSPECIFIED 설정되지 않았습니다.
CREATING Redis 클러스터를 만드는 중입니다.
ACTIVE Redis 클러스터가 생성되었으며 완전히 사용할 수 있습니다.
UPDATING Redis 클러스터 구성을 업데이트하는 중입니다.
DELETING Redis 클러스터를 삭제하는 중입니다.

AuthorizationMode

Redis 클러스터의 사용 가능한 승인 모드입니다.

열거형
AUTH_MODE_UNSPECIFIED 설정되지 않았습니다.
AUTH_MODE_IAM_AUTH IAM 기본 승인 모드
AUTH_MODE_DISABLED 승인 사용 중지 모드

TransitEncryptionMode

사용 가능한 전송 중인 데이터 암호화 모드입니다.

열거형
TRANSIT_ENCRYPTION_MODE_UNSPECIFIED 전송 중인 데이터 암호화가 설정되지 않았습니다.
TRANSIT_ENCRYPTION_MODE_DISABLED 전송 중인 데이터 암호화가 사용 중지되었습니다.
TRANSIT_ENCRYPTION_MODE_SERVER_AUTHENTICATION 전송 중인 데이터 암호화에 서버 관리형 암호화를 사용합니다.

PscConfig

JSON 표현
{
  "network": string
}
필드
network

string

필수 입력란입니다. 탐색 엔드포인트의 IP 주소가 projects/{networkProject}/global/networks/{network_id} 형식으로 예약되는 네트워크입니다.

DiscoveryEndpoint

Redis 클라이언트가 클러스터에 연결할 수 있는 각 네트워크의 엔드포인트입니다.

JSON 표현
{
  "address": string,
  "port": integer,
  "pscConfig": {
    object (PscConfig)
  }
}
필드
address

string

출력 전용입니다. 클라이언트가 서비스에 연결하는 데 사용하는 노출된 Redis 엔드포인트의 주소입니다. 주소는 IP 또는 호스트 이름일 수 있습니다.

port

integer

출력 전용입니다. 노출된 Redis 엔드포인트의 포트 번호입니다.

pscConfig

object (PscConfig)

출력 전용입니다. 엔드포인트가 생성되고 액세스되는 위치에 대한 고객 구성입니다.

PscConnection

PSC 연결의 소비자 리소스 세부정보입니다.

JSON 표현
{
  "pscConnectionId": string,
  "address": string,
  "forwardingRule": string,
  "projectId": string,
  "network": string,
  "serviceAttachment": string,
  "pscConnectionStatus": enum (PscConnectionStatus),
  "connectionType": enum (ConnectionType),

  // Union field ports can be only one of the following:
  "port": integer
  // End of list of possible types for union field ports.
}
필드
pscConnectionId

string

필수 입력란입니다. 서비스 연결에 연결된 전달 규칙의 PSC 연결 ID입니다.

address

string

필수 입력란입니다. PSC 전달 규칙에 대해 소비자 네트워크에 할당된 IP입니다.

forwardingRule

string

필수 입력란입니다. 소비자 측 전달 규칙의 URI입니다. 예: projects/{projectNumOrId}/regions/us-east1/forwardingRules/{resourceId}

projectId

string

선택사항입니다. 전달 규칙이 생성된 소비자 프로젝트의 프로젝트 ID입니다.

network

string

필수 입력란입니다. IP 주소가 있는 소비자 네트워크이며 projects/{projectId}/global/networks/{network_id} 형식입니다.

serviceAttachment

string

필수 입력란입니다. PSC 연결의 타겟인 서비스 연결입니다. 형식은 projects/{project-id}/regions/{region}/serviceAttachments/{service-attachment-id}입니다.

pscConnectionStatus

enum (PscConnectionStatus)

출력 전용입니다. PSC 연결 상태입니다. 이 값은 주기적으로 업데이트됩니다. PSC 연결의 최신 상태를 확인하려면 https://cloud.google.com/vpc/docs/configure-private-service-connect-services#endpoint-details를 따르세요.

connectionType

enum (ConnectionType)

출력 전용입니다. PSC 연결 유형입니다.

통합 필드 ports. 노출된 검색 엔드포인트의 포트 번호입니다. ports은 다음 중 하나여야 합니다.
port

integer

출력 전용입니다. 포트는 기본/리더 또는 검색 엔드포인트에만 설정됩니다.

PscConnectionStatus

PSC 연결 상태입니다.

열거형
PSC_CONNECTION_STATUS_UNSPECIFIED PSC 연결 상태가 지정되지 않았습니다.
PSC_CONNECTION_STATUS_ACTIVE 연결이 활성 상태입니다.
PSC_CONNECTION_STATUS_NOT_FOUND 연결을 찾을 수 없습니다.

ConnectionType

클러스터 액세스 목적의 PSC 연결 유형입니다.

열거형
CONNECTION_TYPE_UNSPECIFIED 클러스터 엔드포인트 유형이 설정되지 않음
CONNECTION_TYPE_DISCOVERY 클러스터 토폴로지 검색에 사용될 클러스터 엔드포인트입니다.
CONNECTION_TYPE_PRIMARY 기본 항목에 액세스하는 기본 엔드포인트로 사용될 클러스터 엔드포인트입니다.
CONNECTION_TYPE_READER 복제본에 액세스하는 데 리더 엔드포인트로 사용될 클러스터 엔드포인트입니다.

StateInfo

클러스터 상태에 관한 추가 정보를 나타냅니다.

JSON 표현
{

  // Union field info can be only one of the following:
  "updateInfo": {
    object (UpdateInfo)
  }
  // End of list of possible types for union field info.
}
필드

통합 필드 info.

info는 다음 중 하나여야 합니다.

updateInfo

object (UpdateInfo)

클러스터 상태가 UPDATING일 때 클러스터에서 진행 중인 업데이트를 설명합니다.

UpdateInfo

업데이트 중인 클러스터에 관한 정보를 나타냅니다.

JSON 표현
{
  "targetShardCount": integer,
  "targetReplicaCount": integer,
  "targetNodeType": enum (NodeType)
}
필드
targetShardCount

integer

Redis 클러스터의 대상 샤드 수

targetReplicaCount

integer

샤드당 대상 복제본 노드 수입니다.

targetNodeType

enum (NodeType)

Redis 클러스터의 타겟 노드 유형입니다.

ClusterPersistenceConfig

지속성 기능의 구성입니다.

JSON 표현
{
  "mode": enum (PersistenceMode),
  "rdbConfig": {
    object (RDBConfig)
  },
  "aofConfig": {
    object (AOFConfig)
  }
}
필드
mode

enum (PersistenceMode)

선택사항입니다. 지속성 모드입니다.

rdbConfig

object (RDBConfig)

선택사항입니다. RDB 구성입니다. 모드가 RDB가 아닌 경우 이 필드는 무시됩니다.

aofConfig

object (AOFConfig)

선택사항. AOF 구성입니다. 모드가 AOF가 아닌 경우 이 필드는 무시됩니다.

PersistenceMode

사용 가능한 지속성 모드입니다.

열거형
PERSISTENCE_MODE_UNSPECIFIED 설정되지 않았습니다.
DISABLED 지속성이 사용 중지되고 스냅샷 데이터가 모두 삭제됩니다.
RDB RDB 기반 지속성이 사용 설정됩니다.
AOF AOF 기반 지속성이 사용 설정됩니다.

RDBConfig

RDB 기반 지속성의 구성입니다.

JSON 표현
{
  "rdbSnapshotPeriod": enum (SnapshotPeriod),
  "rdbSnapshotStartTime": string
}
필드
rdbSnapshotPeriod

enum (SnapshotPeriod)

선택사항. RDB 스냅샷 간 기간입니다.

rdbSnapshotStartTime

string (Timestamp format)

선택사항입니다. 첫 번째 스냅샷을 시도했거나 시도할 시간 및 이후 스냅샷을 정렬할 시간입니다. 입력하지 않으면 현재 시간이 사용됩니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.

SnapshotPeriod

사용 가능한 스냅샷 기간입니다.

열거형
SNAPSHOT_PERIOD_UNSPECIFIED 설정되지 않았습니다.
ONE_HOUR 1시간입니다.
SIX_HOURS 6시간입니다.
TWELVE_HOURS 12시간입니다.
TWENTY_FOUR_HOURS 24시간입니다.

AOFConfig

AOF 기반 지속성의 구성입니다.

JSON 표현
{
  "appendFsync": enum (AppendFsync)
}
필드
appendFsync

enum (AppendFsync)

선택사항입니다. fsync 구성입니다.

AppendFsync

사용 가능한 fsync 모드입니다.

열거형
APPEND_FSYNC_UNSPECIFIED 설정되지 않았습니다. 기본값: EVERYSEC
NO fsync를 사용하지 않습니다. 일반적으로 Linux는 이 구성으로 30초마다 데이터를 플러시하지만 커널의 정확한 조정에 따라 다릅니다.
EVERYSEC 매초 fsync를 실행합니다. 충분히 빠르며 재해가 발생하면 1초의 데이터가 손실될 수 있습니다.
ALWAYS 새 쓰기 명령어가 AOF에 추가될 때마다 fsync를 실행합니다. 성능 저하가 발생하지만 최고의 데이터 손실 방지 기능입니다.

ZoneDistributionConfig

클러스터 리소스 할당을 위한 영역 배포 구성입니다.

JSON 표현
{
  "mode": enum (ZoneDistributionMode),
  "zone": string
}
필드
mode

enum (ZoneDistributionMode)

선택사항입니다. 영역 배포 모드입니다. 지정하지 않으면 기본값은 MULTI_ZONE입니다.

zone

string

선택사항입니다. 단일 영역 배포를 선택하면 영역 필드가 해당 영역의 모든 리소스를 할당하는 데 사용됩니다. MULTI_ZONE에는 적용되지 않으며 MULTI_ZONE 클러스터에서는 무시됩니다.

ZoneDistributionMode

다양한 영역 배포 모드를 정의합니다.

열거형
ZONE_DISTRIBUTION_MODE_UNSPECIFIED 설정되지 않았습니다. 기본값: MULTI_ZONE
MULTI_ZONE 리전 내에서 무작위로 선택된 3개의 영역에 모든 리소스를 배포합니다.
SINGLE_ZONE 단일 영역에 모든 리소스를 배포합니다. 이 모드를 선택하면 영역 필드를 지정해야 합니다.

CrossClusterReplicationConfig

크로스 클러스터 복제 구성입니다.

JSON 표현
{
  "clusterRole": enum (ClusterRole),
  "primaryCluster": {
    object (RemoteCluster)
  },
  "secondaryClusters": [
    {
      object (RemoteCluster)
    }
  ],
  "updateTime": string,
  "membership": {
    object (Membership)
  }
}
필드
clusterRole

enum (ClusterRole)

출력 전용입니다. 크로스 클러스터 복제에서 클러스터의 역할입니다.

primaryCluster

object (RemoteCluster)

이 보조 클러스터의 복제 소스로 사용되는 기본 클러스터의 세부정보입니다.

이 필드는 보조 클러스터에만 설정됩니다.

secondaryClusters[]

object (RemoteCluster)

이 기본 클러스터에서 복제하는 보조 클러스터 목록입니다.

이 필드는 기본 클러스터에만 설정됩니다.

updateTime

string (Timestamp format)

출력 전용입니다. 교차 클러스터 복제 구성이 마지막으로 업데이트된 시간입니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.

membership

object (Membership)

출력 전용입니다. 크로스 클러스터 복제에 참여하는 모든 멤버 클러스터의 출력 전용 뷰입니다. 이 뷰는 클러스터 역할(기본 또는 보조)과 관계없이 모든 멤버 클러스터에서 제공됩니다.

기본 클러스터는 기본 클러스터에서 복제하는 모든 보조 클러스터에 관한 정보를 제공할 수 있습니다. 하지만 보조 클러스터는 복제 중인 기본 클러스터에 대해서만 알고 있습니다. 하지만 기본 클러스터를 사용할 수 없는 시나리오(예: 리전 중단)의 경우 clusters.get 요청을 다른 구성원 클러스터로 전송할 수 있으며 이 필드에는 교차 클러스터 복제에 참여하는 모든 구성원 클러스터가 나열됩니다.

ClusterRole

크로스 클러스터 복제에서 클러스터의 역할입니다.

열거형
CLUSTER_ROLE_UNSPECIFIED 클러스터 역할이 설정되지 않았습니다. 동작은 NONE과 동일합니다.
NONE 이 클러스터는 교차 클러스터 복제에 참여하지 않습니다. 독립적인 클러스터이며 다른 클러스터로 또는 다른 클러스터에서 복제되지 않습니다.
PRIMARY 읽기와 쓰기를 모두 허용하는 클러스터입니다. 이 클러스터에 기록된 데이터는 연결된 보조 클러스터에도 복제됩니다.
SECONDARY 읽기만 허용하고 기본 클러스터에서 데이터를 복제하는 클러스터입니다.

RemoteCluster

크로스 클러스터 복제 설정에서 이 클러스터와 연결된 원격 클러스터의 세부정보입니다.

JSON 표현
{
  "cluster": string,
  "uid": string
}
필드
cluster

string

출력 전용입니다. 원격 클러스터의 전체 리소스 경로입니다. 형식은 projects//locations//clusters/입니다.

uid

string

출력 전용입니다. 원격 클러스터의 고유 식별자입니다.

멤버십

크로스 클러스터 복제에 참여하는 모든 멤버 클러스터의 출력 전용 뷰입니다.

JSON 표현
{
  "primaryCluster": {
    object (RemoteCluster)
  },
  "secondaryClusters": [
    {
      object (RemoteCluster)
    }
  ]
}
필드
primaryCluster

object (RemoteCluster)

출력 전용입니다. 보조 클러스터의 복제 소스 역할을 하는 기본 클러스터입니다.

secondaryClusters[]

object (RemoteCluster)

출력 전용입니다. 기본 클러스터에서 복제하는 보조 클러스터 목록입니다.

ClusterMaintenancePolicy

클러스터별 유지보수 정책입니다.

JSON 표현
{
  "createTime": string,
  "updateTime": string,
  "weeklyMaintenanceWindow": [
    {
      object (ClusterWeeklyMaintenanceWindow)
    }
  ]
}
필드
createTime

string (Timestamp format)

출력 전용입니다. 정책이 생성된 시간, 즉 유지보수 기간 또는 거부 기간이 할당된 시간입니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.

updateTime

string (Timestamp format)

출력 전용입니다. 정책이 업데이트된 시간입니다(예: 유지보수 기간 또는 거부 기간이 업데이트됨).

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.

weeklyMaintenanceWindow[]

object (ClusterWeeklyMaintenanceWindow)

선택사항입니다. 이 정책이 해당하는 리소스에 적용되는 유지보수 기간입니다. 최소 1입니다. 현재 버전의 경우 weeklyMaintenanceWindow의 최댓값은 1입니다.

ClusterWeeklyMaintenanceWindow

주간 운영에 지정된 시간 범위입니다.

JSON 표현
{
  "day": enum (DayOfWeek),
  "startTime": {
    object (TimeOfDay)
  }
}
필드
day

enum (DayOfWeek)

선택사항입니다. 지정된 요일에 실행되는 일정을 정의할 수 있습니다.

startTime

object (TimeOfDay)

선택사항입니다. 기간의 시작 시간(UTC)입니다.

ClusterMaintenanceSchedule

예정된 유지보수 일정입니다.

JSON 표현
{
  "startTime": string,
  "endTime": string
}
필드
startTime

string (Timestamp format)

출력 전용입니다. 이 인스턴스에 예정된 유지보수의 시작 시간입니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.

endTime

string (Timestamp format)

출력 전용입니다. 이 인스턴스에 예정된 유지보수의 종료 시간입니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.

PscServiceAttachment

PSC 연결을 만들기 위한 클러스터의 서비스 연결 구성입니다.

JSON 표현
{
  "serviceAttachment": string,
  "connectionType": enum (ConnectionType)
}
필드
serviceAttachment

string

출력 전용입니다. 자체 생성 PscConnection이 타겟으로 사용해야 하는 서비스 연결 URI

connectionType

enum (ConnectionType)

출력 전용입니다. 이 서비스 연결을 타겟팅하는 PSC 연결의 유형입니다.

ClusterEndpoint

ClusterEndpoint는 클러스터에 액세스하기 위해 각 VPC 네트워크에서 그룹으로 생성된 PSC 연결로 구성됩니다. 각 그룹에는 클러스터의 각 서비스 연결에 대한 연결이 하나씩 있어야 합니다.

JSON 표현
{
  "connections": [
    {
      object (ConnectionDetail)
    }
  ]
}
필드
connections[]

object (ConnectionDetail)

필수 입력란입니다. PSC 연결 그룹입니다. 클러스터의 각 서비스 연결에 대해 하나씩 동일한 VPC 네트워크에 생성됩니다.

ConnectionDetail

각 PSC 연결의 세부정보입니다.

JSON 표현
{

  // Union field connection can be only one of the following:
  "pscAutoConnection": {
    object (PscAutoConnection)
  },
  "pscConnection": {
    object (PscConnection)
  }
  // End of list of possible types for union field connection.
}
필드
통합 필드 connection. 클러스터에 대한 PSC 연결은 클러스터 생성 중에 서비스 연결 자동화 (자동 등록 연결)를 통해 생성되거나 고객이 직접 생성 (사용자 등록 연결)할 수 있습니다. connection은 다음 중 하나여야 합니다.
pscAutoConnection

object (PscAutoConnection)

서비스 연결 자동화를 통해 생성된 PSC 연결의 세부정보입니다.

pscConnection

object (PscConnection)

클러스터를 소유한 고객이 만든 PSC 연결의 세부정보입니다.

PscAutoConnection

서비스 연결 자동화를 통해 생성된 PSC 연결의 소비자 리소스 세부정보입니다.

JSON 표현
{
  "pscConnectionId": string,
  "address": string,
  "forwardingRule": string,
  "projectId": string,
  "network": string,
  "serviceAttachment": string,
  "pscConnectionStatus": enum (PscConnectionStatus),
  "connectionType": enum (ConnectionType)
}
필드
pscConnectionId

string

출력 전용입니다. 서비스 연결에 연결된 전달 규칙의 PSC 연결 ID입니다.

address

string

출력 전용입니다. PSC 전달 규칙에 대해 소비자 네트워크에 할당된 IP입니다.

forwardingRule

string

출력 전용입니다. 소비자 측 전달 규칙의 URI입니다. 예: projects/{projectNumOrId}/regions/us-east1/forwardingRules/{resourceId}

projectId

string

필수 입력란입니다. 전달 규칙이 생성된 소비자 프로젝트 ID입니다.

network

string

필수 항목. IP 주소가 있는 소비자 네트워크이며 projects/{projectId}/global/networks/{network_id} 형식입니다.

serviceAttachment

string

출력 전용입니다. PSC 연결의 타겟인 서비스 연결입니다. 형식은 projects/{project-id}/regions/{region}/serviceAttachments/{service-attachment-id}입니다.

pscConnectionStatus

enum (PscConnectionStatus)

출력 전용입니다. PSC 연결 상태입니다. 이 값은 주기적으로 업데이트됩니다. 최신 상태는 Private Service Connect API를 사용하세요.

connectionType

enum (ConnectionType)

출력 전용입니다. PSC 연결 유형입니다.

AutomatedBackupConfig

클러스터의 자동 백업 구성입니다.

JSON 표현
{
  "automatedBackupMode": enum (AutomatedBackupMode),

  // Union field schedule can be only one of the following:
  "fixedFrequencySchedule": {
    object (FixedFrequencySchedule)
  }
  // End of list of possible types for union field schedule.
  "retention": string
}
필드
automatedBackupMode

enum (AutomatedBackupMode)

선택사항입니다. 자동 백업 모드입니다. 모드가 사용 중지되면 다른 필드는 무시됩니다.

통합 필드 schedule. 자동 백업 일정입니다. schedule은 다음 중 하나여야 합니다.
fixedFrequencySchedule

object (FixedFrequencySchedule)

선택사항입니다. 고정된 빈도로 자동 백업을 트리거합니다.

retention

string (Duration format)

선택사항입니다. 백업이 삭제되기 전에 자동 백업을 보관할 기간입니다. 값은 1~365일 사이여야 합니다. 지정하지 않으면 기본값은 35일입니다.

소수점 아래가 최대 9자리까지이고 's'로 끝나는 초 단위 기간입니다. 예를 들면 "3.5s"입니다.

FixedFrequencySchedule

이 일정을 사용하면 고정된 빈도로 백업을 트리거할 수 있습니다 (현재는 일일만 지원됨).

JSON 표현
{
  "startTime": {
    object (TimeOfDay)
  }
}
필드
startTime

object (TimeOfDay)

필수 입력란입니다. 모든 자동 백업의 시작 시간(UTC)입니다. 시간은 정시에 시작해야 합니다. 필수 필드입니다.

AutomatedBackupMode

자동 백업 모드입니다.

열거형
AUTOMATED_BACKUP_MODE_UNSPECIFIED 기본값 자동 백업 구성이 지정되지 않았습니다.
DISABLED 자동 백업 구성이 사용 중지되었습니다.
ENABLED 자동 백업 구성이 사용 설정되었습니다.

메서드

backup

Redis 클러스터를 백업합니다.

create

지정된 속성을 기반으로 Redis 클러스터를 만듭니다.

delete

특정 Redis 클러스터를 삭제합니다.

get

특정 Redis 클러스터의 세부정보를 가져옵니다.

getCertificateAuthority

Redis 클러스터의 인증 기관 정보 세부정보를 가져옵니다.

list

지정된 위치 (리전) 또는 모든 위치에 있는 프로젝트 소유의 모든 Redis 클러스터를 나열합니다.

patch

특정 Redis 클러스터의 메타데이터와 구성을 업데이트합니다.

rescheduleClusterMaintenance

예정된 유지보수 이벤트의 일정을 변경합니다.