Computers

Last updated on 2022-06-10 13:43:21

URI	/v1/accounts/{username}/computers/{computer_id}
URI Parameters	username (string) computer_id (string)
Methods	GET, DELETE

GET /v1/accounts/{username}/computers/{computer_id}

Gets a computer’s information.

Scope	computers_read
Request Body Parameters	n/a
Response Attributes	username (string) computer_id (string) signup_date (date) status (string const) – ACTIVE\|DISABLED\|DELETED usage (int) – number of bytes stored name (string) email (string) phone (string) info (link object) action_history (link object) usage_history (link object) notification_emails (link object) notification_options (link object) reports (link object) password (link object)

Example JSON

Request:

GET /v1/accounts/barracuda/computers/0000 HTTP/1.1

Host: api.intronis.com

Authorization: OAuth vF9dft4qmT

Accept: application/json

Response:

HTTP/1.1 200 OK

Content-Type: application/json

{

"username": “barracuda”,

"computer_id": "0000",

"signup_date": "2011-01-01T09:00:00-05:00"

"status": "ACTIVE",

"usage": "1099511627776",

"name": "Mail Server",

"email": "jsmith@barracuda.com",

"phone": "617-948-5300",

"links": [

{

"title": "info",

"rel": "related",

"href": "https://api.intronis.com/v1/accounts/barracuda/computers/0000/info"

{

"title": "action_history",

"rel": "related",

"href": "https://api.intronis.com/v1/accounts/barracuda/computers/0000/action_history"

{

"title": "usage_history",

"rel": "related",

"href": "https://api.intronis.com/v1/accounts/barracuda/computers/0000/usage_history"

{

"title": "notification_emails",

"rel": "related",

"href": "https://api.intronis.com/v1/accounts/barracuda/computers/0000/notifications/emails"

{

"title": "notification_options",

"rel": "related",

"href":"https://api.intronis.com/v1/accounts/barracuda/computers/0000/notifications/options"

{

"title": "reports",

"rel": "related",

"href":"https://api.intronis.com/v1/accounts/barracuda/computers/0000/reports"

{

"title": "password",

"rel": "related",

"href":"https://api.intronis.com/v1/accounts/barracuda/computers/0000/password"

}

]

}

Example XML

Request:

GET /v1/accounts/barracuda/computers/0000 HTTP/1.1

Host: api.intronis.com

Authorization: OAuth vF9dft4qmT

Accept: application/xml

Response:

HTTP/1.1 200 OK

Content-Type: application/xml

<?xml version="1.0" encoding="UTF-8"?>

<username>barracuda</username>

<computer_id>0000</computer_id>

<signup_date>2011-01-01T09:00:00-05:00</signup_date>

<status>ACTIVE</status>

<name>Mail Server</name>

<email>jsmith@barracuda.com</email>

</computer>

DELETE /v1/accounts/{username}/computers/{computer_id}

Deletes a computer from an account. The 0000 computer also can be deleted, but there should never be a situation where an account has no computers underneath it. If the user intends to delete the last computer, the server responds with 405 Method Not Allowed.

Scope	computers_write
Request Body Parameters	n/a
Response Attributes	n/a

Example

Request:

DELETE /v1/accounts/barracuda/computers/0013 HTTP/1.1

Host: api.intronis.com

Authorization: OAuth vF9dft4qmT

Response:

HTTP/1.1 204 No Content

Example 0000 computer which is the last computer of the account

Request:

DELETE /v1/accounts/barracuda/computers/0000 HTTP/1.1

Host: api.intronis.com

Authorization: OAuth vF9dft4qmT

Response:

HTTP/1.1 405 Method Not Allowed