Tüm Ürünler
Search

Bu Ürün

    Cloud Control API:Manage resources through OpenAPI Explorer

    Belge Merkezi

    Cloud Control API:Manage resources through OpenAPI Explorer

    Son Güncelleme:Oct 14, 2026

    Bu konu, bulut kaynaklarını yönetmek amacıyla OpenAPI Explorer üzerinden Cloud Control API'nin çevrimiçi olarak nasıl çağrılacağını gösterir. Virtual Private Cloud (VPC) örnek alınarak bir VPC kaynağının oluşturma, sorgulama, güncelleme ve silme işlemleri adım adım açıklanır. Ayrıca Cloud Control API görevleri eşzamansız olarak işlediğinde görev durumunun nasıl sorgulanacağı da anlatılır.

    Ön Koşullar

    İşlemlerin sorunsuz ilerlemesi için aşağıdaki hazırlıkları tamamlayın:

    • Bir Alibaba Cloud hesabı (kök hesap) kaynaklar üzerinde tüm izinlere sahip olduğundan, kimlik bilgilerinin sızması ciddi bir risk oluşturur. Bunun yerine bir RAM kullanıcısı kullanmanızı öneririz. Daha fazla bilgi için RAM kullanıcısı oluşturun konusuna bakın.

    • Cloud Control API'yi çağırmadan önce RAM kullanıcısına ilgili kaynakları yönetme izni verin. Ardından, Cloud Control API'yi yönetmek için gereken tüm izinlere sahip olduğundan emin olmak üzere AliyunCloudControlAPIFullAccess ilkesini atayın. Daha fazla bilgi için RAM kullanıcı izinlerini yönetin konusuna bakın.

    OpenAPI Explorer Üzerinden Cloud Control API'yi Çevrimiçi Çağırma

    Bu eğitimde örnek olarak Virtual Private Cloud (VPC) ele alınmıştır. VPC'nin ürün kodu VPC, kaynak türü kodu ise yine VPC şeklindedir. Ürün kodu ve kaynak türü kodunu kullanarak kaynak türünün ayrıntılarını sorgulayabilirsiniz. Cloud Control API'yi çevrimiçi çağırarak VPC kaynaklarını oluşturabilir, getirebilir, güncelleyebilir, listeleyebilir ve silebilirsiniz.

    VPC Kaynağı Oluşturma

    Bu işlem bir VPC kaynağı oluşturmak için kullanılır.

    1. Bir RAM kullanıcısı olarak OpenAPI Explorer adresine gidin. VPC kaynağı oluşturma sayfasına ulaştığınızda regionId değerini seçin ve body içindeki kaynak özelliği parametrelerini ayarlayın. Ardından Initiate Call düğmesine tıklayın. Sağ taraftaki örnek kod bölümünden bir programlama dili seçtiğinizde sistem sizin için referans amaçlı kod otomatik olarak oluşturur.

    2. Çağrıyı başlattıktan sonra sonucu görüntüleyin.

      Çağrı hata döndürürse sorunu analiz edip çözmek için Diagnose sekmesindeki günlük bilgilerine, API belgelerine veya Genel hata kodları listesine bakın. Gerekirse Bize ulaşın.

      Çağrı başarılı olursa yanıttaki kaynak kimliğini (resourceId) not edin. 200 durum kodu eşzamanlı bir işlemi gösterir; yani kaynak oluşturma görevi tamamlanmıştır. 202 durum kodu eşzamansız bir işlemi işaret eder ve dönen taskId değerini kullanarak görev durumunu ayrıca sorgulamanız gerekir.

      Not

      Eşzamanlı ve eşzamansız işlemler, bir programın görev çalıştırmayı ele aldığı iki farklı moddur. Eşzamanlı işlem yalnızca görev tamamlandıktan sonra yanıt dönerken eşzamansız işlem görevin tamamlanmasını beklemeden hemen yanıt verir.

    3. Bu örnekte çağrı sonucu 202 durum kodu döndürür; bu da işlemin eşzamansız olduğunu gösterir. Görev durumunu taskId kullanarak sorgulamanız gerekir. taskId değerini not edin ve görev sorgulama sayfasına gitmek için Query task seçeneğine tıklayın.

    4. taskId değerini girin ve Initiate Call düğmesine tıklayın. Çağrı sonucunu inceleyin: Çağrı başarılı olur, görev durumu Succeeded olarak görünür ve VPC kaynağı oluşturulmuş olur.

    5. Sonucu doğrulamak için oluşturulan VPC'yi VPC konsolu üzerinden görüntüleyin.

    VPC Kaynağını Getirme

    Bu işlem bir VPC kaynağının ayrıntılarını getirmek için kullanılır. VPC kaynağı getirme sayfasında resourceId değerini girin, regionId seçeneğini belirleyin ve Initiate Call düğmesine tıklayın. Çağrı başarılı olur ve kaynak ayrıntıları döndürülür.

    VPC Kaynağını Güncelleme

    Bu işlem bir VPC kaynağının bilgilerini güncellemek için kullanılır. VPC kaynağı güncelleme sayfasında resourceId değerini girin, regionId seçeneğini belirleyin, güncellemek istediğiniz parametre değerlerini yazın ve Initiate Call düğmesine tıklayın. Çağrı sonucunu inceleyin. Güncellemeyi doğrulamak için kaynak bilgilerini VPC konsolu üzerinden veya Cloud Control API'yi çağırarak kontrol edin.

    VPC Kaynaklarını Listeleme

    Bu işlem tüm VPC kaynaklarının bilgilerini listelemek için kullanılır. VPC kaynağı listeleme sayfasında regionId seçeneğini belirleyin ve Initiate Call düğmesine tıklayın. Dönen sonuçta kaynak bilgilerini görebilirsiniz.

    Örnek parametreler aşağıdaki gibidir:

    • requestPath: /api/v1/providers/Aliyun/products/VPC/resources/VPC

    • regionId: cn-beijing

    VPC Kaynağını Silme

    Bu işlem belirtilen bir VPC kaynağını silmek için kullanılır.

    Önemli

    Silme işlemi geri alınamaz. Dikkatli olun. Bir VPC'yi silmeden önce silme sürecini test ortamında tamamen doğrulamanızı ve her şeyin doğru olduğundan emin olduktan sonra işlemi üretim kaynaklarında yapmanızı öneririz.

    1. VPC kaynağı silme sayfasında resourceId değerini girin, regionId seçeneğini belirleyin ve Initiate Call düğmesine tıklayın. Ardından çağrı sonucunu inceleyin.

    2. Çağrı başarılı olur ve 202 durum kodu döner; bu da işlemin eşzamansız olduğunu gösterir.

      Görev sorgulama sayfasında taskId değerini girin ve Initiate Call düğmesine tıklayın. Çağrı sonucunda görev durumu Succeeded olarak görünür; bu da VPC kaynağının silindiği anlamına gelir.

    Örnek kod

    Kod deposu: https://github.com/aliyun/cloud-control-api-demo

    Bu depo, kaynak meta verilerini sorgulamanıza ve bulut kaynaklarını yönetmenize yardımcı olmak amacıyla Cloud Control API için kod örnekleri sunar.