hosting

POST `/v1/offsite-destinations`

Add a place to send backups to, after proving we can write, read and delete there.

Gbogbo àwọn ìwé àṣẹ olùgbékalẹ̀ àgbékalẹ̀ →

Ìfàṣẹ́pọ̀

Fi bọ́ọ̀lù (bearer token) ranṣẹ gẹ́gẹ́ bí kọ́kọ́rọ́ API. Kọ́kọ́rọ́ náà gbọ́dọ̀ ní ìyọ̀ǹda hosting.backup.manage; a ó kọ̀ ọ́ silẹ pẹlu 403, kii ṣe 404, ti kọ́kọ́rọ́ náà kò bá ní i.

Ibùdó àmì ìdánimọ̀ ilé-iṣẹ́ rẹ sí

Ibi-iwọle yii n gba org_id gẹgẹ bi aaye ninu ara JSON naa.

Id àjọ rẹ wa lórí ojú-ìwákòòkò àwọn bọ́tìnnì API nínú daṣibọọdú rẹ, lẹ́gbẹ̀ẹ́ bọ́tìnnì náà gan-an. Ó jẹ́ ìd kan náà nínú gbogbo ìpè tí o bá ṣe.

Gbiyanju rẹ

Rọ́pọ̀ èyíkéyìí nínú àwọn àmì ìtọ́ka < > pẹ̀lú iye tirẹ̀, àti àmì ìdánimọ̀ bọ́tìnnì náà pẹ̀lú bọ́tìnnì kan láti inú dásibọ̀ọ̀dù rẹ.

curl -X POST https://api.zinndigital.com/v1/offsite-destinations \
  -H "Authorization: Bearer zdk_live_…" \
  -H "Content-Type: application/json" \
  -d '{ "name": <string>, "kind": <string<s3, sftp>> }'

Ṣé o ti wọlé? Iwọ̀n api ní nú ìgbékalẹ̀ rẹ kún id àjọ gidi rẹ ati bọtini tirẹ, o si nṣiṣẹ ibeere na lòdì si api gidi ki o le rii esi gidi na. Ṣí ojú abáná yìí sílẹ̀ nínú kọnsólù API

Àwọn kúlẹ̀kúlẹ̀

The destination is saved only after a real round trip: a small test file is written, read back byte for byte and deleted. For SFTP the server's host key is read without authenticating and pinned; every later connection must present it. Addresses must be on the public internet and S3 endpoints must be https://. Credentials are write-only and go straight to our secret store with a fresh encryption key; every archive is encrypted (AES-256-CTR with HMAC-SHA256) before it leaves us. Refusals are 422 with a machine code in details[0].code. Requires hosting.backup.manage.

Akoonu ibeere naa

Orúkọ	Iru	Tí a nílò	Kini o jẹ
`org_id`	`string`	Bẹẹkọ	—
`name`	`string`	Bẹẹni	—
`kind`	`string<s3, sftp>`	Bẹẹni	—
`prefix`	`string`	Bẹẹkọ	—
`endpoint`	`string`	Bẹẹkọ	S3: an https:// endpoint with no path.
`region`	`string`	Bẹẹkọ	S3: the bucket's region, or auto for Cloudflare R2.
`bucket`	`string`	Bẹẹkọ	—
`access_key_id`	`string`	Bẹẹkọ	—
`secret_access_key`	`string`	Bẹẹkọ	—
`host`	`string`	Bẹẹkọ	SFTP: the server's host name.
`port`	`integer`	Bẹẹkọ	—
`username`	`string`	Bẹẹkọ	—
`password`	`string`	Bẹẹkọ	—
`private_key`	`string`	Bẹẹkọ	OpenSSH format.

Idahun

Orúkọ	Iru	Tí a nílò	Kini o jẹ
`id`	`string`	Bẹẹni	—
`org_id`	`string`	Bẹẹni	—
`name`	`string`	Bẹẹni	—
`kind`	`string<s3, sftp>`	Bẹẹni	—
`endpoint`	`string`	Bẹẹkọ	—
`region`	`string`	Bẹẹkọ	—
`bucket`	`string`	Bẹẹkọ	—
`host`	`string`	Bẹẹkọ	—
`port`	`integer`	Bẹẹkọ	—
`username`	`string`	Bẹẹkọ	—
`host_key_fingerprint`	`string`	Bẹẹkọ	The pinned SFTP host key as `SHA256:…`, the form `ssh-keygen -lf` prints.
`prefix`	`string`	Bẹẹni	—
`status`	`string<working, failing>`	Bẹẹni	—
`last_checked_at`	`string`	Bẹẹkọ	—
`last_check_code`	`string`	Bẹẹkọ	—
`sites_using`	`integer`	Bẹẹni	—
`created_at`	`string`	Bẹẹni	—

Awọn aṣiṣe ti ibudo ipari yii le da pada

401 · 403 · 404 · 422