Skip to main content

instances

Overview

Nameinstances
TypeResource
Idgoogle.file.instances

Fields

NameDatatypeDescription
namestringOutput only. The resource name of the instance, in the format projects/{project}/locations/{location}/instances/{instance}.
descriptionstringThe description of the instance (2048 characters or less).
createTimestringOutput only. The time when the instance was created.
etagstringServer-specified ETag for the instance resource to prevent simultaneous updates from overwriting each other.
statestringOutput only. The instance state.
networksarrayVPC networks to which the instance is connected. For this version, only a single network is supported.
suspensionReasonsarrayOutput only. Field indicates all the reasons the instance is in "SUSPENDED" state.
tierstringThe service tier of the instance.
kmsKeyNamestringKMS key name used for data encryption.
statusMessagestringOutput only. Additional information about the instance state, if available.
labelsobjectResource labels to represent user provided metadata.
fileSharesarrayFile system shares on the instance. For this version, only a single file share is supported.
satisfiesPzsbooleanOutput only. Reserved for future use.

Methods

NameAccessible byRequired ParamsDescription
getSELECTinstancesId, locationsId, projectsIdGets the details of a specific instance.
listSELECTlocationsId, projectsIdLists all instances in a project for either a specified location or for all locations.
createINSERTlocationsId, projectsIdCreates an instance. When creating from a backup, the capacity of the new instance needs to be equal to or larger than the capacity of the backup (and also equal to or larger than the minimum capacity of the tier).
deleteDELETEinstancesId, locationsId, projectsIdDeletes an instance.
_listEXEClocationsId, projectsIdLists all instances in a project for either a specified location or for all locations.
patchEXECinstancesId, locationsId, projectsIdUpdates the settings of a specific instance.
restoreEXECinstancesId, locationsId, projectsIdRestores an existing instance's file share from a backup. The capacity of the instance needs to be equal to or larger than the capacity of the backup (and also equal to or larger than the minimum capacity of the tier).
revertEXECinstancesId, locationsId, projectsIdRevert an existing instance's file system to a specified snapshot.