HOWTO11 How to use the rOCCI Client
Main | Roadmap and Innovation | Technology | For Users | For Resource Providers | Media |
The rOCCI Client
The OCCI gem includes a client you can use directly from shell with the following auth methods: x509 (with --password, --user-cred and --ca-path), basic (with --username and --password), digest (with --username and --password), none. If you won't set a password using --password, the client will ask for it later on.
To find out more about available options and defaults use
occi --help
To list available resources use
occi --endpoint https://<ENDPOINT>:<PORT>/ --action list --resource compute --auth x509 occi --endpoint https://<ENDPOINT>:<PORT>/ --action list --resource storage --auth x509 occi --endpoint https://<ENDPOINT>:<PORT>/ --action list --resource network --auth x509
To describe available resources use
occi --endpoint https://<ENDPOINT>:<PORT>/ --action describe --resource compute --auth x509 occi --endpoint https://<ENDPOINT>:<PORT>/ --action describe --resource storage --auth x509 occi --endpoint https://<ENDPOINT>:<PORT>/ --action describe --resource network --auth x509
To describe specific resources use
occi --endpoint https://<ENDPOINT>:<PORT>/ --action describe --resource /compute/<OCCI_ID> --auth x509 occi --endpoint https://<ENDPOINT>:<PORT>/ --action describe --resource /storage/<OCCI_ID> --auth x509 occi --endpoint https://<ENDPOINT>:<PORT>/ --action describe --resource /network/<OCCI_ID> --auth x509
To list available OS templates or Resource templates use
occi --endpoint https://<ENDPOINT>:<PORT>/ --action list --resource os_tpl --auth x509 occi --endpoint https://<ENDPOINT>:<PORT>/ --action list --resource resource_tpl --auth x509
To describe a specific OS template or Resource template use
occi --endpoint https://<ENDPOINT>:<PORT>/ --action describe --resource os_tpl#debian6 --auth x509 occi --endpoint https://<ENDPOINT>:<PORT>/ --action describe --resource resource_tpl#small --auth x509
To create a compute resource with mixins use
occi --endpoint https://<ENDPOINT>:<PORT>/ --action create --resource compute --mixin os_tpl#debian6 --mixin resource_tpl#small --attribute occi.core.title="My rOCCI VM" --auth x509
To delete a compute resource use
occi --endpoint https://<ENDPOINT>:<PORT>/ --action delete --resource /compute/<OCCI_ID> --auth x509