Google Cloud Native is in preview. Google Cloud Classic is fully supported.
Google Cloud Native v0.32.0 published on Wednesday, Nov 29, 2023 by Pulumi
google-native.workstations/v1.getWorkstationConfig
Explore with Pulumi AI
Google Cloud Native is in preview. Google Cloud Classic is fully supported.
Google Cloud Native v0.32.0 published on Wednesday, Nov 29, 2023 by Pulumi
Returns the requested workstation configuration.
Using getWorkstationConfig
Two invocation forms are available. The direct form accepts plain arguments and either blocks until the result value is available, or returns a Promise-wrapped result. The output form accepts Input-wrapped arguments and returns an Output-wrapped result.
function getWorkstationConfig(args: GetWorkstationConfigArgs, opts?: InvokeOptions): Promise<GetWorkstationConfigResult>
function getWorkstationConfigOutput(args: GetWorkstationConfigOutputArgs, opts?: InvokeOptions): Output<GetWorkstationConfigResult>
def get_workstation_config(location: Optional[str] = None,
project: Optional[str] = None,
workstation_cluster_id: Optional[str] = None,
workstation_config_id: Optional[str] = None,
opts: Optional[InvokeOptions] = None) -> GetWorkstationConfigResult
def get_workstation_config_output(location: Optional[pulumi.Input[str]] = None,
project: Optional[pulumi.Input[str]] = None,
workstation_cluster_id: Optional[pulumi.Input[str]] = None,
workstation_config_id: Optional[pulumi.Input[str]] = None,
opts: Optional[InvokeOptions] = None) -> Output[GetWorkstationConfigResult]
func LookupWorkstationConfig(ctx *Context, args *LookupWorkstationConfigArgs, opts ...InvokeOption) (*LookupWorkstationConfigResult, error)
func LookupWorkstationConfigOutput(ctx *Context, args *LookupWorkstationConfigOutputArgs, opts ...InvokeOption) LookupWorkstationConfigResultOutput
> Note: This function is named LookupWorkstationConfig
in the Go SDK.
public static class GetWorkstationConfig
{
public static Task<GetWorkstationConfigResult> InvokeAsync(GetWorkstationConfigArgs args, InvokeOptions? opts = null)
public static Output<GetWorkstationConfigResult> Invoke(GetWorkstationConfigInvokeArgs args, InvokeOptions? opts = null)
}
public static CompletableFuture<GetWorkstationConfigResult> getWorkstationConfig(GetWorkstationConfigArgs args, InvokeOptions options)
// Output-based functions aren't available in Java yet
fn::invoke:
function: google-native:workstations/v1:getWorkstationConfig
arguments:
# arguments dictionary
The following arguments are supported:
- Location string
- Workstation
Cluster stringId - Workstation
Config stringId - Project string
- Location string
- Workstation
Cluster stringId - Workstation
Config stringId - Project string
- location String
- workstation
Cluster StringId - workstation
Config StringId - project String
- location string
- workstation
Cluster stringId - workstation
Config stringId - project string
- location str
- workstation_
cluster_ strid - workstation_
config_ strid - project str
- location String
- workstation
Cluster StringId - workstation
Config StringId - project String
getWorkstationConfig Result
The following output properties are available:
- Annotations Dictionary<string, string>
- Optional. Client-specified annotations.
- Conditions
List<Pulumi.
Google Native. Workstations. V1. Outputs. Status Response> - Status conditions describing the current resource state.
- Container
Pulumi.
Google Native. Workstations. V1. Outputs. Container Response - Optional. Container that runs upon startup for each workstation using this workstation configuration.
- Create
Time string - Time when this workstation configuration was created.
- Degraded bool
- Whether this resource is degraded, in which case it may require user action to restore full functionality. See also the conditions field.
- Delete
Time string - Time when this workstation configuration was soft-deleted.
- Display
Name string - Optional. Human-readable name for this workstation configuration.
- Encryption
Key Pulumi.Google Native. Workstations. V1. Outputs. Customer Encryption Key Response - Immutable. Encrypts resources of this workstation configuration using a customer-managed encryption key (CMEK). If specified, the boot disk of the Compute Engine instance and the persistent disk are encrypted using this encryption key. If this field is not set, the disks are encrypted using a generated key. Customer-managed encryption keys do not protect disk metadata. If the customer-managed encryption key is rotated, when the workstation instance is stopped, the system attempts to recreate the persistent disk with the new version of the key. Be sure to keep older versions of the key until the persistent disk is recreated. Otherwise, data on the persistent disk might be lost. If the encryption key is revoked, the workstation session automatically stops within 7 hours. Immutable after the workstation configuration is created.
- Etag string
- Optional. Checksum computed by the server. May be sent on update and delete requests to make sure that the client has an up-to-date value before proceeding.
- Host
Pulumi.
Google Native. Workstations. V1. Outputs. Host Response - Optional. Runtime host for the workstation.
- Idle
Timeout string - Optional. Number of seconds to wait before automatically stopping a workstation after it last received user traffic. A value of
"0s"
indicates that Cloud Workstations VMs created with this configuration should never time out due to idleness. Provide duration terminated bys
for seconds—for example,"7200s"
(2 hours). The default is"1200s"
(20 minutes). - Labels Dictionary<string, string>
- Optional. Labels that are applied to the workstation configuration and that are also propagated to the underlying Compute Engine resources.
- Name string
- Identifier. Full name of this workstation configuration.
- Persistent
Directories List<Pulumi.Google Native. Workstations. V1. Outputs. Persistent Directory Response> - Optional. Directories to persist across workstation sessions.
- Readiness
Checks List<Pulumi.Google Native. Workstations. V1. Outputs. Readiness Check Response> - Optional. Readiness checks to perform when starting a workstation using this workstation configuration. Mark a workstation as running only after all specified readiness checks return 200 status codes.
- Reconciling bool
- Indicates whether this workstation configuration is currently being updated to match its intended state.
- Replica
Zones List<string> - Optional. Immutable. Specifies the zones used to replicate the VM and disk resources within the region. If set, exactly two zones within the workstation cluster's region must be specified—for example,
['us-central1-a', 'us-central1-f']
. If this field is empty, two default zones within the region are used. Immutable after the workstation configuration is created. - Running
Timeout string - Optional. Number of seconds that a workstation can run until it is automatically shut down. We recommend that workstations be shut down daily to reduce costs and so that security updates can be applied upon restart. The idle_timeout and running_timeout fields are independent of each other. Note that the running_timeout field shuts down VMs after the specified time, regardless of whether or not the VMs are idle. Provide duration terminated by
s
for seconds—for example,"54000s"
(15 hours). Defaults to"43200s"
(12 hours). A value of"0s"
indicates that workstations using this configuration should never time out. If encryption_key is set, it must be greater than"0s"
and less than"86400s"
(24 hours). Warning: A value of"0s"
indicates that Cloud Workstations VMs created with this configuration have no maximum running time. This is strongly discouraged because you incur costs and will not pick up security updates. - Uid string
- A system-assigned unique identifier for this workstation configuration.
- Update
Time string - Time when this workstation configuration was most recently updated.
- Annotations map[string]string
- Optional. Client-specified annotations.
- Conditions
[]Status
Response - Status conditions describing the current resource state.
- Container
Container
Response - Optional. Container that runs upon startup for each workstation using this workstation configuration.
- Create
Time string - Time when this workstation configuration was created.
- Degraded bool
- Whether this resource is degraded, in which case it may require user action to restore full functionality. See also the conditions field.
- Delete
Time string - Time when this workstation configuration was soft-deleted.
- Display
Name string - Optional. Human-readable name for this workstation configuration.
- Encryption
Key CustomerEncryption Key Response - Immutable. Encrypts resources of this workstation configuration using a customer-managed encryption key (CMEK). If specified, the boot disk of the Compute Engine instance and the persistent disk are encrypted using this encryption key. If this field is not set, the disks are encrypted using a generated key. Customer-managed encryption keys do not protect disk metadata. If the customer-managed encryption key is rotated, when the workstation instance is stopped, the system attempts to recreate the persistent disk with the new version of the key. Be sure to keep older versions of the key until the persistent disk is recreated. Otherwise, data on the persistent disk might be lost. If the encryption key is revoked, the workstation session automatically stops within 7 hours. Immutable after the workstation configuration is created.
- Etag string
- Optional. Checksum computed by the server. May be sent on update and delete requests to make sure that the client has an up-to-date value before proceeding.
- Host
Host
Response - Optional. Runtime host for the workstation.
- Idle
Timeout string - Optional. Number of seconds to wait before automatically stopping a workstation after it last received user traffic. A value of
"0s"
indicates that Cloud Workstations VMs created with this configuration should never time out due to idleness. Provide duration terminated bys
for seconds—for example,"7200s"
(2 hours). The default is"1200s"
(20 minutes). - Labels map[string]string
- Optional. Labels that are applied to the workstation configuration and that are also propagated to the underlying Compute Engine resources.
- Name string
- Identifier. Full name of this workstation configuration.
- Persistent
Directories []PersistentDirectory Response - Optional. Directories to persist across workstation sessions.
- Readiness
Checks []ReadinessCheck Response - Optional. Readiness checks to perform when starting a workstation using this workstation configuration. Mark a workstation as running only after all specified readiness checks return 200 status codes.
- Reconciling bool
- Indicates whether this workstation configuration is currently being updated to match its intended state.
- Replica
Zones []string - Optional. Immutable. Specifies the zones used to replicate the VM and disk resources within the region. If set, exactly two zones within the workstation cluster's region must be specified—for example,
['us-central1-a', 'us-central1-f']
. If this field is empty, two default zones within the region are used. Immutable after the workstation configuration is created. - Running
Timeout string - Optional. Number of seconds that a workstation can run until it is automatically shut down. We recommend that workstations be shut down daily to reduce costs and so that security updates can be applied upon restart. The idle_timeout and running_timeout fields are independent of each other. Note that the running_timeout field shuts down VMs after the specified time, regardless of whether or not the VMs are idle. Provide duration terminated by
s
for seconds—for example,"54000s"
(15 hours). Defaults to"43200s"
(12 hours). A value of"0s"
indicates that workstations using this configuration should never time out. If encryption_key is set, it must be greater than"0s"
and less than"86400s"
(24 hours). Warning: A value of"0s"
indicates that Cloud Workstations VMs created with this configuration have no maximum running time. This is strongly discouraged because you incur costs and will not pick up security updates. - Uid string
- A system-assigned unique identifier for this workstation configuration.
- Update
Time string - Time when this workstation configuration was most recently updated.
- annotations Map<String,String>
- Optional. Client-specified annotations.
- conditions
List<Status
Response> - Status conditions describing the current resource state.
- container
Container
Response - Optional. Container that runs upon startup for each workstation using this workstation configuration.
- create
Time String - Time when this workstation configuration was created.
- degraded Boolean
- Whether this resource is degraded, in which case it may require user action to restore full functionality. See also the conditions field.
- delete
Time String - Time when this workstation configuration was soft-deleted.
- display
Name String - Optional. Human-readable name for this workstation configuration.
- encryption
Key CustomerEncryption Key Response - Immutable. Encrypts resources of this workstation configuration using a customer-managed encryption key (CMEK). If specified, the boot disk of the Compute Engine instance and the persistent disk are encrypted using this encryption key. If this field is not set, the disks are encrypted using a generated key. Customer-managed encryption keys do not protect disk metadata. If the customer-managed encryption key is rotated, when the workstation instance is stopped, the system attempts to recreate the persistent disk with the new version of the key. Be sure to keep older versions of the key until the persistent disk is recreated. Otherwise, data on the persistent disk might be lost. If the encryption key is revoked, the workstation session automatically stops within 7 hours. Immutable after the workstation configuration is created.
- etag String
- Optional. Checksum computed by the server. May be sent on update and delete requests to make sure that the client has an up-to-date value before proceeding.
- host
Host
Response - Optional. Runtime host for the workstation.
- idle
Timeout String - Optional. Number of seconds to wait before automatically stopping a workstation after it last received user traffic. A value of
"0s"
indicates that Cloud Workstations VMs created with this configuration should never time out due to idleness. Provide duration terminated bys
for seconds—for example,"7200s"
(2 hours). The default is"1200s"
(20 minutes). - labels Map<String,String>
- Optional. Labels that are applied to the workstation configuration and that are also propagated to the underlying Compute Engine resources.
- name String
- Identifier. Full name of this workstation configuration.
- persistent
Directories List<PersistentDirectory Response> - Optional. Directories to persist across workstation sessions.
- readiness
Checks List<ReadinessCheck Response> - Optional. Readiness checks to perform when starting a workstation using this workstation configuration. Mark a workstation as running only after all specified readiness checks return 200 status codes.
- reconciling Boolean
- Indicates whether this workstation configuration is currently being updated to match its intended state.
- replica
Zones List<String> - Optional. Immutable. Specifies the zones used to replicate the VM and disk resources within the region. If set, exactly two zones within the workstation cluster's region must be specified—for example,
['us-central1-a', 'us-central1-f']
. If this field is empty, two default zones within the region are used. Immutable after the workstation configuration is created. - running
Timeout String - Optional. Number of seconds that a workstation can run until it is automatically shut down. We recommend that workstations be shut down daily to reduce costs and so that security updates can be applied upon restart. The idle_timeout and running_timeout fields are independent of each other. Note that the running_timeout field shuts down VMs after the specified time, regardless of whether or not the VMs are idle. Provide duration terminated by
s
for seconds—for example,"54000s"
(15 hours). Defaults to"43200s"
(12 hours). A value of"0s"
indicates that workstations using this configuration should never time out. If encryption_key is set, it must be greater than"0s"
and less than"86400s"
(24 hours). Warning: A value of"0s"
indicates that Cloud Workstations VMs created with this configuration have no maximum running time. This is strongly discouraged because you incur costs and will not pick up security updates. - uid String
- A system-assigned unique identifier for this workstation configuration.
- update
Time String - Time when this workstation configuration was most recently updated.
- annotations {[key: string]: string}
- Optional. Client-specified annotations.
- conditions
Status
Response[] - Status conditions describing the current resource state.
- container
Container
Response - Optional. Container that runs upon startup for each workstation using this workstation configuration.
- create
Time string - Time when this workstation configuration was created.
- degraded boolean
- Whether this resource is degraded, in which case it may require user action to restore full functionality. See also the conditions field.
- delete
Time string - Time when this workstation configuration was soft-deleted.
- display
Name string - Optional. Human-readable name for this workstation configuration.
- encryption
Key CustomerEncryption Key Response - Immutable. Encrypts resources of this workstation configuration using a customer-managed encryption key (CMEK). If specified, the boot disk of the Compute Engine instance and the persistent disk are encrypted using this encryption key. If this field is not set, the disks are encrypted using a generated key. Customer-managed encryption keys do not protect disk metadata. If the customer-managed encryption key is rotated, when the workstation instance is stopped, the system attempts to recreate the persistent disk with the new version of the key. Be sure to keep older versions of the key until the persistent disk is recreated. Otherwise, data on the persistent disk might be lost. If the encryption key is revoked, the workstation session automatically stops within 7 hours. Immutable after the workstation configuration is created.
- etag string
- Optional. Checksum computed by the server. May be sent on update and delete requests to make sure that the client has an up-to-date value before proceeding.
- host
Host
Response - Optional. Runtime host for the workstation.
- idle
Timeout string - Optional. Number of seconds to wait before automatically stopping a workstation after it last received user traffic. A value of
"0s"
indicates that Cloud Workstations VMs created with this configuration should never time out due to idleness. Provide duration terminated bys
for seconds—for example,"7200s"
(2 hours). The default is"1200s"
(20 minutes). - labels {[key: string]: string}
- Optional. Labels that are applied to the workstation configuration and that are also propagated to the underlying Compute Engine resources.
- name string
- Identifier. Full name of this workstation configuration.
- persistent
Directories PersistentDirectory Response[] - Optional. Directories to persist across workstation sessions.
- readiness
Checks ReadinessCheck Response[] - Optional. Readiness checks to perform when starting a workstation using this workstation configuration. Mark a workstation as running only after all specified readiness checks return 200 status codes.
- reconciling boolean
- Indicates whether this workstation configuration is currently being updated to match its intended state.
- replica
Zones string[] - Optional. Immutable. Specifies the zones used to replicate the VM and disk resources within the region. If set, exactly two zones within the workstation cluster's region must be specified—for example,
['us-central1-a', 'us-central1-f']
. If this field is empty, two default zones within the region are used. Immutable after the workstation configuration is created. - running
Timeout string - Optional. Number of seconds that a workstation can run until it is automatically shut down. We recommend that workstations be shut down daily to reduce costs and so that security updates can be applied upon restart. The idle_timeout and running_timeout fields are independent of each other. Note that the running_timeout field shuts down VMs after the specified time, regardless of whether or not the VMs are idle. Provide duration terminated by
s
for seconds—for example,"54000s"
(15 hours). Defaults to"43200s"
(12 hours). A value of"0s"
indicates that workstations using this configuration should never time out. If encryption_key is set, it must be greater than"0s"
and less than"86400s"
(24 hours). Warning: A value of"0s"
indicates that Cloud Workstations VMs created with this configuration have no maximum running time. This is strongly discouraged because you incur costs and will not pick up security updates. - uid string
- A system-assigned unique identifier for this workstation configuration.
- update
Time string - Time when this workstation configuration was most recently updated.
- annotations Mapping[str, str]
- Optional. Client-specified annotations.
- conditions
Sequence[Status
Response] - Status conditions describing the current resource state.
- container
Container
Response - Optional. Container that runs upon startup for each workstation using this workstation configuration.
- create_
time str - Time when this workstation configuration was created.
- degraded bool
- Whether this resource is degraded, in which case it may require user action to restore full functionality. See also the conditions field.
- delete_
time str - Time when this workstation configuration was soft-deleted.
- display_
name str - Optional. Human-readable name for this workstation configuration.
- encryption_
key CustomerEncryption Key Response - Immutable. Encrypts resources of this workstation configuration using a customer-managed encryption key (CMEK). If specified, the boot disk of the Compute Engine instance and the persistent disk are encrypted using this encryption key. If this field is not set, the disks are encrypted using a generated key. Customer-managed encryption keys do not protect disk metadata. If the customer-managed encryption key is rotated, when the workstation instance is stopped, the system attempts to recreate the persistent disk with the new version of the key. Be sure to keep older versions of the key until the persistent disk is recreated. Otherwise, data on the persistent disk might be lost. If the encryption key is revoked, the workstation session automatically stops within 7 hours. Immutable after the workstation configuration is created.
- etag str
- Optional. Checksum computed by the server. May be sent on update and delete requests to make sure that the client has an up-to-date value before proceeding.
- host
Host
Response - Optional. Runtime host for the workstation.
- idle_
timeout str - Optional. Number of seconds to wait before automatically stopping a workstation after it last received user traffic. A value of
"0s"
indicates that Cloud Workstations VMs created with this configuration should never time out due to idleness. Provide duration terminated bys
for seconds—for example,"7200s"
(2 hours). The default is"1200s"
(20 minutes). - labels Mapping[str, str]
- Optional. Labels that are applied to the workstation configuration and that are also propagated to the underlying Compute Engine resources.
- name str
- Identifier. Full name of this workstation configuration.
- persistent_
directories Sequence[PersistentDirectory Response] - Optional. Directories to persist across workstation sessions.
- readiness_
checks Sequence[ReadinessCheck Response] - Optional. Readiness checks to perform when starting a workstation using this workstation configuration. Mark a workstation as running only after all specified readiness checks return 200 status codes.
- reconciling bool
- Indicates whether this workstation configuration is currently being updated to match its intended state.
- replica_
zones Sequence[str] - Optional. Immutable. Specifies the zones used to replicate the VM and disk resources within the region. If set, exactly two zones within the workstation cluster's region must be specified—for example,
['us-central1-a', 'us-central1-f']
. If this field is empty, two default zones within the region are used. Immutable after the workstation configuration is created. - running_
timeout str - Optional. Number of seconds that a workstation can run until it is automatically shut down. We recommend that workstations be shut down daily to reduce costs and so that security updates can be applied upon restart. The idle_timeout and running_timeout fields are independent of each other. Note that the running_timeout field shuts down VMs after the specified time, regardless of whether or not the VMs are idle. Provide duration terminated by
s
for seconds—for example,"54000s"
(15 hours). Defaults to"43200s"
(12 hours). A value of"0s"
indicates that workstations using this configuration should never time out. If encryption_key is set, it must be greater than"0s"
and less than"86400s"
(24 hours). Warning: A value of"0s"
indicates that Cloud Workstations VMs created with this configuration have no maximum running time. This is strongly discouraged because you incur costs and will not pick up security updates. - uid str
- A system-assigned unique identifier for this workstation configuration.
- update_
time str - Time when this workstation configuration was most recently updated.
- annotations Map<String>
- Optional. Client-specified annotations.
- conditions List<Property Map>
- Status conditions describing the current resource state.
- container Property Map
- Optional. Container that runs upon startup for each workstation using this workstation configuration.
- create
Time String - Time when this workstation configuration was created.
- degraded Boolean
- Whether this resource is degraded, in which case it may require user action to restore full functionality. See also the conditions field.
- delete
Time String - Time when this workstation configuration was soft-deleted.
- display
Name String - Optional. Human-readable name for this workstation configuration.
- encryption
Key Property Map - Immutable. Encrypts resources of this workstation configuration using a customer-managed encryption key (CMEK). If specified, the boot disk of the Compute Engine instance and the persistent disk are encrypted using this encryption key. If this field is not set, the disks are encrypted using a generated key. Customer-managed encryption keys do not protect disk metadata. If the customer-managed encryption key is rotated, when the workstation instance is stopped, the system attempts to recreate the persistent disk with the new version of the key. Be sure to keep older versions of the key until the persistent disk is recreated. Otherwise, data on the persistent disk might be lost. If the encryption key is revoked, the workstation session automatically stops within 7 hours. Immutable after the workstation configuration is created.
- etag String
- Optional. Checksum computed by the server. May be sent on update and delete requests to make sure that the client has an up-to-date value before proceeding.
- host Property Map
- Optional. Runtime host for the workstation.
- idle
Timeout String - Optional. Number of seconds to wait before automatically stopping a workstation after it last received user traffic. A value of
"0s"
indicates that Cloud Workstations VMs created with this configuration should never time out due to idleness. Provide duration terminated bys
for seconds—for example,"7200s"
(2 hours). The default is"1200s"
(20 minutes). - labels Map<String>
- Optional. Labels that are applied to the workstation configuration and that are also propagated to the underlying Compute Engine resources.
- name String
- Identifier. Full name of this workstation configuration.
- persistent
Directories List<Property Map> - Optional. Directories to persist across workstation sessions.
- readiness
Checks List<Property Map> - Optional. Readiness checks to perform when starting a workstation using this workstation configuration. Mark a workstation as running only after all specified readiness checks return 200 status codes.
- reconciling Boolean
- Indicates whether this workstation configuration is currently being updated to match its intended state.
- replica
Zones List<String> - Optional. Immutable. Specifies the zones used to replicate the VM and disk resources within the region. If set, exactly two zones within the workstation cluster's region must be specified—for example,
['us-central1-a', 'us-central1-f']
. If this field is empty, two default zones within the region are used. Immutable after the workstation configuration is created. - running
Timeout String - Optional. Number of seconds that a workstation can run until it is automatically shut down. We recommend that workstations be shut down daily to reduce costs and so that security updates can be applied upon restart. The idle_timeout and running_timeout fields are independent of each other. Note that the running_timeout field shuts down VMs after the specified time, regardless of whether or not the VMs are idle. Provide duration terminated by
s
for seconds—for example,"54000s"
(15 hours). Defaults to"43200s"
(12 hours). A value of"0s"
indicates that workstations using this configuration should never time out. If encryption_key is set, it must be greater than"0s"
and less than"86400s"
(24 hours). Warning: A value of"0s"
indicates that Cloud Workstations VMs created with this configuration have no maximum running time. This is strongly discouraged because you incur costs and will not pick up security updates. - uid String
- A system-assigned unique identifier for this workstation configuration.
- update
Time String - Time when this workstation configuration was most recently updated.
Supporting Types
ContainerResponse
- Args List<string>
- Optional. Arguments passed to the entrypoint.
- Command List<string>
- Optional. If set, overrides the default ENTRYPOINT specified by the image.
- Env Dictionary<string, string>
- Optional. Environment variables passed to the container's entrypoint.
- Image string
- Optional. A Docker container image that defines a custom environment. Cloud Workstations provides a number of preconfigured images, but you can create your own custom container images. If using a private image, the
host.gceInstance.serviceAccount
field must be specified in the workstation configuration. If using a custom container image, the service account must have Artifact Registry Reader permission to pull the specified image. Otherwise, the image must be publicly accessible. - Run
As intUser - Optional. If set, overrides the USER specified in the image with the given uid.
- Working
Dir string - Optional. If set, overrides the default DIR specified by the image.
- Args []string
- Optional. Arguments passed to the entrypoint.
- Command []string
- Optional. If set, overrides the default ENTRYPOINT specified by the image.
- Env map[string]string
- Optional. Environment variables passed to the container's entrypoint.
- Image string
- Optional. A Docker container image that defines a custom environment. Cloud Workstations provides a number of preconfigured images, but you can create your own custom container images. If using a private image, the
host.gceInstance.serviceAccount
field must be specified in the workstation configuration. If using a custom container image, the service account must have Artifact Registry Reader permission to pull the specified image. Otherwise, the image must be publicly accessible. - Run
As intUser - Optional. If set, overrides the USER specified in the image with the given uid.
- Working
Dir string - Optional. If set, overrides the default DIR specified by the image.
- args List<String>
- Optional. Arguments passed to the entrypoint.
- command List<String>
- Optional. If set, overrides the default ENTRYPOINT specified by the image.
- env Map<String,String>
- Optional. Environment variables passed to the container's entrypoint.
- image String
- Optional. A Docker container image that defines a custom environment. Cloud Workstations provides a number of preconfigured images, but you can create your own custom container images. If using a private image, the
host.gceInstance.serviceAccount
field must be specified in the workstation configuration. If using a custom container image, the service account must have Artifact Registry Reader permission to pull the specified image. Otherwise, the image must be publicly accessible. - run
As IntegerUser - Optional. If set, overrides the USER specified in the image with the given uid.
- working
Dir String - Optional. If set, overrides the default DIR specified by the image.
- args string[]
- Optional. Arguments passed to the entrypoint.
- command string[]
- Optional. If set, overrides the default ENTRYPOINT specified by the image.
- env {[key: string]: string}
- Optional. Environment variables passed to the container's entrypoint.
- image string
- Optional. A Docker container image that defines a custom environment. Cloud Workstations provides a number of preconfigured images, but you can create your own custom container images. If using a private image, the
host.gceInstance.serviceAccount
field must be specified in the workstation configuration. If using a custom container image, the service account must have Artifact Registry Reader permission to pull the specified image. Otherwise, the image must be publicly accessible. - run
As numberUser - Optional. If set, overrides the USER specified in the image with the given uid.
- working
Dir string - Optional. If set, overrides the default DIR specified by the image.
- args Sequence[str]
- Optional. Arguments passed to the entrypoint.
- command Sequence[str]
- Optional. If set, overrides the default ENTRYPOINT specified by the image.
- env Mapping[str, str]
- Optional. Environment variables passed to the container's entrypoint.
- image str
- Optional. A Docker container image that defines a custom environment. Cloud Workstations provides a number of preconfigured images, but you can create your own custom container images. If using a private image, the
host.gceInstance.serviceAccount
field must be specified in the workstation configuration. If using a custom container image, the service account must have Artifact Registry Reader permission to pull the specified image. Otherwise, the image must be publicly accessible. - run_
as_ intuser - Optional. If set, overrides the USER specified in the image with the given uid.
- working_
dir str - Optional. If set, overrides the default DIR specified by the image.
- args List<String>
- Optional. Arguments passed to the entrypoint.
- command List<String>
- Optional. If set, overrides the default ENTRYPOINT specified by the image.
- env Map<String>
- Optional. Environment variables passed to the container's entrypoint.
- image String
- Optional. A Docker container image that defines a custom environment. Cloud Workstations provides a number of preconfigured images, but you can create your own custom container images. If using a private image, the
host.gceInstance.serviceAccount
field must be specified in the workstation configuration. If using a custom container image, the service account must have Artifact Registry Reader permission to pull the specified image. Otherwise, the image must be publicly accessible. - run
As NumberUser - Optional. If set, overrides the USER specified in the image with the given uid.
- working
Dir String - Optional. If set, overrides the default DIR specified by the image.
CustomerEncryptionKeyResponse
- Kms
Key string - Immutable. The name of the Google Cloud KMS encryption key. For example,
"projects/PROJECT_ID/locations/REGION/keyRings/KEY_RING/cryptoKeys/KEY_NAME"
. The key must be in the same region as the workstation configuration. - Kms
Key stringService Account - Immutable. The service account to use with the specified KMS key. We recommend that you use a separate service account and follow KMS best practices. For more information, see Separation of duties and
gcloud kms keys add-iam-policy-binding
--member
.
- Kms
Key string - Immutable. The name of the Google Cloud KMS encryption key. For example,
"projects/PROJECT_ID/locations/REGION/keyRings/KEY_RING/cryptoKeys/KEY_NAME"
. The key must be in the same region as the workstation configuration. - Kms
Key stringService Account - Immutable. The service account to use with the specified KMS key. We recommend that you use a separate service account and follow KMS best practices. For more information, see Separation of duties and
gcloud kms keys add-iam-policy-binding
--member
.
- kms
Key String - Immutable. The name of the Google Cloud KMS encryption key. For example,
"projects/PROJECT_ID/locations/REGION/keyRings/KEY_RING/cryptoKeys/KEY_NAME"
. The key must be in the same region as the workstation configuration. - kms
Key StringService Account - Immutable. The service account to use with the specified KMS key. We recommend that you use a separate service account and follow KMS best practices. For more information, see Separation of duties and
gcloud kms keys add-iam-policy-binding
--member
.
- kms
Key string - Immutable. The name of the Google Cloud KMS encryption key. For example,
"projects/PROJECT_ID/locations/REGION/keyRings/KEY_RING/cryptoKeys/KEY_NAME"
. The key must be in the same region as the workstation configuration. - kms
Key stringService Account - Immutable. The service account to use with the specified KMS key. We recommend that you use a separate service account and follow KMS best practices. For more information, see Separation of duties and
gcloud kms keys add-iam-policy-binding
--member
.
- kms_
key str - Immutable. The name of the Google Cloud KMS encryption key. For example,
"projects/PROJECT_ID/locations/REGION/keyRings/KEY_RING/cryptoKeys/KEY_NAME"
. The key must be in the same region as the workstation configuration. - kms_
key_ strservice_ account - Immutable. The service account to use with the specified KMS key. We recommend that you use a separate service account and follow KMS best practices. For more information, see Separation of duties and
gcloud kms keys add-iam-policy-binding
--member
.
- kms
Key String - Immutable. The name of the Google Cloud KMS encryption key. For example,
"projects/PROJECT_ID/locations/REGION/keyRings/KEY_RING/cryptoKeys/KEY_NAME"
. The key must be in the same region as the workstation configuration. - kms
Key StringService Account - Immutable. The service account to use with the specified KMS key. We recommend that you use a separate service account and follow KMS best practices. For more information, see Separation of duties and
gcloud kms keys add-iam-policy-binding
--member
.
GceConfidentialInstanceConfigResponse
- Enable
Confidential boolCompute - Optional. Whether the instance has confidential compute enabled.
- Enable
Confidential boolCompute - Optional. Whether the instance has confidential compute enabled.
- enable
Confidential BooleanCompute - Optional. Whether the instance has confidential compute enabled.
- enable
Confidential booleanCompute - Optional. Whether the instance has confidential compute enabled.
- enable_
confidential_ boolcompute - Optional. Whether the instance has confidential compute enabled.
- enable
Confidential BooleanCompute - Optional. Whether the instance has confidential compute enabled.
GceInstanceResponse
- Boot
Disk intSize Gb - Optional. The size of the boot disk for the VM in gigabytes (GB). The minimum boot disk size is
30
GB. Defaults to50
GB. - Confidential
Instance Pulumi.Config Google Native. Workstations. V1. Inputs. Gce Confidential Instance Config Response - Optional. A set of Compute Engine Confidential VM instance options.
- Disable
Public boolIp Addresses - Optional. When set to true, disables public IP addresses for VMs. If you disable public IP addresses, you must set up Private Google Access or Cloud NAT on your network. If you use Private Google Access and you use
private.googleapis.com
orrestricted.googleapis.com
for Container Registry and Artifact Registry, make sure that you set up DNS records for domains*.gcr.io
and*.pkg.dev
. Defaults to false (VMs have public IP addresses). - Enable
Nested boolVirtualization - Optional. Whether to enable nested virtualization on Cloud Workstations VMs created under this workstation configuration. Nested virtualization lets you run virtual machine (VM) instances inside your workstation. Before enabling nested virtualization, consider the following important considerations. Cloud Workstations instances are subject to the same restrictions as Compute Engine instances: * Organization policy: projects, folders, or organizations may be restricted from creating nested VMs if the Disable VM nested virtualization constraint is enforced in the organization policy. For more information, see the Compute Engine section, Checking whether nested virtualization is allowed. * Performance: nested VMs might experience a 10% or greater decrease in performance for workloads that are CPU-bound and possibly greater than a 10% decrease for workloads that are input/output bound. * Machine Type: nested virtualization can only be enabled on workstation configurations that specify a machine_type in the N1 or N2 machine series. * GPUs: nested virtualization may not be enabled on workstation configurations with accelerators. * Operating System: Because Container-Optimized OS does not support nested virtualization, when nested virtualization is enabled, the underlying Compute Engine VM instances boot from an Ubuntu LTS image.
- Machine
Type string - Optional. The type of machine to use for VM instances—for example,
"e2-standard-4"
. For more information about machine types that Cloud Workstations supports, see the list of available machine types. - Pool
Size int - Optional. The number of VMs that the system should keep idle so that new workstations can be started quickly for new users. Defaults to
0
in the API. - Pooled
Instances int - Number of instances currently available in the pool for faster workstation startup.
- Service
Account string - Optional. The email address of the service account for Cloud Workstations VMs created with this configuration. When specified, be sure that the service account has
logginglogEntries.create
permission on the project so it can write logs out to Cloud Logging. If using a custom container image, the service account must have Artifact Registry Reader permission to pull the specified image. If you as the administrator want to be able tossh
into the underlying VM, you need to set this value to a service account for which you have theiam.serviceAccounts.actAs
permission. Conversely, if you don't want anyone to be able tossh
into the underlying VM, use a service account where no one has that permission. If not set, VMs run with a service account provided by the Cloud Workstations service, and the image must be publicly accessible. - Service
Account List<string>Scopes - Optional. Scopes to grant to the service_account. Various scopes are automatically added based on feature usage. When specified, users of workstations under this configuration must have
iam.serviceAccounts.actAs
on the service account. - Shielded
Instance Pulumi.Config Google Native. Workstations. V1. Inputs. Gce Shielded Instance Config Response - Optional. A set of Compute Engine Shielded instance options.
- List<string>
- Optional. Network tags to add to the Compute Engine VMs backing the workstations. This option applies network tags to VMs created with this configuration. These network tags enable the creation of firewall rules.
- Boot
Disk intSize Gb - Optional. The size of the boot disk for the VM in gigabytes (GB). The minimum boot disk size is
30
GB. Defaults to50
GB. - Confidential
Instance GceConfig Confidential Instance Config Response - Optional. A set of Compute Engine Confidential VM instance options.
- Disable
Public boolIp Addresses - Optional. When set to true, disables public IP addresses for VMs. If you disable public IP addresses, you must set up Private Google Access or Cloud NAT on your network. If you use Private Google Access and you use
private.googleapis.com
orrestricted.googleapis.com
for Container Registry and Artifact Registry, make sure that you set up DNS records for domains*.gcr.io
and*.pkg.dev
. Defaults to false (VMs have public IP addresses). - Enable
Nested boolVirtualization - Optional. Whether to enable nested virtualization on Cloud Workstations VMs created under this workstation configuration. Nested virtualization lets you run virtual machine (VM) instances inside your workstation. Before enabling nested virtualization, consider the following important considerations. Cloud Workstations instances are subject to the same restrictions as Compute Engine instances: * Organization policy: projects, folders, or organizations may be restricted from creating nested VMs if the Disable VM nested virtualization constraint is enforced in the organization policy. For more information, see the Compute Engine section, Checking whether nested virtualization is allowed. * Performance: nested VMs might experience a 10% or greater decrease in performance for workloads that are CPU-bound and possibly greater than a 10% decrease for workloads that are input/output bound. * Machine Type: nested virtualization can only be enabled on workstation configurations that specify a machine_type in the N1 or N2 machine series. * GPUs: nested virtualization may not be enabled on workstation configurations with accelerators. * Operating System: Because Container-Optimized OS does not support nested virtualization, when nested virtualization is enabled, the underlying Compute Engine VM instances boot from an Ubuntu LTS image.
- Machine
Type string - Optional. The type of machine to use for VM instances—for example,
"e2-standard-4"
. For more information about machine types that Cloud Workstations supports, see the list of available machine types. - Pool
Size int - Optional. The number of VMs that the system should keep idle so that new workstations can be started quickly for new users. Defaults to
0
in the API. - Pooled
Instances int - Number of instances currently available in the pool for faster workstation startup.
- Service
Account string - Optional. The email address of the service account for Cloud Workstations VMs created with this configuration. When specified, be sure that the service account has
logginglogEntries.create
permission on the project so it can write logs out to Cloud Logging. If using a custom container image, the service account must have Artifact Registry Reader permission to pull the specified image. If you as the administrator want to be able tossh
into the underlying VM, you need to set this value to a service account for which you have theiam.serviceAccounts.actAs
permission. Conversely, if you don't want anyone to be able tossh
into the underlying VM, use a service account where no one has that permission. If not set, VMs run with a service account provided by the Cloud Workstations service, and the image must be publicly accessible. - Service
Account []stringScopes - Optional. Scopes to grant to the service_account. Various scopes are automatically added based on feature usage. When specified, users of workstations under this configuration must have
iam.serviceAccounts.actAs
on the service account. - Shielded
Instance GceConfig Shielded Instance Config Response - Optional. A set of Compute Engine Shielded instance options.
- []string
- Optional. Network tags to add to the Compute Engine VMs backing the workstations. This option applies network tags to VMs created with this configuration. These network tags enable the creation of firewall rules.
- boot
Disk IntegerSize Gb - Optional. The size of the boot disk for the VM in gigabytes (GB). The minimum boot disk size is
30
GB. Defaults to50
GB. - confidential
Instance GceConfig Confidential Instance Config Response - Optional. A set of Compute Engine Confidential VM instance options.
- disable
Public BooleanIp Addresses - Optional. When set to true, disables public IP addresses for VMs. If you disable public IP addresses, you must set up Private Google Access or Cloud NAT on your network. If you use Private Google Access and you use
private.googleapis.com
orrestricted.googleapis.com
for Container Registry and Artifact Registry, make sure that you set up DNS records for domains*.gcr.io
and*.pkg.dev
. Defaults to false (VMs have public IP addresses). - enable
Nested BooleanVirtualization - Optional. Whether to enable nested virtualization on Cloud Workstations VMs created under this workstation configuration. Nested virtualization lets you run virtual machine (VM) instances inside your workstation. Before enabling nested virtualization, consider the following important considerations. Cloud Workstations instances are subject to the same restrictions as Compute Engine instances: * Organization policy: projects, folders, or organizations may be restricted from creating nested VMs if the Disable VM nested virtualization constraint is enforced in the organization policy. For more information, see the Compute Engine section, Checking whether nested virtualization is allowed. * Performance: nested VMs might experience a 10% or greater decrease in performance for workloads that are CPU-bound and possibly greater than a 10% decrease for workloads that are input/output bound. * Machine Type: nested virtualization can only be enabled on workstation configurations that specify a machine_type in the N1 or N2 machine series. * GPUs: nested virtualization may not be enabled on workstation configurations with accelerators. * Operating System: Because Container-Optimized OS does not support nested virtualization, when nested virtualization is enabled, the underlying Compute Engine VM instances boot from an Ubuntu LTS image.
- machine
Type String - Optional. The type of machine to use for VM instances—for example,
"e2-standard-4"
. For more information about machine types that Cloud Workstations supports, see the list of available machine types. - pool
Size Integer - Optional. The number of VMs that the system should keep idle so that new workstations can be started quickly for new users. Defaults to
0
in the API. - pooled
Instances Integer - Number of instances currently available in the pool for faster workstation startup.
- service
Account String - Optional. The email address of the service account for Cloud Workstations VMs created with this configuration. When specified, be sure that the service account has
logginglogEntries.create
permission on the project so it can write logs out to Cloud Logging. If using a custom container image, the service account must have Artifact Registry Reader permission to pull the specified image. If you as the administrator want to be able tossh
into the underlying VM, you need to set this value to a service account for which you have theiam.serviceAccounts.actAs
permission. Conversely, if you don't want anyone to be able tossh
into the underlying VM, use a service account where no one has that permission. If not set, VMs run with a service account provided by the Cloud Workstations service, and the image must be publicly accessible. - service
Account List<String>Scopes - Optional. Scopes to grant to the service_account. Various scopes are automatically added based on feature usage. When specified, users of workstations under this configuration must have
iam.serviceAccounts.actAs
on the service account. - shielded
Instance GceConfig Shielded Instance Config Response - Optional. A set of Compute Engine Shielded instance options.
- List<String>
- Optional. Network tags to add to the Compute Engine VMs backing the workstations. This option applies network tags to VMs created with this configuration. These network tags enable the creation of firewall rules.
- boot
Disk numberSize Gb - Optional. The size of the boot disk for the VM in gigabytes (GB). The minimum boot disk size is
30
GB. Defaults to50
GB. - confidential
Instance GceConfig Confidential Instance Config Response - Optional. A set of Compute Engine Confidential VM instance options.
- disable
Public booleanIp Addresses - Optional. When set to true, disables public IP addresses for VMs. If you disable public IP addresses, you must set up Private Google Access or Cloud NAT on your network. If you use Private Google Access and you use
private.googleapis.com
orrestricted.googleapis.com
for Container Registry and Artifact Registry, make sure that you set up DNS records for domains*.gcr.io
and*.pkg.dev
. Defaults to false (VMs have public IP addresses). - enable
Nested booleanVirtualization - Optional. Whether to enable nested virtualization on Cloud Workstations VMs created under this workstation configuration. Nested virtualization lets you run virtual machine (VM) instances inside your workstation. Before enabling nested virtualization, consider the following important considerations. Cloud Workstations instances are subject to the same restrictions as Compute Engine instances: * Organization policy: projects, folders, or organizations may be restricted from creating nested VMs if the Disable VM nested virtualization constraint is enforced in the organization policy. For more information, see the Compute Engine section, Checking whether nested virtualization is allowed. * Performance: nested VMs might experience a 10% or greater decrease in performance for workloads that are CPU-bound and possibly greater than a 10% decrease for workloads that are input/output bound. * Machine Type: nested virtualization can only be enabled on workstation configurations that specify a machine_type in the N1 or N2 machine series. * GPUs: nested virtualization may not be enabled on workstation configurations with accelerators. * Operating System: Because Container-Optimized OS does not support nested virtualization, when nested virtualization is enabled, the underlying Compute Engine VM instances boot from an Ubuntu LTS image.
- machine
Type string - Optional. The type of machine to use for VM instances—for example,
"e2-standard-4"
. For more information about machine types that Cloud Workstations supports, see the list of available machine types. - pool
Size number - Optional. The number of VMs that the system should keep idle so that new workstations can be started quickly for new users. Defaults to
0
in the API. - pooled
Instances number - Number of instances currently available in the pool for faster workstation startup.
- service
Account string - Optional. The email address of the service account for Cloud Workstations VMs created with this configuration. When specified, be sure that the service account has
logginglogEntries.create
permission on the project so it can write logs out to Cloud Logging. If using a custom container image, the service account must have Artifact Registry Reader permission to pull the specified image. If you as the administrator want to be able tossh
into the underlying VM, you need to set this value to a service account for which you have theiam.serviceAccounts.actAs
permission. Conversely, if you don't want anyone to be able tossh
into the underlying VM, use a service account where no one has that permission. If not set, VMs run with a service account provided by the Cloud Workstations service, and the image must be publicly accessible. - service
Account string[]Scopes - Optional. Scopes to grant to the service_account. Various scopes are automatically added based on feature usage. When specified, users of workstations under this configuration must have
iam.serviceAccounts.actAs
on the service account. - shielded
Instance GceConfig Shielded Instance Config Response - Optional. A set of Compute Engine Shielded instance options.
- string[]
- Optional. Network tags to add to the Compute Engine VMs backing the workstations. This option applies network tags to VMs created with this configuration. These network tags enable the creation of firewall rules.
- boot_
disk_ intsize_ gb - Optional. The size of the boot disk for the VM in gigabytes (GB). The minimum boot disk size is
30
GB. Defaults to50
GB. - confidential_
instance_ Gceconfig Confidential Instance Config Response - Optional. A set of Compute Engine Confidential VM instance options.
- disable_
public_ boolip_ addresses - Optional. When set to true, disables public IP addresses for VMs. If you disable public IP addresses, you must set up Private Google Access or Cloud NAT on your network. If you use Private Google Access and you use
private.googleapis.com
orrestricted.googleapis.com
for Container Registry and Artifact Registry, make sure that you set up DNS records for domains*.gcr.io
and*.pkg.dev
. Defaults to false (VMs have public IP addresses). - enable_
nested_ boolvirtualization - Optional. Whether to enable nested virtualization on Cloud Workstations VMs created under this workstation configuration. Nested virtualization lets you run virtual machine (VM) instances inside your workstation. Before enabling nested virtualization, consider the following important considerations. Cloud Workstations instances are subject to the same restrictions as Compute Engine instances: * Organization policy: projects, folders, or organizations may be restricted from creating nested VMs if the Disable VM nested virtualization constraint is enforced in the organization policy. For more information, see the Compute Engine section, Checking whether nested virtualization is allowed. * Performance: nested VMs might experience a 10% or greater decrease in performance for workloads that are CPU-bound and possibly greater than a 10% decrease for workloads that are input/output bound. * Machine Type: nested virtualization can only be enabled on workstation configurations that specify a machine_type in the N1 or N2 machine series. * GPUs: nested virtualization may not be enabled on workstation configurations with accelerators. * Operating System: Because Container-Optimized OS does not support nested virtualization, when nested virtualization is enabled, the underlying Compute Engine VM instances boot from an Ubuntu LTS image.
- machine_
type str - Optional. The type of machine to use for VM instances—for example,
"e2-standard-4"
. For more information about machine types that Cloud Workstations supports, see the list of available machine types. - pool_
size int - Optional. The number of VMs that the system should keep idle so that new workstations can be started quickly for new users. Defaults to
0
in the API. - pooled_
instances int - Number of instances currently available in the pool for faster workstation startup.
- service_
account str - Optional. The email address of the service account for Cloud Workstations VMs created with this configuration. When specified, be sure that the service account has
logginglogEntries.create
permission on the project so it can write logs out to Cloud Logging. If using a custom container image, the service account must have Artifact Registry Reader permission to pull the specified image. If you as the administrator want to be able tossh
into the underlying VM, you need to set this value to a service account for which you have theiam.serviceAccounts.actAs
permission. Conversely, if you don't want anyone to be able tossh
into the underlying VM, use a service account where no one has that permission. If not set, VMs run with a service account provided by the Cloud Workstations service, and the image must be publicly accessible. - service_
account_ Sequence[str]scopes - Optional. Scopes to grant to the service_account. Various scopes are automatically added based on feature usage. When specified, users of workstations under this configuration must have
iam.serviceAccounts.actAs
on the service account. - shielded_
instance_ Gceconfig Shielded Instance Config Response - Optional. A set of Compute Engine Shielded instance options.
- Sequence[str]
- Optional. Network tags to add to the Compute Engine VMs backing the workstations. This option applies network tags to VMs created with this configuration. These network tags enable the creation of firewall rules.
- boot
Disk NumberSize Gb - Optional. The size of the boot disk for the VM in gigabytes (GB). The minimum boot disk size is
30
GB. Defaults to50
GB. - confidential
Instance Property MapConfig - Optional. A set of Compute Engine Confidential VM instance options.
- disable
Public BooleanIp Addresses - Optional. When set to true, disables public IP addresses for VMs. If you disable public IP addresses, you must set up Private Google Access or Cloud NAT on your network. If you use Private Google Access and you use
private.googleapis.com
orrestricted.googleapis.com
for Container Registry and Artifact Registry, make sure that you set up DNS records for domains*.gcr.io
and*.pkg.dev
. Defaults to false (VMs have public IP addresses). - enable
Nested BooleanVirtualization - Optional. Whether to enable nested virtualization on Cloud Workstations VMs created under this workstation configuration. Nested virtualization lets you run virtual machine (VM) instances inside your workstation. Before enabling nested virtualization, consider the following important considerations. Cloud Workstations instances are subject to the same restrictions as Compute Engine instances: * Organization policy: projects, folders, or organizations may be restricted from creating nested VMs if the Disable VM nested virtualization constraint is enforced in the organization policy. For more information, see the Compute Engine section, Checking whether nested virtualization is allowed. * Performance: nested VMs might experience a 10% or greater decrease in performance for workloads that are CPU-bound and possibly greater than a 10% decrease for workloads that are input/output bound. * Machine Type: nested virtualization can only be enabled on workstation configurations that specify a machine_type in the N1 or N2 machine series. * GPUs: nested virtualization may not be enabled on workstation configurations with accelerators. * Operating System: Because Container-Optimized OS does not support nested virtualization, when nested virtualization is enabled, the underlying Compute Engine VM instances boot from an Ubuntu LTS image.
- machine
Type String - Optional. The type of machine to use for VM instances—for example,
"e2-standard-4"
. For more information about machine types that Cloud Workstations supports, see the list of available machine types. - pool
Size Number - Optional. The number of VMs that the system should keep idle so that new workstations can be started quickly for new users. Defaults to
0
in the API. - pooled
Instances Number - Number of instances currently available in the pool for faster workstation startup.
- service
Account String - Optional. The email address of the service account for Cloud Workstations VMs created with this configuration. When specified, be sure that the service account has
logginglogEntries.create
permission on the project so it can write logs out to Cloud Logging. If using a custom container image, the service account must have Artifact Registry Reader permission to pull the specified image. If you as the administrator want to be able tossh
into the underlying VM, you need to set this value to a service account for which you have theiam.serviceAccounts.actAs
permission. Conversely, if you don't want anyone to be able tossh
into the underlying VM, use a service account where no one has that permission. If not set, VMs run with a service account provided by the Cloud Workstations service, and the image must be publicly accessible. - service
Account List<String>Scopes - Optional. Scopes to grant to the service_account. Various scopes are automatically added based on feature usage. When specified, users of workstations under this configuration must have
iam.serviceAccounts.actAs
on the service account. - shielded
Instance Property MapConfig - Optional. A set of Compute Engine Shielded instance options.
- List<String>
- Optional. Network tags to add to the Compute Engine VMs backing the workstations. This option applies network tags to VMs created with this configuration. These network tags enable the creation of firewall rules.
GceRegionalPersistentDiskResponse
- Disk
Type string - Optional. The type of the persistent disk for the home directory. Defaults to
"pd-standard"
. - Fs
Type string - Optional. Type of file system that the disk should be formatted with. The workstation image must support this file system type. Must be empty if source_snapshot is set. Defaults to
"ext4"
. - Reclaim
Policy string - Optional. Whether the persistent disk should be deleted when the workstation is deleted. Valid values are
DELETE
andRETAIN
. Defaults toDELETE
. - Size
Gb int - Optional. The GB capacity of a persistent home directory for each workstation created with this configuration. Must be empty if source_snapshot is set. Valid values are
10
,50
,100
,200
,500
, or1000
. Defaults to200
. If less than200
GB, the disk_type must be"pd-balanced"
or"pd-ssd"
. - Source
Snapshot string - Optional. Name of the snapshot to use as the source for the disk. If set, size_gb and fs_type must be empty.
- Disk
Type string - Optional. The type of the persistent disk for the home directory. Defaults to
"pd-standard"
. - Fs
Type string - Optional. Type of file system that the disk should be formatted with. The workstation image must support this file system type. Must be empty if source_snapshot is set. Defaults to
"ext4"
. - Reclaim
Policy string - Optional. Whether the persistent disk should be deleted when the workstation is deleted. Valid values are
DELETE
andRETAIN
. Defaults toDELETE
. - Size
Gb int - Optional. The GB capacity of a persistent home directory for each workstation created with this configuration. Must be empty if source_snapshot is set. Valid values are
10
,50
,100
,200
,500
, or1000
. Defaults to200
. If less than200
GB, the disk_type must be"pd-balanced"
or"pd-ssd"
. - Source
Snapshot string - Optional. Name of the snapshot to use as the source for the disk. If set, size_gb and fs_type must be empty.
- disk
Type String - Optional. The type of the persistent disk for the home directory. Defaults to
"pd-standard"
. - fs
Type String - Optional. Type of file system that the disk should be formatted with. The workstation image must support this file system type. Must be empty if source_snapshot is set. Defaults to
"ext4"
. - reclaim
Policy String - Optional. Whether the persistent disk should be deleted when the workstation is deleted. Valid values are
DELETE
andRETAIN
. Defaults toDELETE
. - size
Gb Integer - Optional. The GB capacity of a persistent home directory for each workstation created with this configuration. Must be empty if source_snapshot is set. Valid values are
10
,50
,100
,200
,500
, or1000
. Defaults to200
. If less than200
GB, the disk_type must be"pd-balanced"
or"pd-ssd"
. - source
Snapshot String - Optional. Name of the snapshot to use as the source for the disk. If set, size_gb and fs_type must be empty.
- disk
Type string - Optional. The type of the persistent disk for the home directory. Defaults to
"pd-standard"
. - fs
Type string - Optional. Type of file system that the disk should be formatted with. The workstation image must support this file system type. Must be empty if source_snapshot is set. Defaults to
"ext4"
. - reclaim
Policy string - Optional. Whether the persistent disk should be deleted when the workstation is deleted. Valid values are
DELETE
andRETAIN
. Defaults toDELETE
. - size
Gb number - Optional. The GB capacity of a persistent home directory for each workstation created with this configuration. Must be empty if source_snapshot is set. Valid values are
10
,50
,100
,200
,500
, or1000
. Defaults to200
. If less than200
GB, the disk_type must be"pd-balanced"
or"pd-ssd"
. - source
Snapshot string - Optional. Name of the snapshot to use as the source for the disk. If set, size_gb and fs_type must be empty.
- disk_
type str - Optional. The type of the persistent disk for the home directory. Defaults to
"pd-standard"
. - fs_
type str - Optional. Type of file system that the disk should be formatted with. The workstation image must support this file system type. Must be empty if source_snapshot is set. Defaults to
"ext4"
. - reclaim_
policy str - Optional. Whether the persistent disk should be deleted when the workstation is deleted. Valid values are
DELETE
andRETAIN
. Defaults toDELETE
. - size_
gb int - Optional. The GB capacity of a persistent home directory for each workstation created with this configuration. Must be empty if source_snapshot is set. Valid values are
10
,50
,100
,200
,500
, or1000
. Defaults to200
. If less than200
GB, the disk_type must be"pd-balanced"
or"pd-ssd"
. - source_
snapshot str - Optional. Name of the snapshot to use as the source for the disk. If set, size_gb and fs_type must be empty.
- disk
Type String - Optional. The type of the persistent disk for the home directory. Defaults to
"pd-standard"
. - fs
Type String - Optional. Type of file system that the disk should be formatted with. The workstation image must support this file system type. Must be empty if source_snapshot is set. Defaults to
"ext4"
. - reclaim
Policy String - Optional. Whether the persistent disk should be deleted when the workstation is deleted. Valid values are
DELETE
andRETAIN
. Defaults toDELETE
. - size
Gb Number - Optional. The GB capacity of a persistent home directory for each workstation created with this configuration. Must be empty if source_snapshot is set. Valid values are
10
,50
,100
,200
,500
, or1000
. Defaults to200
. If less than200
GB, the disk_type must be"pd-balanced"
or"pd-ssd"
. - source
Snapshot String - Optional. Name of the snapshot to use as the source for the disk. If set, size_gb and fs_type must be empty.
GceShieldedInstanceConfigResponse
- Enable
Integrity boolMonitoring - Optional. Whether the instance has integrity monitoring enabled.
- Enable
Secure boolBoot - Optional. Whether the instance has Secure Boot enabled.
- Enable
Vtpm bool - Optional. Whether the instance has the vTPM enabled.
- Enable
Integrity boolMonitoring - Optional. Whether the instance has integrity monitoring enabled.
- Enable
Secure boolBoot - Optional. Whether the instance has Secure Boot enabled.
- Enable
Vtpm bool - Optional. Whether the instance has the vTPM enabled.
- enable
Integrity BooleanMonitoring - Optional. Whether the instance has integrity monitoring enabled.
- enable
Secure BooleanBoot - Optional. Whether the instance has Secure Boot enabled.
- enable
Vtpm Boolean - Optional. Whether the instance has the vTPM enabled.
- enable
Integrity booleanMonitoring - Optional. Whether the instance has integrity monitoring enabled.
- enable
Secure booleanBoot - Optional. Whether the instance has Secure Boot enabled.
- enable
Vtpm boolean - Optional. Whether the instance has the vTPM enabled.
- enable_
integrity_ boolmonitoring - Optional. Whether the instance has integrity monitoring enabled.
- enable_
secure_ boolboot - Optional. Whether the instance has Secure Boot enabled.
- enable_
vtpm bool - Optional. Whether the instance has the vTPM enabled.
- enable
Integrity BooleanMonitoring - Optional. Whether the instance has integrity monitoring enabled.
- enable
Secure BooleanBoot - Optional. Whether the instance has Secure Boot enabled.
- enable
Vtpm Boolean - Optional. Whether the instance has the vTPM enabled.
HostResponse
- Gce
Instance Pulumi.Google Native. Workstations. V1. Inputs. Gce Instance Response - Specifies a Compute Engine instance as the host.
- Gce
Instance GceInstance Response - Specifies a Compute Engine instance as the host.
- gce
Instance GceInstance Response - Specifies a Compute Engine instance as the host.
- gce
Instance GceInstance Response - Specifies a Compute Engine instance as the host.
- gce_
instance GceInstance Response - Specifies a Compute Engine instance as the host.
- gce
Instance Property Map - Specifies a Compute Engine instance as the host.
PersistentDirectoryResponse
- Gce
Pd Pulumi.Google Native. Workstations. V1. Inputs. Gce Regional Persistent Disk Response - A PersistentDirectory backed by a Compute Engine persistent disk.
- Mount
Path string - Optional. Location of this directory in the running workstation.
- Gce
Pd GceRegional Persistent Disk Response - A PersistentDirectory backed by a Compute Engine persistent disk.
- Mount
Path string - Optional. Location of this directory in the running workstation.
- gce
Pd GceRegional Persistent Disk Response - A PersistentDirectory backed by a Compute Engine persistent disk.
- mount
Path String - Optional. Location of this directory in the running workstation.
- gce
Pd GceRegional Persistent Disk Response - A PersistentDirectory backed by a Compute Engine persistent disk.
- mount
Path string - Optional. Location of this directory in the running workstation.
- gce_
pd GceRegional Persistent Disk Response - A PersistentDirectory backed by a Compute Engine persistent disk.
- mount_
path str - Optional. Location of this directory in the running workstation.
- gce
Pd Property Map - A PersistentDirectory backed by a Compute Engine persistent disk.
- mount
Path String - Optional. Location of this directory in the running workstation.
ReadinessCheckResponse
StatusResponse
- Code int
- The status code, which should be an enum value of google.rpc.Code.
- Details
List<Immutable
Dictionary<string, string>> - A list of messages that carry the error details. There is a common set of message types for APIs to use.
- Message string
- A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client.
- Code int
- The status code, which should be an enum value of google.rpc.Code.
- Details []map[string]string
- A list of messages that carry the error details. There is a common set of message types for APIs to use.
- Message string
- A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client.
- code Integer
- The status code, which should be an enum value of google.rpc.Code.
- details List<Map<String,String>>
- A list of messages that carry the error details. There is a common set of message types for APIs to use.
- message String
- A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client.
- code number
- The status code, which should be an enum value of google.rpc.Code.
- details {[key: string]: string}[]
- A list of messages that carry the error details. There is a common set of message types for APIs to use.
- message string
- A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client.
- code int
- The status code, which should be an enum value of google.rpc.Code.
- details Sequence[Mapping[str, str]]
- A list of messages that carry the error details. There is a common set of message types for APIs to use.
- message str
- A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client.
- code Number
- The status code, which should be an enum value of google.rpc.Code.
- details List<Map<String>>
- A list of messages that carry the error details. There is a common set of message types for APIs to use.
- message String
- A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client.
Package Details
- Repository
- Google Cloud Native pulumi/pulumi-google-native
- License
- Apache-2.0
Google Cloud Native is in preview. Google Cloud Classic is fully supported.
Google Cloud Native v0.32.0 published on Wednesday, Nov 29, 2023 by Pulumi