Tərtibatçı alətləri icmalı

Layihələrinizi (project) koddan iki yolla idarə edə bilərsiniz. REST API platformanın öz HTTP API-sidir, konsolun istifadə etdiyi eyni API-dir və onu API tokeni (API token) və ya xidmət hesabının (service account) açarı ilə çağırırsınız. OpenStack API-ləri openstack CLI, Terraform və Kubernetes bulud inteqrasiyaları kimi OpenStack alətlərinə xidmət edir; bu alətlər tətbiq giriş məlumatı (application credential) ilə daxil olur.

Əsas imkanlarKeçidi kopyalayın

• Konsolun öz API-si. Konsol sorğularını REST API-yə göndərir və siz eyni sorğuları kodunuzdan göndərə bilərsiniz. REST API icmalı səhifəsinə baxın.
• Miqyaslı giriş məlumatları. API tokenlərinin miqyasları (scope), ixtiyari bitmə tarixi və ixtiyari IP icazə siyahısı (IP allowlist) olur. Xidmət hesabı açarları xidmət hesabının rolları ilə işləyir. API tokenləri ilə autentifikasiyadan keçin səhifəsinə baxın.
• Köçürülə bilən sorğular. Virtual maşın (instance) yaratma ustadının son addımındakı REST equivalent bölməsi sorğunu curl əmri kimi göstərir. Administrator parolu əmrə yazılmır, ADMIN_PASSWORD mühit dəyişənindən oxunur. Virtual maşın yaradın səhifəsinə baxın.
• İzlənilə bilən asinxron iş. Uzun sürən sorğular başa çatana qədər oxuya bildiyiniz əməliyyat qaytarır. Sinxron və asinxron sorğular bölməsinə baxın.
• Təhlükəsiz təkrar cəhdlər. İdempotentlik açarı sayəsində təkrarlanan yazma sorğusu dəyişikliyi təkrarlamaq əvəzinə ilk nəticəni qaytarır. İdempotent sorğular səhifəsinə baxın.
• API istinadı. Hər məhsulun əməliyyatları, parametrləri və cavabları ilə. API istinadı səhifəsinə baxın.
• OpenStack ilə uyğun alətlər. Layihələrinizlə openstack CLI, Terraform, həmçinin Kubernetes üçün OCCM və Cinder CSI işləyir. OpenStack ilə uyğun alətlər səhifəsinə baxın.

Necə işləyirKeçidi kopyalayın

Hər iki növ API eyni resurslar üzərində işləyir. Terraform ilə yaratdığınız virtual maşın konsolda görünür və onun üçün ödəniş konsolda yaratdığınız virtual maşında olduğu kimi hesablanır. İstənilən API vasitəsilə yaratdığınız resurslar eyni kvotalara daxil edilir.

REST API konsolun hostunda deyil, API hostunda /api/v1 altında təqdim olunur. Yolların çoxu layihənin ID-si ilə başlayır və hər sorğu, sorğu xidmətə çatmazdan əvvəl API şlüzünün yoxladığı bearer giriş məlumatı daşıyır. Platformanın buludda icra etdiyi yazma sorğuları, məsələn, virtual maşının yaradılması, 202 Accepted qaytarır və arxa planda davam edir; onları əməliyyat və ya resursun statusu vasitəsilə izləyirsiniz. REST API vasitəsilə başlatdığınız əməliyyatlar, məsələn, resursun yaradılması və ya silinməsi, Activity Log-da onları başladan istifadəçi və ya xidmət hesabı ilə birlikdə görünür. Audit və fəaliyyət qeydləri səhifəsinə baxın.

REST API-nin öz əmr sətri aləti və ya Terraform provayderi yoxdur: onu HTTP üzərindən, məsələn, curl ilə çağırırsınız. Kod kimi infrastruktur üçün Terraform-un OpenStack provayderindən tətbiq giriş məlumatı ilə istifadə edin.

Tətbiq giriş məlumatı bir layihəyə aiddir və layihədəki rolunuzun sizə verdiyi OpenStack rolları ilə işləyir. Onu konsolda yaradırsınız və yaradarkən hər alət üçün konfiqurasiya fayllarını endirə bilərsiniz. API tokenləri OpenStack alətləri ilə işləmir, tətbiq giriş məlumatları isə REST API ilə işləmir.

İstifadə ssenariləriKeçidi kopyalayın

• CI/CD konveyerləri. Konkret şəxsin hesabından asılı olmayan xidmət hesabı açarı ilə konveyerdən test mühitləri yaradın və silin.
• Kod kimi infrastruktur. Şəbəkələri (network), virtual maşınları və diskləri (volume) Terraform-da təsvir edin və onları tətbiq giriş məlumatı ilə tətbiq edin.
• Virtual maşınlarınızda Kubernetes. Virtual maşınlarınızda işlətdiyiniz klasteri OCCM və Cinder CSI ilə buluda qoşun.
• Hesabatlar. Xərc məlumatlarını və fəaliyyət qeydlərini oxuyub öz alətlərinizə ötürün.

ÖdənişKeçidi kopyalayın

API-lər resurslar üçün ödənişin necə hesablandığını dəyişmir: API vasitəsilə yaratdığınız resurs üçün ödəniş konsolda yaratdığınız resursla eyni meyarlar üzrə hesablanır. Hər məhsulun meyarları üçün Ödəniş necə işləyir səhifəsinə baxın.

LimitlərKeçidi kopyalayın

• API şlüzü hər giriş məlumatının sorğu göndərmə sürətini məhdudlaşdırır və limiti aşdıqda 429 Too Many Requests cavabını qaytarır. Sorğu limiti bölməsinə baxın.
• Siyahıların çoxu səhifədə ən çox 200 element qaytarır. Səhifələmə səhifəsinə baxın.
• Platforma idempotentlik açarını ən azı 24 saat saxlayır. İdempotent sorğular səhifəsinə baxın.
• Bəzi əməliyyatlar, miqyas düzgün olsa belə, API tokeni və ya xidmət hesabı açarı üçün rədd edilir, məsələn, konsol seansı tələb edənlər. API tokeninin çağıra bilmədiyi əməliyyatlar bölməsinə baxın.
• Tətbiq giriş məlumatlarının öz limitləri var. OpenStack API limitləri səhifəsinə baxın.

Əlaqəli xidmətlərKeçidi kopyalayın

• Identity & Access Management: xidmət hesabları, API tokenləri və rollar.
• OpenStack API Access: OpenStack alətləri üçün tətbiq giriş məlumatları.
• Activity Log: layihələrinizdəki əməliyyatların qeydi.

Növbəti addımlarKeçidi kopyalayın