File: //lib/google-cloud-sdk/lib/surface/compute/instances/__pycache__/suspend.cpython-312.pyc
�
��, � �r � d Z ddlmZ ddlmZ ddlmZ ddlZddlmZ ddlm Z ddl
m Z dd l m
Z
dd
lmZ dd lmZ dd lmZ d
ddd�Z e
j( e
j* j, e
j* j. e
j* j0 � G d� de
j2 � � Zee_ y)z#Command for suspending an instance.� )�absolute_import)�division)�unicode_literalsN)� base_classes)�poller)�waiter)�base)�flags)�
exceptions)�logz#Suspend a virtual machine instance.a *{command}* is used to suspend a Compute Engine virtual machine.
Suspending a VM is the equivalent of sleep or standby mode: the guest
receives an ACPI S3 suspend signal, after which all VM state is saved to
temporary storage. An instance can only be suspended while it is in the
RUNNING state. A suspended instance will be put in SUSPENDED state.
Note: A suspended instance can be resumed by running the gcloud compute
instances resume command.
If a VM has any attached Local SSD disks, you can preserve the Local SSD
data when you suspend the VM by setting `--discard-local-ssd=False`.
Preserving the Local SSD disk data incurs costs and is subject to
limitations.
Limitations:
- Limitations for suspending a VM: https://cloud.google.com/compute/docs/instances/suspend-resume-instance#limitations
- Limitations for preserving Local SSD data: https://cloud.google.com/compute/docs/disks/local-ssd#stop_instance
a@ To suspend an instance named ``test-instance'', run:
$ {command} test-instance
To suspend an instance named `test-instance` that has a Local SSD, run:
$ {command} test-instance --discard-local-ssd=True
Using `--discard-local-ssd` without a value defaults to `True`.
)�brief� DESCRIPTION�EXAMPLESc �, � e Zd ZdZed� � Zd� Zd� Zy)�Suspenda� Suspend a virtual machine instance.
*{command}* is used to suspend a Compute Engine virtual machine.
Suspending a VM is the equivalent of sleep or standby mode:
the guest receives an ACPI S3 suspend signal, after which all VM state
is saved to temporary storage. An instance can only be suspended while
it is in the RUNNING state. A suspended instance will be put in
SUSPENDED state.
Note: A suspended instance can be resumed by running the
`gcloud compute instances resume` command.
Limitations: See this feature's restrictions at
https://cloud.google.com/compute/docs/instances/suspend-resume-instance#limitations
c � � t j j |� |j ddd dd� d�� t j
j
|� y )Nz--discard-local-ssd�?Tc �d � t j | j � j � � S �N)�ast� literal_eval�lower�
capitalize)�xs �(lib/surface/compute/instances/suspend.py�<lambda>z Suspend.Args.<locals>.<lambda>c s � �s�'�'���� �(<�(<�(>�?� z,If set to true, local SSD data is discarded.)�nargs�default�const�type�help)r
�
INSTANCES_ARG� AddArgument� add_argumentr �
ASYNC_FLAG� AddToParser)�cls�parsers r �Argsz Suspend.ArgsY sR � � ���#�#�F�+�
��� ���� @�<� � ?� �O�O� � ��'r c � � |j j ||j � |j |j �� S )N)�discardLocalSsd�instance�project�zone)�messages� ComputeInstancesSuspendRequest�Namer. r/ )�self�client� instance_ref�discard_local_ssds r �_CreateSuspendRequestz Suspend._CreateSuspendRequestg s? � � �?�?� 9� 9�)� �"�"�$� �$�$�
�
�
� :� � r c
� � t j | j � � }|j }t j
j
||j t j |� �� }g }|D ]E }|j |j j d| j |||j � f� �G g }|j ||� }|rt j |� �|D � cg c]' } |j j# | j$ � ��) }
} |j& rd|
D ]> } t( j* j- dj/ | j1 � � � �@ t( j* j- d� |S t3 j4 ||j j |� } t7 j8 | t3 j: |
� dj/ dj= d� |D � � � d �� }
|D ]0 }t( j* j- d j/ |� � �2 |
S c c} w )
N)� scope_listerr z&Suspend instance in progress for [{}].z]Use [gcloud compute operations describe URI] command to check the status of the operation(s).zSuspending instance(s) {0}z, c 3 �< K � | ] }|j � �� � y �wr )r2 )�.0�is r � <genexpr>z Suspend.Run.<locals>.<genexpr>� s � �� � 6-� +��A�F�F�H�m�s � )� max_wait_mszUpdated [{0}].) r �ComputeApiHolder� ReleaseTrackr4 r
r# �ResolveAsResource� resources�GetInstanceZoneScopeLister�append�apitools_client� instancesr7 r6 �
AsyncRequestsr �
MultiError�Parse�selfLink�async_r �status�Print�format�SelfLinkr � BatchPollerr �WaitFor�OperationBatch�join)r3 �args�holderr4 �
instance_refs�requestsr5 �errors_to_collect� responses�r�operation_refs�
operation_ref�operation_poller�results r �Runz Suspend.Runn s � �
�
*�
*�4�+<�+<�+>�
?�F�
�]�]�F��'�'�9�9� �����5�5�f�=� :� ?�M�
�H�%� ��o�o�v�-�-�7�7���1�1�&�,�26�2H�2H�J�K� L� &�
���$�$�X�/@�A�I�� � !� !�"3� 4�4�BK�L�)�Q�f�&�&�,�,�Q�Z�Z�8�)�N�L� �{�{�)�-� �
�
���A�H�H� � "� "� $�&� '� *�
�j�j��� (�)� �� �)�)�&�*0�*@�*@�*J�*J�*7�9�� �^�^��� � �n�-�$�+�+�D�I�I� 6-� +�6-� --� .�� �F� &� � �j�j���'�.�.�|�<�=� &� �M��3 Ms �*,H;N)�__name__�
__module__� __qualname__�__doc__� classmethodr* r7 r_ � r r r r F s% � �� � (� � (� �-r r ) rc �
__future__r r r r � googlecloudsdk.api_lib.computer �)googlecloudsdk.api_lib.compute.operationsr �googlecloudsdk.api_lib.utilr �googlecloudsdk.callioper �,googlecloudsdk.command_lib.compute.instancesr
�googlecloudsdk.corer r �
DETAILED_HELP�
ReleaseTracksr@ �ALPHA�BETA�GA�
SilentCommandr �
detailed_helpre r r �<module>rt s� �� *� &� � '�
� 7� <� .� (� >� *� #� .� �*
�3$�
�N ����D�%�%�+�+�T�->�->�-C�-C��%�%�(�(�*�S�d� � � S�*�S�l &�� r