OCI Compute Instance Actions
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
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