REST Resource: projects.locations.instances

리소스: 인스턴스

Memorystore for Memcached 인스턴스

JSON 표현 
{
  "name": string,
  "displayName": string,
  "labels": {
    string: string,
    ...
  },
  "authorizedNetwork": string,
  "zones": [
    string
  ],
  "nodeCount": integer,
  "nodeConfig": {
    object (NodeConfig)
  },
  "memcacheVersion": enum (MemcacheVersion),
  "parameters": {
    object (MemcacheParameters)
  },
  "memcacheNodes": [
    {
      object (Node)
    }
  ],
  "createTime": string,
  "updateTime": string,
  "state": enum (State),
  "memcacheFullVersion": string,
  "instanceMessages": [
    {
      object (InstanceMessage)
    }
  ],
  "discoveryEndpoint": string,
  "updateAvailable": boolean,
  "maintenancePolicy": {
    object (MaintenancePolicy)
  },
  "maintenanceSchedule": {
    object (MaintenanceSchedule)
  },
  "reservedIpRangeId": [
    string
  ],
  "satisfiesPzs": boolean,
  "satisfiesPzi": boolean
}
필드
name

string

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

참고: Memcached 인스턴스는 리전 수준에서 관리되고 다루어지므로 여기에서 locationId는 Google Cloud 리전을 나타냅니다. 하지만 사용자는 인스턴스 내의 Memcached 노드를 프로비저닝할 영역을 선택할 수 있습니다. 자세한 내용은 zones 필드를 참조하세요.
displayName

string

사용자가 제공한 인스턴스 이름으로, 표시 목적으로만 사용됩니다. 80자(영문 기준) 이하로 입력해야 합니다.
labels

map (key: string, value: string)

사용자가 제공한 메타데이터를 나타내는 리소스 라벨입니다. 자세한 내용은 라벨에 대한 Cloud 문서를 참조하세요. https://cloud.google.com/compute/docs/labeling-resources

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

string

인스턴스가 연결된 Google Compute Engine 네트워크의 전체 이름입니다. 지정되지 않은 상태로 둘 경우 default 네트워크가 사용됩니다.
zones[]

string

Memcached 노드를 프로비저닝해야 하는 영역입니다. Memcached 노드는 이러한 영역 간에 균등하게 분산됩니다. 제공되지 않으면 서비스는 기본적으로 인스턴스의 리전 내 모든 영역에 노드를 만듭니다.
nodeCount

integer

필수. Memcached 인스턴스의 노드 수입니다.
nodeConfig

object (NodeConfig)

필수. Memcached 노드의 구성입니다.
memcacheVersion

enum (MemcacheVersion)

Memcached 소프트웨어의 주 버전입니다. 제공되지 않는 경우 최신 지원 버전이 사용됩니다. 현재 지원되는 최신 주 버전은 MEMCACHE_1_5입니다. 부 버전은 지원되는 최신 부 버전에 따라 시스템에 의해 자동으로 결정됩니다.
parameters

object (MemcacheParameters)

각 노드의 Memcached 프로세스에 적용할 사용자 정의 매개변수입니다.
memcacheNodes[]

object (Node)

출력 전용입니다. Memcached 노드 목록입니다. 자세한 내용은 Node 메시지를 참조하세요.
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"입니다.
state

enum (State)

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

string

출력 전용. 이 인스턴스에서 실행 중인 Memcached 서버의 정식 버전입니다. 시스템은 입력된 MemcacheVersion을 기반으로 인스턴스의 전체 Memcached 버전을 자동으로 결정합니다. 정식 버전 형식은 'memcached-1.5.16'입니다.
instanceMessages[]

object (InstanceMessage)

Memcached 인스턴스의 현재 상태를 설명하는 메시지 목록입니다.
discoveryEndpoint

string

출력 전용입니다. Discovery API의 엔드포인트입니다.
updateAvailable

boolean

출력 전용입니다. 적용 대기 중인 업데이트가 있으면 true를 반환합니다.
maintenancePolicy

object (MaintenancePolicy)

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

object (MaintenanceSchedule)

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

string

선택사항입니다. 비공개 서비스 액세스 연결과 연결된 할당된 IP 주소 범위의 ID가 포함됩니다(예: IP 범위 10.0.0.0/29와 연결된 'test-default').
satisfiesPzs

boolean

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

boolean

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

NodeConfig

Memcached 노드의 구성입니다.

JSON 표현 
{
  "cpuCount": integer,
  "memorySizeMb": integer
}
필드
cpuCount

integer

필수. Memcached 노드 당 CPU 수입니다.
memorySizeMb

integer

필수. 각 Memcached 노드의 메모리 크기(MiB)입니다.

MemcacheVersion

서비스에서 지원하는 Memcached 버전입니다.

열거형
MEMCACHE_VERSION_UNSPECIFIED 고객이 Memcache 버전을 지정하지 않음
MEMCACHE_1_5 Memcached 1.5 버전.
MEMCACHE_1_6_15 Memcached 1.6.15 버전.

MemcacheParameters

JSON 표현 
{
  "id": string,
  "params": {
    string: string,
    ...
  }
}
필드
id

string

출력 전용. 이 매개변수 집합과 연결된 고유 ID입니다. 사용자는 이 ID를 사용하여 인스턴스와 연결된 매개변수가 노드와 연결된 매개변수와 다른지 확인합니다. 매개변수 ID 간의 불일치는 사용자에게 노드에 매개변수를 적용하려면 조치를 취해야 할 수도 있음을 알려줄 수 있습니다.
params

map (key: string, value: string)

Memcached 프로세스에 사용할 사용자 정의 매개변수 집합입니다.

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

노드

JSON 표현 
{
  "nodeId": string,
  "zone": string,
  "state": enum (State),
  "host": string,
  "port": integer,
  "parameters": {
    object (MemcacheParameters)
  },
  "updateAvailable": boolean,
  "memcacheVersion": enum (MemcacheVersion),
  "memcacheFullVersion": string
}
필드
nodeId

string

출력 전용. Memcached 노드의 식별자입니다. 노드 ID에는 Memcached 인스턴스 이름과 같은 프로젝트 또는 위치가 포함되지 않습니다.
zone

string

출력 전용. Memcached 노드의 위치(GCP 영역)입니다.
state

enum (State)

출력 전용. Memcached 노드의 현재 상태입니다.
host

string

출력 전용. 클라이언트가 이 노드의 Memcached 서버에 연결하는 데 사용하는 Memcached 노드의 호스트 이름 또는 IP 주소입니다.
port

integer

출력 전용. 이 노드에 있는 Memcached 서버의 포트 번호입니다.
parameters

object (MemcacheParameters)

사용자 정의 매개변수가 현재 노드에 적용됩니다.
updateAvailable

boolean

출력 전용입니다. 적용 대기 중인 업데이트가 있으면 true를 반환합니다.
memcacheVersion

enum (MemcacheVersion)

출력 전용입니다. 이 노드에서 실행 중인 Memcached 서버의 주 버전입니다(예: MEMCACHE_1_5).
memcacheFullVersion

string

출력 전용입니다. 이 노드에서 실행 중인 Memcached 서버의 전체 버전입니다(예: memcached-1.5.16).

주

Memcached 노드의 여러 상태입니다.

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

주

Memcached 인스턴스의 여러 상태입니다.

열거형
STATE_UNSPECIFIED 상태가 설정되지 않았습니다.
CREATING Memcached 인스턴스를 만드는 중입니다.
READY Memcached 인스턴스가 생성되었으며 사용할 수 있습니다.
UPDATING Memcached 인스턴스가 유지보수 정책 및 일정과 같은 구성을 업데이트하고 있습니다.
DELETING Memcached 인스턴스를 삭제하는 중입니다.
PERFORMING_MAINTENANCE Memcached 인스턴스가 유지보수를 수행합니다(예: 데이터 영역 출시).
MEMCACHE_VERSION_UPGRADING Memcached 인스턴스가 Memcached 엔진 버전으로 업그레이드하는 중입니다.

InstanceMessage

JSON 표현 
{
  "code": enum (Code),
  "message": string
}
필드
code

enum (Code)

사용자에게 표시되는 메시지의 한 유형에 해당하는 코드입니다.
message

string

사용자에게 노출될 Memcached 인스턴스의 메시지입니다.

코드

열거형
CODE_UNSPECIFIED 메시지 코드가 설정되지 않았습니다.
ZONE_DISTRIBUTION_UNBALANCED Memcached 노드는 균일하지 않게 분산됩니다.

MaintenancePolicy

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

JSON 표현 
{
  "createTime": string,
  "updateTime": string,
  "description": 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"입니다.
description

string

이 정책의 용도에 대한 설명입니다. 길이가 512자를 초과하면 Create/Update 메서드가 INVALID_ARGUMENT를 반환합니다.
weeklyMaintenanceWindow[]

object (WeeklyMaintenanceWindow)

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

WeeklyMaintenanceWindow

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

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

enum (DayOfWeek)

필수. 지정된 요일에 실행되는 일정을 정의할 수 있습니다.
startTime

object (TimeOfDay)

필수. 기간의 시작 시간(UTC)
duration

string (Duration format)

필수. 기간의 길이입니다.

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

MaintenanceSchedule

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

JSON 표현 
{
  "startTime": string,
  "endTime": string,
  "scheduleDeadlineTime": 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"입니다.
scheduleDeadlineTime

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

메서드

applyParameters

 ApplyParameters는 지정된 노드 집합을 다시 시작하여 Memcached 인스턴스의 현재 매개변수 집합으로 업데이트합니다.

applySoftwareUpdate

 인스턴스의 선택된 노드에서 소프트웨어를 업데이트합니다.

create

 특정 위치에 새 인스턴스를 만듭니다.

delete

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

get

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

list

 지정된 위치의 인스턴스를 나열합니다.

patch

 특정 프로젝트 및 위치의 기존 인스턴스를 업데이트합니다.

rescheduleMaintenance

 RescheduleMaintenance 동사의 적용 단계를 수행합니다.

updateParameters

 기존 인스턴스에 정의된 Memcached 매개변수를 업데이트합니다.

upgrade

 Memcache 인스턴스를 요청에 지정된 최신 Memcached 엔진 버전으로 업그레이드합니다.