تنظیم URL پورتال

Apigee پورتال خدمات توسعه‌دهنده Apigee (یا به سادگی، پورتال ) را در اختیار شما قرار می‌دهد که می‌توانید از آن برای ایجاد و راه‌اندازی وب‌سایت سفارشی‌سازی شده خود برای ارائه همه این خدمات به جامعه توسعه‌دهنده خود استفاده کنید. مشتریان Edge می‌توانند پورتال توسعه‌دهنده خود را، چه در فضای ابری و چه در بستر پرم، ایجاد کنند. ببینید پورتال توسعه دهنده چیست؟ برای اطلاعات بیشتر.

رابط کاربری Edge دکمه DevPortal را در صفحه Publish > Developers نمایش می دهد که با کلیک روی آن، پورتال مرتبط با یک سازمان باز می شود. به طور پیش فرض، این دکمه URL زیر را باز می کند:

http://live-orgname.devportal.apigee.com

جایی که orgname نام سازمان است.

می توانید این URL را روی یک URL دیگر تنظیم کنید، به عنوان مثال اگر پورتال شما دارای رکورد DNS است، یا دکمه را به طور کامل غیرفعال کنید. از ویژگی های سازمان زیر برای کنترل دکمه استفاده کنید:

  • features.devportalDisabled : برای فعال کردن دکمه روی false (پیش‌فرض) و برای غیرفعال کردن آن روی true تنظیم کنید.
  • features.devportalUrl : روی URL پورتال توسعه دهنده تنظیم کنید.

شما این ویژگی ها را به طور جداگانه برای هر سازمان تنظیم می کنید. برای تنظیم این ویژگی ها، ابتدا از فراخوانی API زیر برای تعیین تنظیمات ویژگی فعلی در سازمان استفاده می کنید:

curl -H "Content-Type:application/json" -u adminEmail:pword -X GET \
  http://ms_IP:8080/v1/organizations/orgname

این فراخوانی یک شی را که سازمان را به شکل زیر توصیف می کند برمی گرداند:

{
  "createdAt" : 1428676711119,
  "createdBy" : "me@my.com",
  "displayName" : "orgname",
  "environments" : [ "prod" ],
  "lastModifiedAt" : 1428692717222,
  "lastModifiedBy" : "me@my.com",
  "name" : "organme",
  "properties" : {
    "property" : [ {
      "name" : "foo",
      "value" : "bar"
    } ]
  },
  "type" : "paid"
}

به هر ویژگی موجود در ناحیه properties شی توجه کنید. هنگامی که ویژگی‌ها را در سازمان تنظیم می‌کنید، مقدار موجود در ویژگی‌ها هر ویژگی فعلی را بازنویسی می‌کند. بنابراین، اگر می‌خواهید features.devportalDisabled یا features.devportalUrl در سازمان تنظیم کنید، مطمئن شوید که ویژگی‌های موجود را هنگام تنظیم کپی کنید.

برای تنظیم ویژگی های سازمان از فراخوانی PUT زیر استفاده کنید:

curl -H "Content-Type:application/json" -u adminEmail:pword -X PUT \
  http://ms_IP:8080/v1/organizations/orgname \
  -d '{
    "displayName" : "orgname",
    "name" : "orgname",
    "properties" : {
      "property" : [
        {
          "name" : "foo",
          "value" : "bar"
        },
        {
          "name": "features.devportalUrl",
          "value": "http://dev-orgname.devportal.apigee.com/"
        },
        {
          "name": "features.devportalDisabled",
          "value": "false"
        }
      ]
    }
  }'

در تماس PUT، فقط باید displayName ، name و properties مشخص کنید. توجه داشته باشید که این فراخوان شامل اموال "foo" است که در ابتدا بر روی سازمان تنظیم شده بود.