> ## Documentation Index
> Fetch the complete documentation index at: https://docs.apinizer.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Instance Yönetimi

> API Promotion için hedef Apinizer ortamlarını tanımlayabilir, bağlantı durumlarını izleyebilir, onay mekanizmasını yapılandırabilir ve bildirim alıcılarını belirleyebilirsiniz.

<Info>
  [Ortam (Environment)](/tr/concepts/temel-kavramlar/ortam-nedir) kavramı hakkında detaylı bilgi için temel kavramlar sayfasına bakabilirsiniz.
</Info>

## Instance Listesi

Instance yönetim ekranında tanımlı tüm hedef ortamları görebilirsiniz. Liste aşağıdaki bilgileri sunar:

* **Ad ve Açıklama**: Instance’ın tanımlayıcı bilgileri
* **URL**: Hedef ortamın adresi (Base URL)
* **Onay Durumu**: Onay gerekli mi ve (varsa) onaylayıcılar
* **Alıcılar**: (Varsa) bildirim alıcıları
* **Bağlantı Durumu**: Hedef ortama erişilebilirlik durumu (ör. Reachable / Not Reachable)

<img src="https://mintcdn.com/apinizer/1yFCZZQUbO1Sf_g6/images/promotion/promotion1.png?fit=max&auto=format&n=1yFCZZQUbO1Sf_g6&q=85&s=6afa2779c20f706b6a801e7fdcf04487" alt="Instance listesi" width="800" data-path="images/promotion/promotion1.png" />

## Yeni Instance Oluşturma

Yeni bir hedef ortam eklemek için **New Instance** butonunu kullanabilirsiniz.

### Temel Bilgiler

| Alan          | Açıklama                                                                                            |
| ------------- | --------------------------------------------------------------------------------------------------- |
| **İsim**      | Instance için benzersiz bir ad. Sadece İngilizce harf ve rakam kabul eder, boşluk kullanılamaz      |
| **Açıklama**  | Instance hakkında açıklayıcı bilgi                                                                  |
| **Base URL**  | Hedef Apinizer ortamının adresi                                                                     |
| **API Token** | Hedef ortama erişim için kullanılacak API anahtarı (hedef ortamın ilgili ayarlarından temin edilir) |
| **Renk**      | Instance’ı görsel olarak ayırt etmek için renk seçimi                                               |

<img src="https://mintcdn.com/apinizer/1yFCZZQUbO1Sf_g6/images/promotion/promotion2.png?fit=max&auto=format&n=1yFCZZQUbO1Sf_g6&q=85&s=0cd12e43ca7d3a6efe9ba122e66470ec" alt="Yeni instance oluşturma" width="800" data-path="images/promotion/promotion2.png" />

## Bağlantı Testi

Instance kaydedildikten sonra hedef ortama erişimi doğrulamak için bağlantı testi yapabilirsiniz.

* **Liste ekranından**: İlgili instance satırındaki **(… menü)** → **Test**
* **Detay ekranından**: **Test** butonu

Test sonucunda bağlantı durumu ekranda güncellenir:

* **Başarılı**: Connection Status alanında **Reachable** görünür.
* **Başarısız**: Connection Status alanında **Not Reachable** görünür ve (varsa) hata mesajı görüntülenir.

<img src="https://mintcdn.com/apinizer/1yFCZZQUbO1Sf_g6/images/promotion/promotion3.png?fit=max&auto=format&n=1yFCZZQUbO1Sf_g6&q=85&s=0fa07412769c088cf8da457b10112b4a" alt="Bağlantı testi sonucu" width="800" data-path="images/promotion/promotion3.png" />

## Onay ve Bildirim Ayarları

Kritik ortamlara (özellikle Production) yapılan aktarımlar için onay mekanizması yapılandırabilir, ayrıca bildirim alıcılarını belirleyebilirsiniz.

### Onay Mekanizması

**Approval required for promoting to this instance** seçeneğini aktifleştirdiğinizde, bu instance’a yapılacak promotion işlemleri çalıştırılmadan önce belirlenen onaylayıcılardan onay bekler.

| Ayar              | Açıklama                                                               |
| ----------------- | ---------------------------------------------------------------------- |
| **Onay Gerekli**  | Aktif olduğunda, çalıştırma öncesi belirlenen kişilerden onay beklenir |
| **Onaylayıcılar** | Çalıştırma isteğini onaylayabilecek kullanıcılar                       |

<img src="https://mintcdn.com/apinizer/1yFCZZQUbO1Sf_g6/images/promotion/promotion4.png?fit=max&auto=format&n=1yFCZZQUbO1Sf_g6&q=85&s=2d783cb301159e770bba097bc111ba24" alt="Onay ayarları" width="800" data-path="images/promotion/promotion4.png" />

### Bildirim Alıcıları

Promotion işlemlerinin durumu hakkında bilgilendirilecek alıcıları tanımlayabilirsiniz. Bildirimler şu durumlarda gönderilir:

* Çalıştırma başladığında
* Çalıştırma başarıyla tamamlandığında
* Çalıştırma hata aldığında

Bildirim alıcıları olarak sistemde tanımlı connector’ları (ör. e-posta connector’ı) ekleyebilirsiniz.

<img src="https://mintcdn.com/apinizer/1yFCZZQUbO1Sf_g6/images/promotion/promotion5.png?fit=max&auto=format&n=1yFCZZQUbO1Sf_g6&q=85&s=74354a42604f57fbafbb9955aed8d5c6" alt="Bildirim alıcıları" width="800" data-path="images/promotion/promotion5.png" />

## Instance Detay Ekranı

Instance detay ekranında temel bilgiler ile birlikte bağlantı durumunu görüntüleyebilir ve **Test** butonu ile bağlantı testini tetikleyebilirsiniz. Bağlantı başarısız olduğunda, (varsa) hata mesajı da bu ekranda görülebilir.

<img src="https://mintcdn.com/apinizer/1yFCZZQUbO1Sf_g6/images/promotion/promotion6.png?fit=max&auto=format&n=1yFCZZQUbO1Sf_g6&q=85&s=8713b95439260de3138b62dc38bc0e9d" alt="Instance detay ekranı" width="800" data-path="images/promotion/promotion6.png" />

## Instance Silme

Bir instance’ı silmek istediğinizde onay dialogu görüntülenir.

<Warning>
  Bir instance silindiğinde, bu instance ile ilişkili mapping’ler ve execution akışları etkilenebilir. Silmeden önce ilişkili kayıtları kontrol etmeniz önerilir.
</Warning>