OCI Compute Instance Actions

6 min

Resumo

Executar ações em um recurso de instância no Oracle Cloud Infrastructure
Para action=change_compartment , move uma instância para um compartimento diferente dentro da mesma locação.
Quando você move uma instância para um compartimento diferente, os recursos associados, como volumes de inicialização e VNICs, não são movidos.
Para action=instance_action , executa uma das seguintes ações de energia na instância especificada:
- START - Liga a instância.
- RESET - Desliga a instância e depois a liga novamente.
- SOFTSTOP - Desliga a instância normalmente enviando um comando shutdown para o sistema operacional. Após esperar 15 minutos para o SO desligar, a instância é desligada. Se os aplicativos que são executados na instância levarem mais de 15 minutos para desligar, eles podem ser interrompidos incorretamente, resultando em corrupção de dados. Para evitar isso, desligue manualmente a instância usando os comandos disponíveis no SO antes de fazer o softstop da instância.
- SOFTRESET - Reinicializa graciosamente a instância enviando um comando shutdown para o sistema operacional. Após esperar 15 minutos para o SO desligar, a instância é desligada e ligada novamente.
- SENDDIAGNOSTICINTERRUPT - Para usuários avançados. Cuidado: Enviar uma interrupção de diagnóstico para um sistema ativo pode causar corrupção de dados ou falha do sistema. Envia uma interrupção de diagnóstico que faz com que o SO da instância trave e depois reinicie. Antes de enviar uma interrupção de diagnóstico, você deve configurar a instância para gerar um arquivo de despejo de falha quando ela travar. O despejo de falha captura informações sobre o estado do SO no momento da falha. Após a reinicialização do SO, você pode analisar o despejo de falha para diagnosticar o problema.
- DIAGNOSTICREBOOT - Desliga a instância, reconstrói-a e, em seguida, liga-a novamente. Antes de enviar uma reinicialização de diagnóstico, reinicie o SO da instância, confirme se as configurações de instância e rede estão configuradas corretamente e tente outras etapas de solução de problemas . Use a reinicialização de diagnóstico como uma tentativa final de solucionar problemas de uma instância inacessível.
- REBOOTMIGRATE - Desliga a instância, move-a para um novo hardware e, em seguida, liga-a novamente.

Requisitos

Os requisitos abaixo são necessários no host que executa este módulo.

Python SDK para Oracle Cloud Infrastructure https://oracle-cloud-infrastructure-python-sdk.readthedocs.io

Parâmetros

Parâmetro	Tipo	Escolhas	Descrição
action	string	change_compartment, stop, start, softreset, reset, softstop, senddiagnosticinterrupt,	Ação a ser executada na instância.
		diagnosticreboot, rebootmigrate
action_type	string	reset, rebootMigrate, softreset	O tipo de ação de energia a ser executada.
			Obrigatório para action=instance_action.
allow_dense_reboot_migration	boolean	no, yes	Para instâncias que usam um formato DenseIO, o sinalizador que indica se a migração de reinicialização é executada para a instância. O valor padrão é false.
api_user	string		O OCID do usuário, em nome do qual, as APIs OCI são invocadas.
api_user_fingerprint	string		Impressão digital para o par de chaves sendo usado.
api_user_key_file	string		Caminho completo e nome do arquivo da chave privada (em formato PEM).
api_user_key_pass_phrase	string		Senha usada pela chave referenciada em api_user_key_file, se estiver criptografada.
auth_purpose	string	service_principal	O propósito de autenticação que pode ser usado em conjunto com 'auth_type=instance_principal'. O auth_purpose padrão para instance_principal é None.
auth_type	string	api_key, instance_principal, instance_obo_user, resource_principal	O tipo de autenticação a ser usado para fazer solicitações de API. Por padrão, a autenticação baseada em auth_type="api_key" é executada e a chave de API (consulte api_user_key_file) em seu arquivo de configuração será usada.
cert_bundle	string		O caminho completo para um pacote de certificados CA a ser usado para verificação SSL. Isso substituirá o pacote de certificados CA padrão.
compartment_id	string		O OCID do compartimento para o qual mover a instância.
			Obrigatório para action=change_compartment.
config_file_location	string		Caminho para o arquivo de configuração.
config_profile_name	string		O perfil a ser carregado do arquivo de configuração referenciado por config_file_location.
delete_local_storage	boolean	no, yes	Para instâncias bare metal que possuem armazenamento local, isso deve ser definido como true para verificar se o armazenamento local será excluído durante a migração. Para instâncias sem, este parâmetro não tem efeito.
instance_id	string		O OCID da instância.
region	string		A região da Oracle Cloud Infrastructure a ser usada para todas as solicitações da API OCI. Consulte para obter mais informações sobre as regiões OCI.
tenancy	string		OCID de sua tenancy. Para obter o OCID da tenancy, consulte .
time_scheduled	string		Se presente, este parâmetro definirá (ou redefinirá) a hora agendada em que a instância será reinicializada e migrada no formato definido por RFC3339. Isso também alterará o campo timeMaintenanceRebootDue na instância.
wait	boolean	no, yes	Se deve aguardar a conclusão da operação de criação ou exclusão.
wait_timeout	integer		Tempo, em segundos, para aguardar quando wait=yes. O padrão é 1200 para a maioria dos serviços, mas alguns serviços podem ter um tempo limite de espera mais longo.

Exemplos

- name: Execute a ação change_compartment na instância oci_compute_instance_actions: # required compartment_id: "ocid1.compartment.oc1..xxxxxxEXAMPLExxxxxx" instance_id: "ocid1.instance.oc1..xxxxxxEXAMPLExxxxxx" action: change_compartment - name: Execute a parada de ação na instância com action_type = reset oci_compute_instance_actions: # required action_type: reset # optional allow_dense_reboot_migration: true - name: Execute a parada de ação na instância com action_type = rebootMigrate oci_compute_instance_actions: # required action_type: rebootMigrate # optional delete_local_storage: true time_scheduled: time_scheduled_example - name: Execute a parada de ação na instância com action_type = softreset oci_compute_instance_actions: # required action_type: softreset # optional allow_dense_reboot_migration: true - name: Execute o início da ação na instância com action_type = reset oci_compute_instance_actions: # required action_type: reset # optional allow_dense_reboot_migration: true - name: Execute o início da ação na instância com action_type = rebootMigrate oci_compute_instance_actions: # required action_type: rebootMigrate # optional delete_local_storage: true time_scheduled: time_scheduled_example - name: Execute o início da ação na instância com action_type = softreset oci_compute_instance_actions: # required action_type: softreset # optional allow_dense_reboot_migration: true - name: Execute a ação softreset na instância com action_type = reset oci_compute_instance_actions: # required action_type: reset # optional allow_dense_reboot_migration: true - name: Execute a ação softreset na instância com action_type = rebootMigrate oci_compute_instance_actions: # required action_type: rebootMigrate # optional delete_local_storage: true time_scheduled: time_scheduled_example - name: Execute a ação softreset na instância com action_type = softreset oci_compute_instance_actions: # required action_type: softreset # optional allow_dense_reboot_migration: true - name: Execute a redefinição de ação na instância com action_type = reset oci_compute_instance_actions: # required action_type: reset # optional allow_dense_reboot_migration: true - name: Execute a redefinição de ação na instância com action_type = rebootMigrate oci_compute_instance_actions: # required action_type: rebootMigrate # optional delete_local_storage: true time_scheduled: time_scheduled_example - name: Execute a redefinição de ação na instância com action_type = softreset oci_compute_instance_actions: # required action_type: softreset # optional allow_dense_reboot_migration: true - name: Execute a ação softstop na instância com action_type = reset oci_compute_instance_actions: # required action_type: reset # optional allow_dense_reboot_migration: true - name: Execute a ação softstop na instância com action_type = rebootMigrate oci_compute_instance_actions: # required action_type: rebootMigrate # optional delete_local_storage: true time_scheduled: time_scheduled_example - name: Execute a ação softstop na instância com action_type = softreset oci_compute_instance_actions: # required action_type: softreset # optional allow_dense_reboot_migration: true - name: Execute a ação senddiagnosticinterrupt na instância com action_type = reset oci_compute_instance_actions: # required action_type: reset # optional allow_dense_reboot_migration: true - name: Execute a ação senddiagnosticinterrupt na instância com action_type = rebootMigrate oci_compute_instance_actions: # required action_type: rebootMigrate # optional delete_local_storage: true time_scheduled: time_scheduled_example - name: Execute a ação senddiagnosticinterrupt na instância com action_type = softreset oci_compute_instance_actions: # required action_type: softreset # optional allow_dense_reboot_migration: true - name: Execute a ação diagnosticreboot na instância com action_type = reset oci_compute_instance_actions: # required action_type: reset # optional allow_dense_reboot_migration: true - name: Execute a ação diagnosticreboot na instância com action_type = rebootMigrate oci_compute_instance_actions: # required action_type: rebootMigrate # optional delete_local_storage: true time_scheduled: time_scheduled_example - name: Execute a ação diagnosticreboot na instância com action_type = softreset oci_compute_instance_actions: # required action_type: softreset # optional allow_dense_reboot_migration: true - name: Execute a ação rebootmigrate na instância com action_type = reset oci_compute_instance_actions: # required action_type: reset # optional allow_dense_reboot_migration: true - name: Execute a ação rebootmigrate na instância com action_type = rebootMigrate oci_compute_instance_actions: # required action_type: rebootMigrate # optional delete_local_storage: true time_scheduled: time_scheduled_example - name: Execute a ação rebootmigrate na instância com action_type = softreset oci_compute_instance_actions: # required action_type: softreset # optional allow_dense_reboot_migration: true

Valores retornados

Chave	Tipo	Retornado quando	Descrição
instance	complex	Sucesso	Detalhes do recurso de instância acionado pela operação atual

Exemplo de retorno

{ "id": "ocid1.resource.oc1..xxxxxxEXAMPLExxxxxx", "compartment_id": "ocid1.compartment.oc1..xxxxxxEXAMPLExxxxxx", "display_name": "display_name_example", "region": "us-phoenix-1", "availability_domain": "Uocm:PHX-AD-1", "fault_domain": "FAULT-DOMAIN-1", "lifecycle_state": "MOVING", "time_created": "2013-10-20T19:20:30+01:00", "time_maintenance_reboot_due": "2013-10-20T19:20:30+01:00", "agent_config": { "are_all_plugins_disabled": true, "is_management_disabled": true, "is_monitoring_disabled": true, "plugins_config": [ { "desired_state": "ENABLED", "name": "name_example" } ] }, "availability_config": { "is_live_migration_preferred": true, "recovery_action": "RESTORE_INSTANCE" }, "capacity_reservation_id": "ocid1.capacityreservation.oc1..xxxxxxEXAMPLExxxxxx", "dedicated_vm_host_id": "ocid1.dedicatedvmhost.oc1..xxxxxxEXAMPLExxxxxx", "shape": "shape_example", "shape_config": { "ocpus": 3.4, "memory_in_gbs": 3.4, "gpus": 56, "local_disks": 56, "local_disks_total_size_in_gbs": 3.4, "networking_bandwidth_in_gbps": 3.4, "max_vnic_attachments": 56, "baseline_ocpu_utilization": "BASELINE_1_8", "processor_description": "processor_description_example", "gpu_description": "gpu_description_example", "local_disk_description": "local_disk_description_example" }, "platform_config": { "type": "AMD_MILAN_BM", "numa_nodes_per_socket": "NPS0", "percentage_of_cores_enabled": 56, "are_virtual_instructions_enabled": true, "is_access_control_service_enabled": true, "is_input_output_memory_management_unit_enabled": true, "is_measured_boot_enabled": true, "is_memory_encryption_enabled": true, "is_secure_boot_enabled": true, "is_symmetric_multi_threading_enabled": true, "is_trusted_platform_module_enabled": true }, "instance_options": { "are_legacy_imds_endpoints_disabled": true }, "launch_mode": "NATIVE", "launch_options": { "boot_volume_type": "ISCSI", "firmware": "BIOS", "is_consistent_volume_naming_enabled": true, "is_pv_encryption_in_transit_enabled": true, "network_type": "E1000", "remote_data_volume_type": "ISCSI" }, "preemptible_instance_config": { "preemption_action": { "type": "TERMINATE", "preserve_boot_volume": true } }, "source_details": { "source_type": "bootVolume", "image_id": "ocid1.image.oc1..xxxxxxEXAMPLExxxxxx", "boot_volume_id": "ocid1.bootvolume.oc1..xxxxxxEXAMPLExxxxxx", "boot_volume_size_in_gbs": 56, "boot_volume_vpus_per_gb": 56, "kms_key_id": "ocid1.kmskey.oc1..xxxxxxEXAMPLExxxxxx" }, "ipxe_script": "ipxe_script_example", "metadata": {}, "extended_metadata": {}, "defined_tags": { "Operations": { "CostCenter": "US" } }, "freeform_tags": { "Department": "Finance" }, "system_tags": {} }