REST 리소스: projects.locations.instances

리소스: 인스턴스

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
}
필드
name

string

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

참고: Memcached 인스턴스는 리전 수준에서 관리되고 다루어지므로 여기에서 locationId는 GCP 리전을 나타냅니다. 하지만 사용자는 인스턴스 내의 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)

출력 전용. 인스턴스가 만들어진 시간입니다.

RFC3339 UTC 'Zulu' 형식의 타임스탬프로 정밀도는 나노초 수준입니다. 예를 들면 "2014-10-02T15:01:23.045123456Z"입니다.
updateTime

string (Timestamp format)

출력 전용. 인스턴스가 업데이트된 시간입니다.

RFC3339 UTC 'Zulu' 형식의 타임스탬프로 정밀도는 나노초 수준입니다. 예를 들면 "2014-10-02T15:01:23.045123456Z"입니다.
state

enum (State)

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

string

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

object (InstanceMessage)

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

string

출력 전용. Discovery API용 엔드포인트

NodeConfig

Memcached 노드의 구성입니다.

JSON 표현 

{
  "cpuCount": integer,
  "memorySizeMb": integer
}
필드
cpuCount

integer

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

integer

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

MemcacheVersion

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

열거형
MEMCACHE_VERSION_UNSPECIFIED
MEMCACHE_1_5 Memcached 1.5 버전.

MemcacheParameters

JSON 표현 

{
  "id": string,
  "params": {
    string: string,
    ...
  }
}
필드
id

string

출력 전용. 이 매개변수 집합과 연결된 고유 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)
  }
}
필드
nodeId

string

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

string

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

enum (State)

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

string

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

integer

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

object (MemcacheParameters)

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

상태

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

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

상태

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

열거형
STATE_UNSPECIFIED 상태가 설정되지 않았습니다.
CREATING Memcached 인스턴스를 만드는 중입니다.
READY Memcached 인스턴스가 생성되었으며 사용할 수 있습니다.
DELETING Memcached 인스턴스를 삭제하는 중입니다.
PERFORMING_MAINTENANCE Memcached 인스턴스가 유지보수를 수행합니다(예: 데이터 영역 출시).

InstanceMessage

JSON 표현 

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

enum (Code)

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

string

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

코드

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

메서드

applyParameters

 ApplyParameters는 현재 Parameters 집합을 Memcached 인스턴스의 지정된 노드 집합으로 업데이트합니다.

create

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

delete

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

get

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

getIamPolicy

 리소스의 액세스 제어 정책을 가져옵니다.

list

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

patch

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

setIamPolicy

 지정된 리소스의 액세스 제어 정책을 설정합니다.

testIamPermissions

 지정된 리소스에 대해 호출자가 보유한 권한을 반환합니다.

updateParameters

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