MCP Tools Reference: memorystore.googleapis.com

도구: `list_instances`

모든 Memorystore for Valkey 인스턴스를 나열합니다.

다음 샘플은 curl를 사용하여 list_instances MCP 도구를 호출하는 방법을 보여줍니다.

curl 요청
curl --location 'https://memorystore.googleapis.com/mcp' \ --header 'content-type: application/json' \ --header 'accept: application/json, text/event-stream' \ --data '{ "method": "tools/call", "params": { "name": "list_instances", "arguments": { // provide these details according to the tool's MCP specification } }, "jsonrpc": "2.0", "id": 1 }'

curl 요청

                  
curl --location 'https://memorystore.googleapis.com/mcp' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
  "method": "tools/call",
  "params": {
    "name": "list_instances",
    "arguments": {
      // provide these details according to the tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

입력 스키마

ListInstances에 대한 요청 메시지입니다.

ListInstancesRequest

JSON 표현
{ "parent": string, "pageSize": integer, "pageToken": string, "filter": string, "orderBy": string }

필드
`parent`	`string` 필수 항목입니다. 인스턴스를 나열할 상위 요소입니다. 형식: projects/{project}/locations/{location}
`pageSize`	`integer` 선택사항입니다. 요청한 페이지 크기입니다. 서버에서 요청한 것보다 적은 항목을 반환할 수 있습니다. 지정하지 않으면 서버에서 적절한 기본값을 선택합니다.
`pageToken`	`string` 선택사항. 서버에서 반환할 결과 페이지를 식별하는 토큰입니다.
`filter`	`string` 선택사항. 결과 필터링 표현식입니다.
`orderBy`	`string` 선택사항. 정의된 순서대로 결과를 정렬합니다. 지원되는 값은 'name', 'create_time'입니다.

출력 스키마

ListInstances의 응답 메시지입니다.

ListInstancesResponse

JSON 표현
{ "instances": [ { object (`Instance`) } ], "nextPageToken": string, "unreachable": [ string ] }

필드

필드
`instances[]`	`object (Instance)` 요청된 {location}이 '-'인 경우 응답에 모든 위치의 인스턴스 목록이 포함됩니다. 연결할 수 없는 위치의 인스턴스는 생략됩니다.
`nextPageToken`	`string` 다음 페이지를 검색하기 위해 `page_token`으로 전송할 수 있는 토큰입니다. 이 필드를 생략하면 후속 페이지가 표시되지 않습니다.
`unreachable[]`	`string` 도달할 수 없는 위치입니다.

instances[]

object (Instance)

요청된 {location}이 '-'인 경우 응답에 모든 위치의 인스턴스 목록이 포함됩니다. 연결할 수 없는 위치의 인스턴스는 생략됩니다.

nextPageToken

string

다음 페이지를 검색하기 위해 page_token으로 전송할 수 있는 토큰입니다. 이 필드를 생략하면 후속 페이지가 표시되지 않습니다.

unreachable[]

string

도달할 수 없는 위치입니다.

인스턴스

JSON 표현

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`) }, // 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`. // Union field `_replica_count` can be only one of the following: "replicaCount": integer // End of list of possible types for union field `_replica_count`. // Union field `_deletion_protection_enabled` can be only one of the following: "deletionProtectionEnabled": boolean // End of list of possible types for union field `_deletion_protection_enabled`. // Union field `_simulate_maintenance_event` can be only one of the following: "simulateMaintenanceEvent": boolean // End of list of possible types for union field `_simulate_maintenance_event`. // Union field `_ondemand_maintenance` can be only one of the following: "ondemandMaintenance": boolean // End of list of possible types for union field `_ondemand_maintenance`. // Union field `_satisfies_pzs` can be only one of the following: "satisfiesPzs": boolean // End of list of possible types for union field `_satisfies_pzs`. // Union field `_satisfies_pzi` can be only one of the following: "satisfiesPzi": boolean // End of list of possible types for union field `_satisfies_pzi`. // Union field `_async_instance_endpoints_deletion_enabled` can be only one of // the following: "asyncInstanceEndpointsDeletionEnabled": boolean // End of list of possible types for union field // `_async_instance_endpoints_deletion_enabled`. // Union field `_kms_key` can be only one of the following: "kmsKey": string // End of list of possible types for union field `_kms_key`. // Union field `_backup_collection` can be only one of the following: "backupCollection": string // End of list of possible types for union field `_backup_collection`. // Union field `_maintenance_version` can be only one of the following: "maintenanceVersion": string // End of list of possible types for union field `_maintenance_version`. // Union field `_effective_maintenance_version` can be only one of the following: "effectiveMaintenanceVersion": string // End of list of possible types for union field // `_effective_maintenance_version`. // Union field `_server_ca_mode` can be only one of the following: "serverCaMode": enum (`ServerCaMode`) // End of list of possible types for union field `_server_ca_mode`. // Union field `_server_ca_pool` can be only one of the following: "serverCaPool": string // End of list of possible types for union field `_server_ca_pool`. // Union field `_rotate_server_certificate` can be only one of the following: "rotateServerCertificate": boolean // End of list of possible types for union field `_rotate_server_certificate`. // Union field `_acl_policy` can be only one of the following: "aclPolicy": string // End of list of possible types for union field `_acl_policy`. // Union field `_acl_policy_in_sync` can be only one of the following: "aclPolicyInSync": boolean // End of list of possible types for union field `_acl_policy_in_sync`. }

{
  "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)
  },

  // 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.

  // Union field _replica_count can be only one of the following:
  "replicaCount": integer
  // End of list of possible types for union field _replica_count.

  // Union field _deletion_protection_enabled can be only one of the following:
  "deletionProtectionEnabled": boolean
  // End of list of possible types for union field _deletion_protection_enabled.

  // Union field _simulate_maintenance_event can be only one of the following:
  "simulateMaintenanceEvent": boolean
  // End of list of possible types for union field _simulate_maintenance_event.

  // Union field _ondemand_maintenance can be only one of the following:
  "ondemandMaintenance": boolean
  // End of list of possible types for union field _ondemand_maintenance.

  // Union field _satisfies_pzs can be only one of the following:
  "satisfiesPzs": boolean
  // End of list of possible types for union field _satisfies_pzs.

  // Union field _satisfies_pzi can be only one of the following:
  "satisfiesPzi": boolean
  // End of list of possible types for union field _satisfies_pzi.

  // Union field _async_instance_endpoints_deletion_enabled can be only one of
  // the following:
  "asyncInstanceEndpointsDeletionEnabled": boolean
  // End of list of possible types for union field
  // _async_instance_endpoints_deletion_enabled.

  // Union field _kms_key can be only one of the following:
  "kmsKey": string
  // End of list of possible types for union field _kms_key.

  // Union field _backup_collection can be only one of the following:
  "backupCollection": string
  // End of list of possible types for union field _backup_collection.

  // Union field _maintenance_version can be only one of the following:
  "maintenanceVersion": string
  // End of list of possible types for union field _maintenance_version.

  // Union field _effective_maintenance_version can be only one of the following:
  "effectiveMaintenanceVersion": string
  // End of list of possible types for union field
  // _effective_maintenance_version.

  // Union field _server_ca_mode can be only one of the following:
  "serverCaMode": enum (ServerCaMode)
  // End of list of possible types for union field _server_ca_mode.

  // Union field _server_ca_pool can be only one of the following:
  "serverCaPool": string
  // End of list of possible types for union field _server_ca_pool.

  // Union field _rotate_server_certificate can be only one of the following:
  "rotateServerCertificate": boolean
  // End of list of possible types for union field _rotate_server_certificate.

  // Union field _acl_policy can be only one of the following:
  "aclPolicy": string
  // End of list of possible types for union field _acl_policy.

  // Union field _acl_policy_in_sync can be only one of the following:
  "aclPolicyInSync": boolean
  // End of list of possible types for union field _acl_policy_in_sync.
}

필드

필드
`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)` 이 항목은 지원 중단되었습니다. 출력 전용입니다. 지원 중단됨: discovery_endpoints 매개변수가 지원 중단되었습니다. 따라서 엔드포인트 매개변수를 사용하여 연결을 생성하면 채워지지 않습니다. 이 매개변수 대신 검색의 경우 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)` 출력 전용입니다. 인스턴스의 이전 구성입니다.
통합 필드 `import_sources`. 가져올 소스입니다. `import_sources`은 다음 중 하나여야 합니다.
`gcsSource`	`object (GcsBackupSource)` 선택사항입니다. 변경할 수 없습니다. Cloud Storage 버킷에 저장된 백업 Cloud Storage 버킷은 인스턴스와 동일한 리전에 있어야 합니다. 제공된 Cloud Storage 객체에서 가져오려면 읽기 권한이 필요합니다.
`managedBackupSource`	`object (ManagedBackupSource)` 선택사항입니다. 변경할 수 없습니다. Memorystore 서비스에서 생성하고 관리하는 백업입니다.
통합 필드 `_replica_count`. `_replica_count`는 다음 중 하나여야 합니다.
`replicaCount`	`integer` 선택사항입니다. 샤드당 복제본 노드 수입니다. 생략한 경우 기본값은 복제본 0개입니다.
통합 필드 `_deletion_protection_enabled`. `_deletion_protection_enabled`는 다음 중 하나여야 합니다.
`deletionProtectionEnabled`	`boolean` 선택사항입니다. true로 설정하면 인스턴스 삭제가 실패합니다.
통합 필드 `_simulate_maintenance_event`. `_simulate_maintenance_event`는 다음 중 하나여야 합니다.
`simulateMaintenanceEvent`	`boolean` 선택사항입니다. 입력 전용입니다. 유지보수 이벤트를 시뮬레이션합니다.
통합 필드 `_ondemand_maintenance`. `_ondemand_maintenance`는 다음 중 하나여야 합니다.
`ondemandMaintenance (deprecated)`	`boolean` 이 항목은 지원 중단되었습니다. 선택사항입니다. 입력 전용입니다. 인스턴스의 온디맨드 유지보수입니다.
통합 필드 `_satisfies_pzs`. `_satisfies_pzs`는 다음 중 하나여야 합니다.
`satisfiesPzs`	`boolean` 선택사항입니다. 출력 전용입니다. 나중에 사용하기 위해 예약되어 있습니다.
통합 필드 `_satisfies_pzi`. `_satisfies_pzi`는 다음 중 하나여야 합니다.
`satisfiesPzi`	`boolean` 선택사항입니다. 출력 전용입니다. 나중에 사용하기 위해 예약되어 있습니다.
통합 필드 `_async_instance_endpoints_deletion_enabled`. `_async_instance_endpoints_deletion_enabled`는 다음 중 하나여야 합니다.
`asyncInstanceEndpointsDeletionEnabled`	`boolean` 선택사항입니다. true인 경우 고객이 만들고 등록한 인스턴스 엔드포인트를 비동기식으로 삭제할 수 있습니다. 즉, 이러한 인스턴스 엔드포인트는 인스턴스 엔드포인트의 전달 규칙이 삭제되기 전에 등록 해제될 수 있습니다.
통합 필드 `_kms_key`. `_kms_key`는 다음 중 하나여야 합니다.
`kmsKey`	`string` 선택사항입니다. 클러스터의 저장 데이터를 암호화하는 데 사용되는 KMS 키입니다.
통합 필드 `_backup_collection`. `_backup_collection`는 다음 중 하나여야 합니다.
`backupCollection`	`string` 출력 전용입니다. 백업 컬렉션 전체 리소스 이름입니다. 예: projects/{project}/locations/{location}/backupCollections/{collection}
통합 필드 `_maintenance_version`. `_maintenance_version`는 다음 중 하나여야 합니다.
`maintenanceVersion`	`string` 선택사항입니다. 이 필드는 원하는 유지보수 버전을 나타내기 위해 셀프 서비스 업데이트를 트리거하는 데 사용할 수 있습니다. 이 필드의 입력은 available_maintenance_versions 필드로 확인할 수 있습니다.
통합 필드 `_effective_maintenance_version`. `_effective_maintenance_version`는 다음 중 하나여야 합니다.
`effectiveMaintenanceVersion`	`string` 출력 전용입니다. 이 필드는 인스턴스의 실제 유지보수 버전을 나타냅니다.
통합 필드 `_server_ca_mode`. `_server_ca_mode`는 다음 중 하나여야 합니다.
`serverCaMode`	`enum (ServerCaMode)` 선택사항입니다. 변경할 수 없습니다. 인스턴스의 서버 CA 모드입니다.
통합 필드 `_server_ca_pool`. `_server_ca_pool`는 다음 중 하나여야 합니다.
`serverCaPool`	`string` 선택사항입니다. 변경할 수 없습니다. 인스턴스의 고객 관리 CA 풀입니다. 서버 CA 모드가 CUSTOMER_MANAGED_CAS_CA인 경우에만 적용됩니다. 형식: 'projects/{project}/locations/{region}/caPools/{ca_pool}'
통합 필드 `_rotate_server_certificate`. `_rotate_server_certificate`는 다음 중 하나여야 합니다.
`rotateServerCertificate`	`boolean` 선택사항입니다. 입력 전용입니다. 서버 인증서를 순환합니다.
통합 필드 `_acl_policy`. `_acl_policy`는 다음 중 하나여야 합니다.
`aclPolicy`	`string` 선택사항입니다. 인스턴스의 ACL 정책입니다. 형식: projects/{project}/locations/{location}/aclPolicies/{acl_policy}
통합 필드 `_acl_policy_in_sync`. `_acl_policy_in_sync`는 다음 중 하나여야 합니다.
`aclPolicyInSync`	`boolean` 출력 전용입니다. 인스턴스에 적용된 ACL 규칙이 최신 ACL 정책 규칙과 동기화되었는지 여부입니다. 이 필드는 인스턴스에 ACL 정책이 설정된 경우에만 적용됩니다.

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)

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

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)

출력 전용입니다. 지원 중단됨: discovery_endpoints 매개변수가 지원 중단되었습니다. 따라서 엔드포인트 매개변수를 사용하여 연결을 생성하면 채워지지 않습니다. 이 매개변수 대신 검색의 경우 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)

출력 전용입니다. 인스턴스의 이전 구성입니다.

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

gcsSource

object (GcsBackupSource)

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

managedBackupSource

object (ManagedBackupSource)

선택사항입니다. 변경할 수 없습니다. Memorystore 서비스에서 생성하고 관리하는 백업입니다.

통합 필드 _replica_count.

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

replicaCount

integer

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

통합 필드 _deletion_protection_enabled.

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

deletionProtectionEnabled

boolean

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

통합 필드 _simulate_maintenance_event.

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

simulateMaintenanceEvent

boolean

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

통합 필드 _ondemand_maintenance.

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

ondemandMaintenance
(deprecated)

boolean

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

통합 필드 _satisfies_pzs.

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

satisfiesPzs

boolean

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

통합 필드 _satisfies_pzi.

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

satisfiesPzi

boolean

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

통합 필드 _async_instance_endpoints_deletion_enabled.

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

asyncInstanceEndpointsDeletionEnabled

boolean

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

통합 필드 _kms_key.

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

kmsKey

string

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

통합 필드 _backup_collection.

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

backupCollection

string

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

통합 필드 _maintenance_version.

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

maintenanceVersion

string

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

통합 필드 _effective_maintenance_version.

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

effectiveMaintenanceVersion

string

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

통합 필드 _server_ca_mode.

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

serverCaMode

enum (ServerCaMode)

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

통합 필드 _server_ca_pool.

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

serverCaPool

string

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

통합 필드 _rotate_server_certificate.

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

rotateServerCertificate

boolean

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

통합 필드 _acl_policy.

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

aclPolicy

string

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

통합 필드 _acl_policy_in_sync.

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

aclPolicyInSync

boolean

출력 전용입니다. 인스턴스에 적용된 ACL 규칙이 최신 ACL 정책 규칙과 동기화되었는지 여부입니다. 이 필드는 인스턴스에 ACL 정책이 설정된 경우에만 적용됩니다.

GcsBackupSource

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

필드

필드
`uris[]`	`string` 선택사항입니다. 예: gs://bucket1/object1, gs://bucket2/folder2/object2

uris[]

string

선택사항입니다. 예: gs://bucket1/object1, gs://bucket2/folder2/object2

ManagedBackupSource

JSON 표현
{ "backup": string }

필드

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

backup

string

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

타임스탬프

JSON 표현
{ "seconds": string, "nanos": integer }

필드

필드
`seconds`	`string (int64 format)` Unix epoch 1970-01-01T00:00:00Z 이후 UTC 시간의 초 단위로 표현합니다. -62135596800~253402300799 (0001-01-01T00:00:00Z~9999-12-31T23:59:59Z) 사이여야 합니다.
`nanos`	`integer` 나노초 단위의 음수가 아닌 초수입니다. 이 필드는 기간의 나노초 부분이며 초의 대안이 아닙니다. 음수의 초수 값에는 시간에 반영되는 음수가 아닌 나노초 값이 있어야 합니다. 0~999,999,999(포함) 사이여야 합니다.

seconds

string (int64 format)

Unix epoch 1970-01-01T00:00:00Z 이후 UTC 시간의 초 단위로 표현합니다. -62135596800~253402300799 (0001-01-01T00:00:00Z~9999-12-31T23:59:59Z) 사이여야 합니다.

nanos

integer

나노초 단위의 음수가 아닌 초수입니다. 이 필드는 기간의 나노초 부분이며 초의 대안이 아닙니다. 음수의 초수 값에는 시간에 반영되는 음수가 아닌 나노초 값이 있어야 합니다. 0~999,999,999(포함) 사이여야 합니다.

LabelsEntry

JSON 표현
{ "key": string, "value": string }

필드
`key`	`string`
`value`	`string`

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일 때 진행 중인 업데이트를 설명합니다.

통합 필드 info.

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

updateInfo

object (UpdateInfo)

출력 전용입니다. 인스턴스 상태가 UPDATING일 때 진행 중인 업데이트를 설명합니다.

UpdateInfo

JSON 표현

JSON 표현
{ // Union field `_target_shard_count` can be only one of the following: "targetShardCount": integer // End of list of possible types for union field `_target_shard_count`. // Union field `_target_replica_count` can be only one of the following: "targetReplicaCount": integer // End of list of possible types for union field `_target_replica_count`. // Union field `_target_engine_version` can be only one of the following: "targetEngineVersion": string // End of list of possible types for union field `_target_engine_version`. // Union field `_target_node_type` can be only one of the following: "targetNodeType": enum (`NodeType`) // End of list of possible types for union field `_target_node_type`. }

{

  // Union field _target_shard_count can be only one of the following:
  "targetShardCount": integer
  // End of list of possible types for union field _target_shard_count.

  // Union field _target_replica_count can be only one of the following:
  "targetReplicaCount": integer
  // End of list of possible types for union field _target_replica_count.

  // Union field _target_engine_version can be only one of the following:
  "targetEngineVersion": string
  // End of list of possible types for union field _target_engine_version.

  // Union field _target_node_type can be only one of the following:
  "targetNodeType": enum (NodeType)
  // End of list of possible types for union field _target_node_type.
}

필드

필드
통합 필드 `_target_shard_count`. `_target_shard_count`는 다음 중 하나여야 합니다.
`targetShardCount`	`integer` 출력 전용입니다. 인스턴스의 대상 샤드 수입니다.
통합 필드 `_target_replica_count`. `_target_replica_count`는 다음 중 하나여야 합니다.
`targetReplicaCount`	`integer` 출력 전용입니다. 인스턴스의 샤드당 대상 복제본 노드 수입니다.
통합 필드 `_target_engine_version`. `_target_engine_version`는 다음 중 하나여야 합니다.
`targetEngineVersion`	`string` 출력 전용입니다. 인스턴스의 타겟 엔진 버전입니다.
통합 필드 `_target_node_type`. `_target_node_type`는 다음 중 하나여야 합니다.
`targetNodeType`	`enum (NodeType)` 출력 전용입니다. 인스턴스의 타겟 노드 유형입니다.

통합 필드 _target_shard_count.

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

targetShardCount

integer

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

통합 필드 _target_replica_count.

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

targetReplicaCount

integer

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

통합 필드 _target_engine_version.

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

targetEngineVersion

string

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

통합 필드 _target_node_type.

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

targetNodeType

enum (NodeType)

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

DiscoveryEndpoint

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

필드

필드
`address`	`string` 출력 전용입니다. 노출된 엔드포인트 클라이언트가 연결되는 IP 주소입니다.
`port`	`integer` 출력 전용입니다. 노출된 엔드포인트의 포트 번호입니다.
`network`	`string` 출력 전용입니다. 탐색 엔드포인트의 IP 주소가 projects/{network_project}/global/networks/{network_id} 형식으로 예약되는 네트워크입니다.

address

string

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

port

integer

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

network

string

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

PersistenceConfig

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

필드

필드
`mode`	`enum (PersistenceMode)` 선택사항. 현재 지속성 모드입니다.
`rdbConfig`	`object (RDBConfig)` 선택사항. RDB 구성입니다. 모드가 RDB가 아닌 경우 이 필드는 무시됩니다.
`aofConfig`	`object (AOFConfig)` 선택사항. AOF 구성입니다. 모드가 AOF가 아닌 경우 이 필드는 무시됩니다.

mode

enum (PersistenceMode)

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

rdbConfig

object (RDBConfig)

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

aofConfig

object (AOFConfig)

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

RDBConfig

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

rdbSnapshotPeriod

enum (SnapshotPeriod)

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

rdbSnapshotStartTime

string (Timestamp format)

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

AOFConfig

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

필드

필드
`appendFsync`	`enum (AppendFsync)` 선택사항. fsync 모드입니다.

appendFsync

enum (AppendFsync)

선택사항. fsync 모드입니다.

EngineConfigsEntry

JSON 표현
{ "key": string, "value": string }

필드
`key`	`string`
`value`	`string`

NodeConfig

JSON 표현
{ "sizeGb": number }

필드

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

sizeGb

number

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

ZoneDistributionConfig

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

필드

필드
`zone`	`string` 선택사항. 모든 리소스가 SINGLE_ZONE 모드로 할당되는 영역을 정의합니다. MULTI_ZONE 모드에서는 무시됩니다.
`mode`	`enum (ZoneDistributionMode)` 선택사항. 현재 영역 배포 모드입니다. 기본값은 MULTI_ZONE입니다.

zone

string

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

mode

enum (ZoneDistributionMode)

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

PscAutoConnection

JSON 표현

JSON 표현
{ "pscConnectionId": string, "ipAddress": 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,
  "ipAddress": 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입니다.
`ipAddress`	`string` 출력 전용입니다. PSC 전달 규칙에 대해 소비자 네트워크에 할당된 IP입니다.
`forwardingRule`	`string` 출력 전용입니다. 소비자 측 전달 규칙의 URI입니다. 형식: projects/{project}/regions/{region}/forwardingRules/{forwarding_rule}
`projectId`	`string` 필수 항목입니다. PSC 연결이 설정된 소비자 project_id입니다. 인스턴스가 생성되는 프로젝트_id와 동일해야 합니다.
`network`	`string` 필수 항목입니다. PSC 엔드포인트가 생성되는 네트워크이며 projects/{project_id}/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 연결 유형입니다.
통합 필드 `ports`. 노출된 엔드포인트의 포트입니다. `ports`은 다음 중 하나여야 합니다.
`port`	`integer` 선택사항입니다. 포트는 기본/리더 또는 검색 엔드포인트에만 설정됩니다.

PscAttachmentDetail

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

필드

필드
`serviceAttachment`	`string` 출력 전용입니다. 직접 만든 PscConnection이 타겟으로 사용해야 하는 서비스 연결 URI입니다.
`connectionType`	`enum (ConnectionType)` 출력 전용입니다. PSC 엔드포인트의 유형입니다.

serviceAttachment

string

출력 전용입니다. 직접 만든 PscConnection이 타겟으로 사용해야 하는 서비스 연결 URI입니다.

connectionType

enum (ConnectionType)

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

InstanceEndpoint

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

필드

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

connections[]

object (ConnectionDetail)

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

ConnectionDetail

JSON 표현

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`. }

{

  // 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 연결의 세부정보입니다.

통합 필드 connection. 인스턴스에 대한 PSC 연결은 클러스터 생성 중에 서비스 연결 자동화 (자동 연결)를 통해 생성되거나 고객이 직접 생성할 수 있습니다 (사용자 생성 연결). connection은 다음 중 하나여야 합니다.

pscAutoConnection

object (PscAutoConnection)

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

pscConnection

object (PscConnection)

사용자가 만든 PSC 연결의 세부정보입니다.

PscConnection

JSON 표현

JSON 표현
{ "pscConnectionId": string, "ipAddress": 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,
  "ipAddress": 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입니다.
`ipAddress`	`string` 필수 항목입니다. PSC 전달 규칙에 대해 소비자 네트워크에 할당된 IP입니다.
`forwardingRule`	`string` 필수 항목입니다. 소비자 측 전달 규칙의 URI입니다. 형식: projects/{project}/regions/{region}/forwardingRules/{forwarding_rule}
`projectId`	`string` 출력 전용입니다. 전달 규칙이 생성된 소비자 project_id입니다.
`network`	`string` 필수 항목입니다. IP 주소가 있는 소비자 네트워크이며 projects/{project_id}/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 연결 유형입니다.
통합 필드 `ports`. 노출된 엔드포인트의 포트입니다. `ports`은 다음 중 하나여야 합니다.
`port`	`integer` 선택사항입니다. 포트는 기본/리더 또는 검색 엔드포인트에만 설정됩니다.

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

createTime

string (Timestamp format)

출력 전용입니다. 정책이 생성된 시간입니다.

updateTime

string (Timestamp format)

출력 전용입니다. 정책이 업데이트된 시간입니다.

weeklyMaintenanceWindow[]

object (WeeklyMaintenanceWindow)

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

WeeklyMaintenanceWindow

JSON 표현
{ "day": enum (`google.type.DayOfWeek`), "startTime": { object (`TimeOfDay`) } }

필드

필드
`day`	`enum (google.type.DayOfWeek)` 선택사항입니다. 지정된 요일에 실행되는 일정을 정의할 수 있습니다.
`startTime`	`object (TimeOfDay)` 선택사항입니다. 기간의 시작 시간(UTC)입니다.

day

enum (google.type.DayOfWeek)

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

startTime

object (TimeOfDay)

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

TimeOfDay

JSON 표현
{ "hours": integer, "minutes": integer, "seconds": integer, "nanos": integer }

필드
`hours`	`integer` 24시간 형식의 시간입니다. 0 이상이어야 하며 일반적으로 23 이하여야 합니다. API는 비즈니스 종료 시간과 같은 시나리오에서 '24:00:00' 값을 허용하도록 선택할 수 있습니다.
`minutes`	`integer` 시간의 분입니다. 0 이상 59 이하여야 합니다.
`seconds`	`integer` 분의 초입니다. 0 이상이어야 하며 일반적으로 59 이하여야 합니다. API가 윤초를 허용하는 경우 값에 60을 사용할 수 있습니다.
`nanos`	`integer` 나노초 단위의 초수입니다. 0 이상, 999,999,999 이하여야 합니다.

MaintenanceSchedule

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

필드

startTime

string (Timestamp format)

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

endTime

string (Timestamp format)

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

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 요청을 다른 구성원 인스턴스로 보낼 수 있으며 이 필드에는 인스턴스 간 복제에 참여하는 모든 구성원 인스턴스가 나열됩니다.

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)

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

EncryptionInfo

JSON 표현
{ "encryptionType": enum (`Type`), "kmsKeyVersions": [ string ], "kmsKeyPrimaryState": enum (`KmsKeyState`), "lastUpdateTime": string }

필드
`encryptionType`	`enum (Type)` 출력 전용입니다. 암호화 유형입니다.
`kmsKeyVersions[]`	`string` 출력 전용입니다. 저장 데이터를 보호하는 데 사용되는 KMS 키 버전입니다.
`kmsKeyPrimaryState`	`enum (KmsKeyState)` 출력 전용입니다. 시스템에서 인식하는 KMS 키의 기본 버전 상태입니다. 이 필드는 백업에 채워지지 않습니다.
`lastUpdateTime`	`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"`입니다.

AutomatedBackupConfig

JSON 표현

{
  "automatedBackupMode": enum (AutomatedBackupMode),
  "retention": string,

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

필드
`automatedBackupMode`	`enum (AutomatedBackupMode)` 선택사항입니다. 자동 백업 모드입니다. 모드가 사용 중지되면 다른 필드는 무시됩니다.
`retention`	`string (Duration format)` 선택사항입니다. 백업이 삭제되기 전에 자동 백업을 보관할 기간입니다. 값은 1일에서 365일 사이여야 합니다. 지정하지 않으면 기본값은 35일입니다. 소수점 아래가 최대 9자리까지이고 '`s`'로 끝나는 초 단위 기간입니다. 예를 들면 `"3.5s"`입니다.
통합 필드 `schedule`. 자동 백업 일정입니다. `schedule`은 다음 중 하나여야 합니다.
`fixedFrequencySchedule`	`object (FixedFrequencySchedule)` 선택사항입니다. 고정된 빈도로 자동 백업을 트리거합니다.

FixedFrequencySchedule

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

필드

startTime

object (TimeOfDay)

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

기간

JSON 표현
{ "seconds": string, "nanos": integer }

필드

seconds

string (int64 format)

시간 범위의 부호가 있는 초입니다. -315,576,000,000~+315,576,000,000(포함) 사이여야 합니다. 참고: 이 범위는 60초/분 * 60분/시간 * 24시간/일 * 365.25일/년 * 10,000년에서 계산됩니다.

nanos

integer

시간 범위의 나노초 단위의 부호가 있는 초수입니다. 1초 미만의 기간은 0 seconds 필드와 양수 또는 음수 nanos 필드로 표현됩니다. 1초 이상의 기간의 경우 nanos 필드의 0이 아닌 값은 seconds 필드와 부호가 같아야 합니다. -999,999,999~+999,999,999(포함) 사이여야 합니다.

MigrationConfig

JSON 표현

{
  "state": enum (State),
  "forceFinishMigration": boolean,

  // Union field source can be only one of the following:
  "selfManagedSource": {
    object (SelfManagedSource)
  }
  // End of list of possible types for union field source.
}

필드
`state`	`enum (State)` 출력 전용입니다. 인스턴스의 이전 상태입니다.
`forceFinishMigration`	`boolean` 출력 전용입니다. 복제를 중지하기 전에 소스와 대상 간 오프셋 따라잡기 검증 없이 마이그레이션 완료를 강제하는 불리언 플래그를 나타냅니다.
통합 필드 `source`. 이전 소스에 대한 세부정보입니다. `source`은 다음 중 하나여야 합니다.
`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/{network_attachment}

도구 주석

파괴적 힌트: ❌ | 동일한 힌트: ✅ | 읽기 전용 힌트: ✅ | 오픈 월드 힌트: ❌

MCP Tools Reference: memorystore.googleapis.com 컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.

도구: list_instances

입력 스키마

ListInstancesRequest

출력 스키마

ListInstancesResponse

인스턴스

GcsBackupSource

ManagedBackupSource

타임스탬프

LabelsEntry

StateInfo

UpdateInfo

DiscoveryEndpoint

PersistenceConfig

RDBConfig

AOFConfig

EngineConfigsEntry

NodeConfig

ZoneDistributionConfig

PscAutoConnection

PscAttachmentDetail

InstanceEndpoint

ConnectionDetail

PscConnection

MaintenancePolicy

WeeklyMaintenanceWindow

TimeOfDay

MaintenanceSchedule

CrossInstanceReplicationConfig

RemoteInstance

멤버십

EncryptionInfo

AutomatedBackupConfig

FixedFrequencySchedule

기간

MigrationConfig

SelfManagedSource

도구 주석

MCP Tools Reference: memorystore.googleapis.com

도구: `list_instances`