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)
    }
  ],
  "replicaCount": integer,
  "deletionProtectionEnabled": boolean
}
필드
name

string

식별자. 인스턴스의 고유한 이름입니다. 형식: projects/{project}/locations/{location}/instances/{instance}
createTime

string (Timestamp format)

출력 전용입니다. 인스턴스의 생성 타임스탬프입니다.

RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 "2014-10-02T15:01:23Z" 및 "2014-10-02T15:01:23.045123456Z"입니다.
updateTime

string (Timestamp format)

출력 전용입니다. 인스턴스의 최신 업데이트 타임스탬프입니다.

RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 "2014-10-02T15:01:23Z" 및 "2014-10-02T15:01:23.045123456Z"입니다.
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[]

object (DiscoveryEndpoint)

출력 전용입니다. 클라이언트가 인스턴스에 연결할 수 있는 엔드포인트입니다. 현재 탐색 엔드포인트는 하나만 지원됩니다.
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[]

object (PscAutoConnection)

필수. 변경할 수 없습니다. 자동 생성된 PSC 연결의 사용자 입력 및 리소스 세부정보입니다.
replicaCount

integer

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

boolean

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

상태

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

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

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

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

JSON 표현 
{
  "targetShardCount": integer,
  "targetReplicaCount": integer
}
필드
targetShardCount

integer

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

integer

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

AuthorizationMode

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

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

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_id} 형식으로 예약되는 네트워크입니다.

NodeType

인스턴스의 가능한 노드 유형입니다. 자세한 내용은 https://cloud.google.com/memorystore/docs/valkey/instance-node-specification을 참조하세요.

열거형
NODE_TYPE_UNSPECIFIED 설정되지 않았습니다.
SHARED_CORE_NANO 공유 코어 나노입니다.
HIGHMEM_MEDIUM 중형의 고성능 메모리입니다.
HIGHMEM_XLARGE 초대형의 고성능 메모리입니다.
STANDARD_SMALL 표준 소형입니다.

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)

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

RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 "2014-10-02T15:01:23Z" 및 "2014-10-02T15:01:23.045123456Z"입니다.

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,
  "mode": enum (ZoneDistributionMode)
}
필드
zone

string

선택사항. 모든 리소스가 SINGLE_ZONE 모드로 할당되는 영역을 정의합니다. MULTI_ZONE 모드에서는 무시됩니다.
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
}
필드
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_id} 형식입니다.

메서드

create

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

delete

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

get

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

getCertificateAuthority

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

list

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

patch

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