Nota

Questo plugin fa parte del pacchetto raccolta ngine_io.cloudstack (versione 2.0.0).

Per installarlo utilizzare: ansible-galaxy collection install ngine_io.cloudstack.

Per usarlo in un playbook, specificare: ngine_io.cloudstack.cs_snapshot_policy.

Novità della versione 0.1.0: di ngine_io.cloudstack

  • Sinossi
  • Requisiti
  • Parametri
  • Note
  • Esempi
  • Valori di ritorno

Sinossi

  • Crea, aggiorna ed elimina i criteri di snapshot del volume.

Requisiti

I seguenti requisiti sono necessari sull'host che esegue questo modulo.

  • python >= 2.6
  • cs >= 0.9.0

Parametri

Parametri Scelte/Defaults Commenti
contostringa Conto a cui è collegato il volume.
metodo_http_apistringa
    Scelte:

  • ottenere
  • posta
Metodo HTTP utilizzato per interrogare l'endpoint dell'API. Se non viene indicato, il metodo CLOUDSTACK_METHOD viene considerata la variabile env.
api_keystringa / richiesto Chiave API dell'API di CloudStack.Se non viene fornita, la chiave CLOUDSTACK_KEY viene considerata la variabile env.
api_secretstringa / richiesto Chiave segreta dell'API CloudStack. Se non viene impostata, la chiave CLOUDSTACK_SECRET viene considerata la variabile env.
api_timeoutintero Predefinito:
10
Timeout HTTP in secondi. Se non viene indicato, il parametro CLOUDSTACK_TIMEOUT viene considerata la variabile env.
api_urlstringa / richiesto URL dell'API di CloudStack, ad esempio https://cloud.example.com/client/api.If non viene fornito, l'indirizzo CLOUDSTACK_ENDPOINT viene considerata la variabile env.
api_verify_ssl_certstringa Verifica il file cert dell'autorità CA. Se non viene fornito, il file CLOUDSTACK_VERIFY viene considerata la variabile env.
ID dispositivointero ID del dispositivo su una macchina virtuale a cui è collegato il volume. Questo viene considerato solo se la macchina virtuale ha più volumi DATADISK.
dominiostringa Dominio a cui si riferisce il volume.
tipo_intervallostringa
    Scelte:

  • orario
  • giornaliero
  • settimanale
  • mensile
Intervallo dell'istantanea.
alias: intervallo
max_snapsintero Predefinito:
8
Numero massimo di istantanee.
alias: max
progettostringa Nome del progetto a cui si riferisce il volume.
programmastringa Ora in cui è programmata l'istantanea. Richiesto se stato=presente Formato per tipo_intervallo=Orario: MMFormato per tipo_intervallo=Giornaliero: MM:HHFormato per tipo_intervallo=settimanale: MM:HH:DD (1-7)Formato per tipo_intervallo=MONTE: MM:HH:DD (1-28)
statostringa
    Scelte:

  • presente
  • assente
Stato della politica di snapshot.
time_zonestringa Predefinito:
"UTC"
Specifica un fuso orario per questo comando.
alias: timezone
vmstringa Nome dell'istanza da cui selezionare il volume.Utilizzare tipo_volume se la macchina virtuale ha un volume DATADISK e ROOT.Nel caso di volume_type=DATADISK, utilizzare in aggiunta device_id se la macchina virtuale ha più di un volume DATADISK. volume o vm è richiesto.
volumestringa Nome del volume.Either volume o vm è richiesto.
tipo_volumestringa
    Scelte:

  • DATADISK
  • ROOT
Tipo di volume.
vpcstringa Nome del vpc in cui è distribuita l'istanza.

Note

Nota

  • Una guida dettagliata sui moduli CloudStack si trova nella Guida CloudStack Cloud.
  • Questo modulo supporta la modalità di controllo.

Esempi

-name: ensure a snapshot policy daily at 1h00 UTC
  ngine_io.cloudstack.cs_snapshot_policy:volume: ROOT-478schedule:'00:1'max_snaps:3-name: ensure a snapshot policy daily at 1h00 UTC on the second DATADISK of VM web-01ngine_io.cloudstack.cs_snapshot_policy:vm: web-01volume_type: DATADISK
    device_id:2schedule:'00:1'max_snaps:3-name: ensure a snapshot policy hourly at minute 5 UTC
  ngine_io.cloudstack.cs_snapshot_policy:volume: ROOT-478schedule:'5'interval_type: hourly
    max_snaps:1-name: ensure a snapshot policy weekly on Sunday at 05h00, TZ Europe/Zurich
  ngine_io.cloudstack.cs_snapshot_policy:volume: ROOT-478schedule:'00:5:1'interval_type: weekly
    max_snaps:1time_zone:'Europe/Zurich'-name: ensure a snapshot policy is absent
  ngine_io.cloudstack.cs_snapshot_policy:volume: ROOT-478interval_type: hourly
    state: absent

Valori di ritorno

I valori di ritorno più comuni sono documentati qui, i seguenti sono i campi unici di questo modulo:

Chiave Restituito Descrizione
contostringa successo Account a cui è collegato il volume.
Esempio: conto di esempio
dominiostringa successo Dominio a cui è collegato il volume.
Esempio: dominio di esempio
idstringa successo UUID del criterio di snapshot.
Esempio: a6f7a5fc-43f8-11e5-a151-feff819cdc9f
tipo_intervallostringa successo tipo di intervallo del criterio di snapshot.
Esempio: giornaliero
max_snapsintero successo numero massimo di istantanee conservate.
Esempio: 10
progettostringa successo Nome del progetto a cui si riferisce il volume.
Campione: Produzione
programmastringa successo pianificazione del criterio di snapshot.
time_zonestringa successo il fuso orario della politica di snapshot.
Esempio: Ecc/UTC
volumestringa successo il volume del criterio di snapshot.
Esempio: Etc/UTC
zonastringa successo Nome della zona a cui si riferisce il volume.
Esempio: ch-gva-2

Autori

  • René Moser (@resmo)