REST Resource: projects.locations.instances

리소스: 인스턴스

Memorystore 인스턴스

JSON 표현 
{
  "name": string,
  "createTime": string,
  "updateTime": string,
  "labels": {
    string: string,
    ...
  },
  "state": enum (State),
  "stateInfo": {
    object (StateInfo)
  },
  "uid": string,
  "authorizationMode": enum (AuthorizationMode),
  "transitEncryptionMode": enum (TransitEncryptionMode),
  "shardCount": integer,
  "discoveryEndpoints": [
    {
      object (DiscoveryEndpoint)
    }
  ],
  "nodeType": enum (NodeType),
  "persistenceConfig": {
    object (PersistenceConfig)
  },
  "engineVersion": string,
  "engineConfigs": {
    string: string,
    ...
  },
  "nodeConfig": {
    object (NodeConfig)
  },
  "zoneDistributionConfig": {
    object (ZoneDistributionConfig)
  },
  "pscAutoConnections": [
    {
      object (PscAutoConnection)
    }
  ],
  "pscAttachmentDetails": [
    {
      object (PscAttachmentDetail)
    }
  ],
  "endpoints": [
    {
      object (InstanceEndpoint)
    }
  ],
  "mode": enum (Mode),
  "maintenancePolicy": {
    object (MaintenancePolicy)
  },
  "maintenanceSchedule": {
    object (MaintenanceSchedule)
  },
  "crossInstanceReplicationConfig": {
    object (CrossInstanceReplicationConfig)
  },
  "encryptionInfo": {
    object (EncryptionInfo)
  },
  "automatedBackupConfig": {
    object (AutomatedBackupConfig)
  },
  "availableMaintenanceVersions": [
    string
  ],
  "allowFewerZonesDeployment": boolean,
  "migrationConfig": {
    object (MigrationConfig)
  },
  "aclPolicyInfo": {
    object (AclPolicyInfo)
  },

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "gcsSource": {
    object (GcsBackupSource)
  },
  "managedBackupSource": {
    object (ManagedBackupSource)
  }
  // End of mutually exclusive fields.
  "replicaCount": integer,
  "deletionProtectionEnabled": boolean,
  "simulateMaintenanceEvent": boolean,
  "ondemandMaintenance": boolean,
  "satisfiesPzs": boolean,
  "satisfiesPzi": boolean,
  "asyncInstanceEndpointsDeletionEnabled": boolean,
  "kmsKey": string,
  "backupCollection": string,
  "maintenanceVersion": string,
  "effectiveMaintenanceVersion": string,
  "serverCaMode": enum (ServerCaMode),
  "serverCaPool": string,
  "rotateServerCertificate": boolean,
  "aclPolicy": string,
  "aclPolicyInSync": boolean
}
필드
name

string

식별자. 인스턴스의 고유한 이름입니다. 형식: projects/{project}/locations/{location}/instances/{instance}
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"입니다.
labels

map (key: string, value: string)

선택사항입니다. 사용자가 제공한 메타데이터를 나타내는 라벨입니다.

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

enum (State)

출력 전용입니다. 인스턴스의 현재 상태입니다.
stateInfo

object (StateInfo)

출력 전용입니다. 인스턴스 상태에 대한 추가 정보입니다.
uid

string

출력 전용입니다. 인스턴스에 대해 시스템에서 할당된 고유 식별자입니다.
authorizationMode

enum (AuthorizationMode)

(선택사항) 인스턴스의 승인 모드입니다.
transitEncryptionMode

enum (TransitEncryptionMode)

선택사항. 변경할 수 없습니다. 인스턴스의 전송 중인 데이터 암호화 모드입니다.
shardCount

integer

(선택사항) 인스턴스의 샤드 수입니다.
discoveryEndpoints[]
(deprecated)

object (DiscoveryEndpoint)

출력 전용입니다. 지원 중단됨: discoveryEndpoints 매개변수가 지원 중단되었습니다. 따라서 엔드포인트 매개변수를 사용하여 연결을 생성하면 채워지지 않습니다. 이 매개변수 대신 검색의 경우 connectionType이 CONNECTION_TYPE_DISCOVERY인 endpoints.connections.pscConnection 및 endpoints.connections.pscAutoConnection을 사용하세요.
nodeType

enum (NodeType)

(선택사항) 인스턴스의 개별 노드에 대한 머신 유형입니다.
persistenceConfig

object (PersistenceConfig)

선택사항. 인스턴스의 지속성 구성입니다.
engineVersion

string

(선택사항) 인스턴스의 엔진 버전입니다.
engineConfigs

map (key: string, value: string)

선택사항. 인스턴스의 사용자 제공 엔진 구성입니다.

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

object (NodeConfig)

출력 전용입니다. 인스턴스의 개별 노드 구성입니다.
zoneDistributionConfig

object (ZoneDistributionConfig)

선택사항. 변경할 수 없습니다. 노드 할당을 위한 인스턴스의 영역 배포 구성입니다.
pscAutoConnections[]
(deprecated)

object (PscAutoConnection)

(선택사항) 변경할 수 없습니다. 지원 중단됨: 대신 endpoints.connections.psc_auto_connection 값을 사용하세요.
pscAttachmentDetails[]

object (PscAttachmentDetail)

출력 전용입니다. PSC 연결을 구성하기 위한 서비스 연결 세부정보입니다.
endpoints[]

object (InstanceEndpoint)

(선택사항) 인스턴스의 엔드포인트입니다.
mode

enum (Mode)

(선택사항) 변경할 수 없습니다. 인스턴스의 모드 구성입니다.
maintenancePolicy

object (MaintenancePolicy)

(선택사항) 인스턴스의 유지보수 정책입니다. 제공되지 않으면 Memorystore 내부 출시 일정에 따라 유지보수 이벤트가 실행됩니다.
maintenanceSchedule

object (MaintenanceSchedule)

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

object (CrossInstanceReplicationConfig)

(선택사항) 인스턴스 간 복제 구성입니다.
encryptionInfo

object (EncryptionInfo)

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

object (AutomatedBackupConfig)

(선택사항) 인스턴스의 자동 백업 구성입니다.
availableMaintenanceVersions[]

string

출력 전용입니다. 이 필드는 셀프 서비스 업데이트에 사용할 수 있는 유지보수 버전을 확인하는 데 사용됩니다.
allowFewerZonesDeployment
(deprecated)

boolean

(선택사항) 변경할 수 없습니다. 지원 중단되었으므로 사용하지 마세요.
migrationConfig

object (MigrationConfig)

출력 전용입니다. 인스턴스의 마이그레이션 구성입니다.
aclPolicyInfo

object (AclPolicyInfo)

출력 전용입니다. 적용된 ACL 정책의 세부정보입니다.
가져올 소스입니다. 다음은 상호 배타적인 필드의 목록입니다. 응답에는 다음 필드 중 최대 하나가 설정됩니다.
gcsSource

object (GcsBackupSource)

(선택사항) 변경할 수 없습니다. Cloud Storage 버킷에 저장된 백업입니다. Cloud Storage 버킷은 인스턴스와 동일한 리전에 있어야 합니다. 제공된 Cloud Storage 객체에서 가져오려면 읽기 권한이 필요합니다.
managedBackupSource

object (ManagedBackupSource)

(선택사항) 변경할 수 없습니다. Memorystore 서비스에서 생성하고 관리하는 백업입니다.
상호 배타적 필드의 끝입니다.
replicaCount

integer

(선택사항) 샤드당 복제본 노드 수입니다. 생략한 경우 기본값은 복제본 0개입니다.
deletionProtectionEnabled

boolean

선택사항. true로 설정하면 인스턴스 삭제가 실패합니다.
simulateMaintenanceEvent

boolean

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

boolean

(선택사항) 입력 전용입니다. 인스턴스의 온디맨드 유지보수입니다.
satisfiesPzs

boolean

(선택사항) 출력 전용입니다. 나중에 사용하기 위해 예약되어 있습니다.
satisfiesPzi

boolean

(선택사항) 출력 전용입니다. 나중에 사용하기 위해 예약되어 있습니다.
asyncInstanceEndpointsDeletionEnabled

boolean

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

string

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

string

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

string

(선택사항) 이 필드를 사용하여 원하는 유지보수 버전을 나타내는 셀프 서비스 업데이트를 트리거할 수 있습니다. 이 필드의 입력은 availableMaintenanceVersions 필드로 확인할 수 있습니다.
effectiveMaintenanceVersion

string

출력 전용입니다. 이 필드는 인스턴스의 실제 유지보수 버전을 나타냅니다.
serverCaMode

enum (ServerCaMode)

(선택사항) 변경할 수 없습니다. 인스턴스의 서버 CA 모드입니다.
serverCaPool

string

(선택사항) 변경할 수 없습니다. 인스턴스의 고객 관리 CA 풀입니다. 서버 CA 모드가 CUSTOMER_MANAGED_CAS_CA인 경우에만 적용됩니다. 형식: 'projects/{project}/locations/{region}/caPools/{ca_pool}'
rotateServerCertificate

boolean

(선택사항) 입력 전용입니다. 서버 인증서를 순환합니다.
aclPolicy

string

(선택사항) 인스턴스의 ACL 정책입니다. 형식: projects/{project}/locations/{location}/aclPolicies/{aclPolicy}
aclPolicyInSync
(deprecated)

boolean

출력 전용입니다. 지원 중단됨: 인스턴스에 적용된 ACL 규칙이 동기화되었는지 여부입니다.

GcsBackupSource

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

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

string

(선택사항) 예: gs://bucket1/object1, gs://bucket2/folder2/object2

ManagedBackupSource

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

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

string

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

주

인스턴스의 가능한 상태입니다.

열거형
STATE_UNSPECIFIED 설정되지 않았습니다.
CREATING 인스턴스를 만드는 중입니다.
ACTIVE 인스턴스가 생성되었으며 사용할 수 있습니다.
UPDATING 인스턴스를 업데이트하는 중입니다.
DELETING 인스턴스를 삭제하는 중입니다.
MIGRATING 인스턴스를 마이그레이션하는 중입니다.

StateInfo

인스턴스 상태에 대한 추가 정보입니다.

JSON 표현 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "updateInfo": {
    object (UpdateInfo)
  }
  // End of mutually exclusive fields.
}
필드
다음은 상호 배타적인 필드의 목록입니다. 응답에는 다음 필드 중 최대 하나가 설정됩니다.
updateInfo

object (UpdateInfo)

출력 전용입니다. 인스턴스 상태가 UPDATING일 때 진행 중인 업데이트를 설명합니다.
상호 배타적 필드의 끝입니다.

UpdateInfo

상태가 UPDATING인 인스턴스에 관한 정보를 나타냅니다.

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

integer

출력 전용입니다. 인스턴스의 대상 샤드 수입니다.
targetReplicaCount

integer

출력 전용입니다. 인스턴스의 샤드당 대상 복제본 노드 수입니다.
targetEngineVersion

string

출력 전용입니다. 인스턴스의 타겟 엔진 버전입니다.
targetNodeType

enum (NodeType)

출력 전용입니다. 인스턴스의 타겟 노드 유형입니다.

AuthorizationMode

인스턴스의 가능한 승인 모드입니다.

열거형
AUTHORIZATION_MODE_UNSPECIFIED 설정되지 않았습니다.
AUTH_DISABLED 승인이 사용 중지됩니다.
IAM_AUTH IAM 기본 승인입니다.
TOKEN_AUTH 토큰 기반 승인입니다.

TransitEncryptionMode

인스턴스의 가능한 전송 중인 데이터 암호화 모드입니다.

열거형
TRANSIT_ENCRYPTION_MODE_UNSPECIFIED 설정되지 않았습니다.
TRANSIT_ENCRYPTION_DISABLED 전송 중인 데이터 암호화가 사용 중지됩니다.
SERVER_AUTHENTICATION 서버 관리형 암호화는 전송 중인 데이터 암호화에 사용됩니다.

DiscoveryEndpoint

클라이언트가 인스턴스에 연결할 엔드포인트를 나타냅니다.

JSON 표현 
{
  "address": string,
  "port": integer,
  "network": string
}
필드
address

string

출력 전용입니다. 노출된 엔드포인트 클라이언트가 연결되는 IP 주소입니다.
port

integer

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

string

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

PersistenceConfig

인스턴스의 지속성 구성을 나타냅니다.

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 설정되지 않았습니다. 기본값: EVERY_SEC
NEVER fsync를 사용하지 않습니다. 일반적으로 Linux는 이 구성으로 30초마다 데이터를 플러시하지만 커널의 정확한 조정에 따라 다릅니다.
EVERY_SEC 매초 Fsync를 실행합니다. 재해가 발생하면 1초의 데이터가 손실될 수 있습니다.
ALWAYS 새 쓰기 명령어가 AOF에 추가될 때마다 Fsync를 실행합니다. 성능 저하가 발생하지만 최고의 데이터 손실 방지 기능입니다.

NodeConfig

인스턴스의 노드에 대한 구성을 나타냅니다.

JSON 표현 
{
  "sizeGb": number
}
필드
sizeGb

number

출력 전용입니다. 노드의 메모리 크기(GB)입니다.

ZoneDistributionConfig

인스턴스 리소스 할당을 위한 영역 배포 구성입니다.

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

string

선택사항. 모든 리소스가 SINGLE_ZONE 모드로 할당되는 영역을 정의합니다. MULTI_ZONE 모드에서는 무시됩니다.
zones[]

string

(선택사항) Memorystore 인스턴스가 리소스를 할당하는 멀티 영역 인스턴스의 영역을 지정합니다. 이 플래그는 단일 영역 인스턴스에는 적용되지 않습니다.
mode

enum (ZoneDistributionMode)

(선택사항) 현재 영역 배포 모드입니다. 기본값은 MULTI_ZONE입니다.

ZoneDistributionMode

가능한 영역 배포 모드입니다.

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

PscAutoConnection

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

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

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "port": integer
  // End of mutually exclusive fields.
}
필드
pscConnectionId

string

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

string

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

string

출력 전용입니다. 소비자 측 전달 규칙의 URI입니다. 형식: projects/{project}/regions/{region}/forwardingRules/{forwardingRule}
projectId

string

필수 항목입니다. PSC 연결이 설정된 소비자 프로젝트 ID입니다. 인스턴스가 생성되는 projectId와 동일해야 합니다.
network

string

필수 항목입니다. PSC 엔드포인트가 생성되는 네트워크입니다. projects/{projectId}/global/networks/{network_name} 형식입니다.
serviceAttachment

string

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

enum (PscConnectionStatus)

출력 전용입니다. PSC 연결 상태: 연결이 존재하고 활성 상태인지 아니면 더 이상 존재하지 않는지 여부입니다. 이 값은 주기적으로 업데이트됩니다. 최신 상태는 Private Service Connect API를 사용하세요.
connectionType

enum (ConnectionType)

출력 전용입니다. PSC 연결 유형입니다.
노출된 엔드포인트의 포트입니다. 다음은 상호 배타적인 필드의 목록입니다. 응답에는 다음 필드 중 최대 하나가 설정됩니다.
port

integer

선택사항입니다. 포트는 기본/리더 또는 검색 엔드포인트에만 설정됩니다.
상호 배타적 필드의 끝입니다.

PscConnectionStatus

PSC 연결 상태입니다.

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

ConnectionType

PSC 연결 유형

열거형
CONNECTION_TYPE_UNSPECIFIED 연결 유형이 설정되지 않음
CONNECTION_TYPE_DISCOVERY 토폴로지 검색에 사용될 연결입니다.
CONNECTION_TYPE_PRIMARY 기본 노드에 액세스하는 데 기본 엔드포인트로 사용될 연결입니다.
CONNECTION_TYPE_READER 복제본에 액세스하는 데 읽기 엔드포인트로 사용될 연결입니다.

PscAttachmentDetail

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

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

string

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

enum (ConnectionType)

출력 전용입니다. PSC 엔드포인트의 유형입니다.

InstanceEndpoint

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

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

object (ConnectionDetail)

(선택사항) PSC 연결 그룹입니다. 클러스터의 각 서비스 연결에 대해 하나씩 동일한 VPC 네트워크에 생성됩니다.

ConnectionDetail

각 PSC 연결의 정보입니다.

JSON 표현 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "pscAutoConnection": {
    object (PscAutoConnection)
  },
  "pscConnection": {
    object (PscConnection)
  }
  // End of mutually exclusive fields.
}
필드
인스턴스에 대한 PSC 연결은 클러스터 생성 중에 서비스 연결 자동화 (자동 연결)를 통해 생성되거나 고객이 직접 생성할 수 있습니다 (사용자 생성 연결). 다음은 상호 배타적인 필드의 목록입니다. 응답에는 다음 필드 중 최대 하나가 설정됩니다.
pscAutoConnection

object (PscAutoConnection)

변경할 수 없습니다. 서비스 연결 자동화를 통해 생성된 PSC 연결의 세부정보입니다.
pscConnection

object (PscConnection)

사용자가 만든 PSC 연결의 세부정보입니다.
상호 배타적 필드의 끝입니다.

PscConnection

사용자가 만든 PSC 연결 구성입니다.

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

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "port": integer
  // End of mutually exclusive fields.
}
필드
pscConnectionId

string

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

string

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

string

필수 항목입니다. 소비자 측 전달 규칙의 URI입니다. 형식: projects/{project}/regions/{region}/forwardingRules/{forwardingRule}
projectId

string

출력 전용입니다. 전달 규칙이 생성된 소비자 프로젝트 ID입니다.
network

string

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

string

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

enum (PscConnectionStatus)

출력 전용입니다. PSC 연결 상태: 연결이 존재하고 활성 상태인지 아니면 더 이상 존재하지 않는지 여부입니다. 이 값은 주기적으로 업데이트됩니다. 최신 상태는 Private Service Connect API를 사용하세요.
connectionType

enum (ConnectionType)

출력 전용입니다. PSC 연결 유형입니다.
노출된 엔드포인트의 포트입니다. 다음은 상호 배타적인 필드의 목록입니다. 응답에는 다음 필드 중 최대 하나가 설정됩니다.
port

integer

선택사항입니다. 포트는 기본/리더 또는 검색 엔드포인트에만 설정됩니다.
상호 배타적 필드의 끝입니다.

모드

클러스터 모드를 사용 설정/중지하는 데 사용되는 모드 구성입니다.

열거형
MODE_UNSPECIFIED 모드가 지정되지 않았습니다.
STANDALONE

지원 중단됨: 대신 CLUSTER_DISABLED를 사용하세요.
CLUSTER 인스턴스가 클러스터 모드입니다.
CLUSTER_DISABLED 인스턴스에 클러스터 모드가 사용 중지되어 있습니다.

MaintenancePolicy

인스턴스당 유지보수 정책입니다.

JSON 표현 
{
  "createTime": string,
  "updateTime": string,
  "weeklyMaintenanceWindow": [
    {
      object (WeeklyMaintenanceWindow)
    }
  ]
}
필드
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 (WeeklyMaintenanceWindow)

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

WeeklyMaintenanceWindow

주간 작업에 지정된 시간 범위입니다.

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

enum (DayOfWeek)

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

object (TimeOfDay)

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

MaintenanceSchedule

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

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"입니다.

CrossInstanceReplicationConfig

인스턴스 간 복제 구성입니다.

JSON 표현 
{
  "instanceRole": enum (InstanceRole),
  "primaryInstance": {
    object (RemoteInstance)
  },
  "secondaryInstances": [
    {
      object (RemoteInstance)
    }
  ],
  "updateTime": string,
  "membership": {
    object (Membership)
  }
}
필드
instanceRole

enum (InstanceRole)

필수 항목입니다. 인스턴스의 인스턴스 간 복제 역할입니다.
primaryInstance

object (RemoteInstance)

(선택사항) 이 보조 인스턴스의 복제 소스로 사용되는 기본 인스턴스의 세부정보입니다.

이 필드는 보조 인스턴스에만 설정됩니다.
secondaryInstances[]

object (RemoteInstance)

(선택사항) 이 기본 인스턴스에서 복제하는 보조 인스턴스의 목록입니다.

이 필드는 기본 인스턴스에만 설정됩니다.
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)

출력 전용입니다. 인스턴스 간 복제에 참여하는 모든 구성원 인스턴스의 출력 전용 뷰입니다. 이 뷰는 인스턴스 역할(기본 또는 보조)과 관계없이 모든 구성원 인스턴스에서 제공됩니다.

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

InstanceRole

인스턴스의 인스턴스 간 복제 역할입니다.

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

RemoteInstance

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

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

string

(선택사항) 원격 인스턴스의 전체 리소스 경로입니다(projects//locations//instances/ 형식).
uid

string

출력 전용입니다. 원격 인스턴스의 고유 식별자입니다.

멤버십

인스턴스 간 복제에 참여하는 모든 구성원 인스턴스의 출력 전용 뷰입니다.

JSON 표현 
{
  "primaryInstance": {
    object (RemoteInstance)
  },
  "secondaryInstances": [
    {
      object (RemoteInstance)
    }
  ]
}
필드
primaryInstance

object (RemoteInstance)

출력 전용입니다. 보조 인스턴스의 복제 소스 역할을 하는 기본 인스턴스입니다.
secondaryInstances[]

object (RemoteInstance)

출력 전용입니다. 기본 인스턴스에서 복제하는 보조 인스턴스의 목록입니다.

AutomatedBackupConfig

인스턴스의 자동 백업 구성입니다.

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

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "fixedFrequencySchedule": {
    object (FixedFrequencySchedule)
  }
  // End of mutually exclusive fields.
}
필드
automatedBackupMode

enum (AutomatedBackupMode)

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

string (Duration format)

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

소수점 아래가 최대 9자리까지이고 's'로 끝나는 초 단위 기간입니다. 예를 들면 "3.5s"입니다.
자동 백업 일정입니다. 다음은 상호 배타적인 필드의 목록입니다. 응답에는 다음 필드 중 최대 하나가 설정됩니다.
fixedFrequencySchedule

object (FixedFrequencySchedule)

(선택사항) 고정된 빈도로 자동 백업을 트리거합니다.
상호 배타적 필드의 끝입니다.

FixedFrequencySchedule

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

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

object (TimeOfDay)

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

AutomatedBackupMode

자동 백업 모드입니다.

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

ServerCaMode

인스턴스의 서버 CA 모드입니다.

열거형
SERVER_CA_MODE_UNSPECIFIED 서버 CA 모드가 지정되지 않았습니다.
GOOGLE_MANAGED_PER_INSTANCE_CA 각 인스턴스에는 자체 Google 관리 CA가 있습니다.
GOOGLE_MANAGED_SHARED_CA 인스턴스가 인스턴스 리전에 Google 관리 공유 CA를 사용합니다.
CUSTOMER_MANAGED_CAS_CA 인스턴스에서 CAS의 고객 관리 CA를 사용합니다.
SERVER_CA_MODE_GOOGLE_MANAGED_PER_INSTANCE_CA

지원 중단됨: 대신 GOOGLE_MANAGED_PER_INSTANCE_CA를 사용하세요.
SERVER_CA_MODE_GOOGLE_MANAGED_SHARED_CA

지원 중단됨: 대신 GOOGLE_MANAGED_SHARED_CA를 사용하세요.
SERVER_CA_MODE_CUSTOMER_MANAGED_CAS_CA

지원 중단됨: 대신 CUSTOMER_MANAGED_CAS_CA를 사용하세요.

MigrationConfig

인스턴스 마이그레이션 구성입니다.

JSON 표현 
{
  "state": enum (State),
  "forceFinishMigration": boolean,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "selfManagedSource": {
    object (SelfManagedSource)
  }
  // End of mutually exclusive fields.
}
필드
state

enum (State)

출력 전용입니다. 인스턴스의 이전 상태입니다.
forceFinishMigration

boolean

출력 전용입니다. 복제를 중지하기 전에 소스와 대상 간 오프셋 따라잡기 검증 없이 마이그레이션 완료를 강제하는 불리언 플래그를 나타냅니다.
이전 소스에 대한 세부정보입니다. 다음은 상호 배타적인 필드의 목록입니다. 응답에는 다음 필드 중 최대 하나가 설정됩니다.
selfManagedSource

object (SelfManagedSource)

출력 전용입니다. 자체 관리형 Valkey/Redis 인스턴스에서 마이그레이션하기 위한 구성
상호 배타적 필드의 끝입니다.

SelfManagedSource

자체 관리형 소스 인스턴스의 세부정보입니다.

JSON 표현 
{
  "ipAddress": string,
  "port": integer,
  "networkAttachment": string
}
필드
ipAddress

string

필수 항목입니다. 소스 인스턴스의 IP 주소입니다. 이 IP 주소는 이전 프로세스 전반에 걸쳐 Memorystore 인스턴스에서 액세스할 수 있는 안정적인 IP 주소여야 합니다.
port

integer

필수 항목입니다. 소스 인스턴스의 포트입니다. 이 포트는 마이그레이션 프로세스 전반에서 Memorystore 인스턴스가 액세스할 수 있는 안정적인 포트여야 합니다.
networkAttachment

string

필수 항목입니다. 소스 인스턴스에 연결하는 데 사용되는 Private Service Connect 네트워크 연결의 리소스 이름입니다. 이 네트워크 연결에는 다음과 같은 요구사항이 있습니다. 1. Memorystore 인스턴스와 동일한 프로젝트에 있어야 합니다. 2. Memorystore 인스턴스와 동일한 리전에 있어야 합니다. 3. 네트워크 연결에 연결된 서브넷은 소스 인스턴스 노드와 동일한 VPC 네트워크에 있어야 합니다.

형식: projects/{project}/regions/{region}/networkAttachments/{networkAttachment}

주

인스턴스의 이전 상태입니다. 향후 새 값이 추가될 수 있습니다.

열거형
STATE_UNSPECIFIED 인스턴스에 이전 관련 활동이 없습니다. 이것이 초기 상태입니다.
ROLLED_BACK 인스턴스가 현재 마이그레이션되지 않습니다. 인스턴스에서 실패한 마이그레이션을 시도했으며 후속 롤백은 성공했습니다. 이제 원하는 경우 인스턴스를 새 마이그레이션 시도에 사용할 수 있습니다.
ROLLING_BACK 이전 마이그레이션 시도가 실패했음을 나타냅니다. 전체 인스턴스 상태는 MIGRATING입니다. 인스턴스가 새 마이그레이션을 시도할 준비가 되지 않았습니다. 인스턴스를 원래 상태로 복원하기 위해 롤백이 진행 중입니다. 롤백이 완료될 때까지 인스턴스가 이 상태로 유지됩니다.
REPLICATION_ESTABLISHED 인스턴스가 이전되는 중입니다. 인스턴스가 성공적으로 복제를 설정했으며 컷오버할 준비가 되었습니다.
MIGRATED 인스턴스가 성공적으로 이전되었습니다.

AclPolicyInfo

적용된 ACL 정책의 세부정보입니다.

JSON 표현 
{
  "appliedAclPolicy": string,
  "appliedAclPolicyRevision": string,
  "appliedAclPolicyRevisionNumber": string,
  "aclPolicyRevisionStatuses": [
    {
      object (AclPolicyRevisionStatus)
    }
  ]
}
필드
appliedAclPolicy

string

출력 전용입니다. 적용된 ACL 정책의 리소스 이름입니다. 형식: 'projects/{project}/locations/{location}/aclPolicies/{aclPolicy}'
appliedAclPolicyRevision

string

출력 전용입니다. 적용된 ACL 정책 버전의 리소스 이름입니다. 형식: 'projects/{project}/locations/{location}/aclPolicies/{aclPolicy}/revisions/{revision}'
appliedAclPolicyRevisionNumber

string (int64 format)

출력 전용입니다. 적용된 ACL 정책 버전의 버전 번호입니다.
aclPolicyRevisionStatuses[]

object (AclPolicyRevisionStatus)

출력 전용입니다. 인스턴스에 있는 이 ACL 정책의 여러 버전의 상태 목록입니다.

메서드

addTokenAuthUser

 토큰 기반 인증이 사용 설정된 인스턴스의 토큰 인증 사용자를 추가합니다.

backup

 인스턴스 백업

create

 특정 프로젝트 및 위치에 새 인스턴스를 만듭니다.

delete

 단일 인스턴스를 삭제합니다.

finishMigration

 마이그레이션 프로세스를 완료합니다.

get

 단일 인스턴스의 세부정보를 가져옵니다.

getCertificateAuthority

 인스턴스의 인증 기관에 대한 세부정보를 가져옵니다.

list

 특정 프로젝트 및 위치의 인스턴스를 나열합니다.

patch

 단일 인스턴스의 매개변수를 업데이트합니다.

rescheduleMaintenance

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

startMigration

 소스 인스턴스를 대상 Memorystore 인스턴스로의 마이그레이션을 시작합니다.