Hızlı Başlangıç: API merkezinizi oluşturma - Azure CLI

Makale
06/27/2024

Kuruluşunuzun API'lerinin envanterini başlatmak için API merkezinizi oluşturun. Azure API Center, bulma, yeniden kullanma ve idare için api'lerin merkezi bir konumda izlenmesini sağlar.

API merkezinizi oluşturduktan sonra özel meta veriler, API'ler, sürümler, tanımlar ve diğer bilgileri eklemek için öğreticilerdeki adımları izleyin.

Önkoşullar

Azure aboneliğiniz yoksa başlamadan önce ücretsiz bir Azure hesabı oluşturun.
Azure aboneliğinde en azından katkıda bulunan rolü ataması veya eşdeğer izinler.

Azure CLI için:
- Azure Cloud Shell'de Bash ortamını kullanın. Daha fazla bilgi için bkz . Azure Cloud Shell'de Bash için hızlı başlangıç.
- CLI başvuru komutlarını yerel olarak çalıştırmayı tercih ediyorsanız Azure CLI'yı yükleyin . Windows veya macOS üzerinde çalışıyorsanız Azure CLI’yi bir Docker kapsayıcısında çalıştırmayı değerlendirin. Daha fazla bilgi için bkz . Docker kapsayıcısında Azure CLI'yi çalıştırma.
  - Yerel yükleme kullanıyorsanız az login komutunu kullanarak Azure CLI ile oturum açın. Kimlik doğrulama işlemini tamamlamak için terminalinizde görüntülenen adımları izleyin. Diğer oturum açma seçenekleri için bkz . Azure CLI ile oturum açma.
  - İstendiğinde, ilk kullanımda Azure CLI uzantısını yükleyin. Uzantılar hakkında daha fazla bilgi için bkz. Azure CLI ile uzantıları kullanma.
  - Yüklü sürümü ve bağımlı kitaplıkları bulmak için az version komutunu çalıştırın. En son sürüme yükseltmek için az upgrade komutunu çalıştırın.
Not

az apic komutları Için Azure CLI uzantısı gerekir apic-extension . Komutları kullanmadıysanız az apic , ilk az apic komutunuzu çalıştırdığınızda uzantı dinamik olarak yüklenebilir veya uzantıyı el ile yükleyebilirsiniz. Azure CLI uzantıları hakkında daha fazla bilgi edinin.

içindeki en son değişiklikler ve güncelleştirmeler için sürüm notlarınıapic-extensioninceleyin. Bazı özellikler, uzantının önizlemesini veya belirli bir sürümünü gerektirebilir.

Microsoft.ApiCenter sağlayıcısını kaydetme

Henüz yapmadıysanız Microsoft.ApiCenter kaynak sağlayıcısını aboneliğinize kaydetmeniz gerekir. Kaynak sağlayıcısını yalnızca bir kez kaydetmeniz gerekir.

Azure CLI kullanarak kaynak sağlayıcısını aboneliğinize kaydetmek için aşağıdaki az provider register komutu çalıştırın:

az provider register --namespace Microsoft.ApiCenter

Kayıt durumunu denetlemek için aşağıdaki az provider show komutu çalıştırabilirsiniz:

az provider show --namespace Microsoft.ApiCenter

Kaynak grubu oluşturma

Tüm Azure kaynakları gibi Azure API Center örneklerinin de bir kaynak grubuna dağıtılması gerekir. Kaynak grupları, ilgili Azure kaynaklarını düzenlemenize ve yönetmenize olanak sağlar.

komutunu kullanarak az group create bir kaynak grubu oluşturun. Aşağıdaki örnek, Doğu ABD konumunda MyGroup adlı bir grup oluşturur:

az group create --name MyGroup --location eastus

API merkezi oluşturma

komutunu kullanarak az apic create bir API merkezi oluşturun.

Aşağıdaki örnek, MyGroup kaynak grubunda MyApiCenter adlı bir API merkezi oluşturur. Bu örnekte API merkezi Batı Avrupa konumunda dağıtılır. İstediğiniz API merkezi adını değiştirin ve API merkeziniz için kullanılabilir konumlardan birini girin.

az apic create --name MyApiCenter --resource-group MyGroup --location westeurope

Komutun çıktısı aşağıdakine benzer şekilde görünür. Varsayılan olarak, API merkezi Ücretsiz planında oluşturulur.

{
  "dataApiHostname": "myapicenter.data.westeurope.azure-apicenter.ms",
  "id": "/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/mygroup/providers/Microsoft.ApiCenter/services/myapicenter",
  "location": "westeurope",
  "name": "myapicenter",
  "resourceGroup": "mygroup",
  "sku": {
    "name": "Free"
  },
  "systemData": {
    "createdAt": "2024-06-22T21:40:35.2541624Z",
    "lastModifiedAt": "2024-06-22T21:40:35.2541624Z"
  },
  "tags": {},
  "type": "Microsoft.ApiCenter/services"
}

Dağıtımdan sonra API merkeziniz kullanıma hazır!

Sonraki adımlar

Artık API merkezinizdeki envantere bilgi eklemeye başlayabilirsiniz. API'lerinizi ve diğer bilgilerinizi düzenlemenize yardımcı olmak için API merkezinizde özel meta veriler tanımlayarak başlayın.

Özel meta verileri tanımlama

Aracılığıyla paylaş