Alibaba Cloud CDN'yi CLI ile yönetin - CDN - Alibaba Cloud Dokümantasyon Merkezi

Alibaba Cloud CLI, OpenAPI Explorer üzerine inşa edilmiş, Alibaba Cloud CDN'nin yönetim ve bakımını otomatikleştirmenizi sağlayan birleşik bir komut satırı aracıdır. Bu konuda, Alibaba Cloud CDN API işlemlerini çağırmak için Alibaba Cloud CLI'nin nasıl kurulacağı, yapılandırılacağı ve kullanılacağı açıklanmaktadır.

Önkoşullar

İlerlemeden önce Alibaba Cloud CLI hakkında bilgi edinin. Daha fazla bilgi için bkz. Alibaba Cloud CLI Nedir?

Alibaba Cloud CLI'yı yükleyin

Başlamadan önce işletim sisteminize uygun olarak Alibaba Cloud CLI'yı yükleyin.

Windows: CLI'yı Windows'a yükleyin.
Linux: CLI'yı yükleyin veya güncelleyin.
macOS: CLI'yı macOS'a yükleyin.

Alternatif olarak, yerel kurulum yapmadan Alibaba Cloud CLI komutlarını hata ayıklamak için Cloud Shell kullanabilirsiniz. Daha fazla bilgi için bkz. Cloud Shell Nedir?.

Alibaba Cloud CLI'yı yapılandırın

Önemli

Bir Alibaba Cloud hesabı (kök hesap), hizmetleriniz ve kaynaklarınız üzerinde tam yönetimsel erişime sahiptir; bu durum önemli bir güvenlik riski oluşturur. API erişimi veya günlük operasyon ve bakım işlemleri için bir RAM kullanıcı oluşturmanızı ve kullanmanızı şiddetle öneririz.

Alibaba Cloud CLI'yı kullanmadan önce kimlik bilgilerinizi ve bir bölge kimliğini yapılandırın. Alibaba Cloud CLI çeşitli kimlik bilgisi türlerini destekler. Daha fazla bilgi için bkz. Kimlik bilgilerini yapılandırma ve yönetme. Bu konuda örnek olarak AccessKey (AK) kimlik bilgileri kullanılmaktadır.

Bir RAM kullanıcı oluşturun ve gerekli izinleri atayın. Daha fazla bilgi için bkz. RAM kullanıcı oluşturma ve RAM kullanıcıya izin atama.

Önemli
Bu örnekte, RAM kullanıcıya AliyunCDNReadOnlyAccess ilkesinin eklenmesi gerekir. Alibaba Cloud CDN alan adlarını sorgulamak ve değiştirmek için tam kontrol sağlayan AliyunCDNFullAccess ilkesini de ekleyebilir veya özel bir ilke oluşturabilirsiniz. Daha fazla bilgi için bkz. CDN özel ilke referansı.
RAM kullanıcıyı oluşturup yetkilendirdikten sonra bir AccessKey çifti oluşturun. AccessKey ID ve AccessKey Secret değerlerini kaydedin. Daha fazla bilgi için bkz. AccessKey oluşturma.
Kullanılabilir bir bölge kimliği edinin ve kaydedin. Alibaba Cloud CLI, API isteklerini belirttiğiniz bölgeye gönderir. Kullanılabilir bölgelerin listesi için bkz. İstek yapısı.

Not
Bir komut için bölge belirtmek üzere --region seçeneğini kullanabilirsiniz. Bu seçenek, kimlik bilgilerinizde ve ortam değişkenlerinde yapılandırılan varsayılan bölgeyi geçersiz kılar. Daha fazla bilgi için bkz. Komut satırı seçenekleri.
RAM kullanıcısının AccessKey çiftini kullanarak kimlik bilgilerini yapılandırın. Yapılandırma profiline AkProfile adını verin. Daha fazla bilgi için bkz. Uç noktalar.

CLI komut örneği oluşturun

Alibaba Cloud CDN API'si için Hata Ayıklama sayfasına gidin.
Sol taraftaki arama kutusunda kullanmak istediğiniz API'yi arayın. Parametreler sekmesinde API belgelerine göre parametreleri yapılandırın. Yapılandırdığınız parametrelerle bir komut örneği oluşturmak için CLI Örneği sekmesine tıklayın.
- simgesine tıklayarak Cloud Shell açın ve komutu hata ayıklayın.
- CLI örneğini kopyalamak için simgesine tıklayın. Ardından komutu çalıştırmak için örneği yerel kabuğunuza yapıştırın.
  - Örneği yerel kabuğunuza yapıştırdığınızda parametre biçimini doğrulayın. Daha fazla bilgi için bkz. Komut parametrelerini anlama.
  - Varsayılan olarak OpenAPI Explorer, oluşturulan örneğe --region seçeneğini ekler. Bu seçenek, kimlik bilgisi yapılandırmanızdaki ve ortam değişkenlerinizdeki varsayılan bölgeyi geçersiz kılar. Gerektiğinde bu seçeneği kaldırın veya koruyun.

API işlemi çağırın

Komut yapısı

Alibaba Cloud CLI komutları aşağıdaki yapıyı izler. Daha fazla bilgi için bkz. Komut oluşturma ve çağırma.

aliyun <command> <subcommand> [options and parameters]

Yaygın komut satırı seçenekleri

Bir komutun varsayılan davranışını değiştirmek için komut satırı seçeneklerini kullanın. Yaygın seçenekler şunlardır:

--profile <profileName>: Varsayılan yerine kullanılacak bir kimlik bilgisi profili belirtir. Ayarlandığında Alibaba Cloud CLI, varsayılan kimlik bilgisi yapılandırmasını ve ortam değişkenlerini yoksayar.
--help: Bir komut için yardım bilgilerini görüntüler. Daha fazla bilgi için bkz. Yardım bilgilerini alma.

Daha fazla bilgi için bkz. Komut satırı seçenekleri.

Örnek

Aşağıdaki örnek, hesabınız altındaki tüm alan adlarını ve durumlarını sorgulamak için DescribeUserDomains işlemini çağırır. Daha fazla bilgi için bkz. DescribeUserDomains.

Komutu çalıştırın.

aliyun cdn DescribeUserDomains --DomainName mxxxio.top

Komut aşağıdaki çıktıyı döndürür.

{
  "Domains": {
    "PageData": [
      {
        "CdnType": "web",
        "Cname": "mxxx.xxxp.w.kunlunq.com",
        "Coverage": "domestic",
        "Description": "",
        "DomainId": 201xxx553,
        "DomainName": "mjlxxxao.top",
        "DomainStatus": "online",
        "GlobalResourcePlan": "off",
        "GmtCreated": "2024-08-27T06:29:36Z",
        "GmtModified": "2024-08-27T06:34:04Z",
        "ResourceGroupId": "rg-acfmwpdflelaoai",
        "Sandbox": "",
        "Sources": {
          "Source": [
            {
              "Content": "183.xxx.xxx.88.cn-hangzhou.sae.aliyuncs.com",
              "Port": 80,
              "Priority": "20",
              "Type": "domain",
              "Weight": "10"
            }
          ]
        }
      }
    ]
  },
  "PageNumber": 1,
  "PageSize": 20,
  "RequestId": "E4EBD2BF-5EB0-4044-9B97-xxxxxx",
  "TotalCount": 1
}
            }
          ]
        },
        "SslProtocol": "off"
      }
    ]
  },
  "PageNumber": 1,
  "PageSize": 20,
  "RequestId": "34C9E61F-02A0-5EB5-BBCB-16B531ABB9E0",
  "TotalCount": 1
}

Not

Bir Alibaba Cloud CDN API çağrısı hata döndürürse istek parametrelerinizin ve değerlerinizin doğru olduğunu doğrulamak için hata kodunu kontrol edin.

Sorunu gidermek için yanıttaki RequestId veya SDK hata mesajını Alibaba Cloud OpenAPI Tanılama ile birlikte de kullanabilirsiniz.