Đặt URL của cổng

Apigee cung cấp cho bạn cổng Dịch vụ dành cho nhà phát triển Apigee (hay đơn giản là cổng). Bạn có thể sử dụng cổng này để xây dựng và ra mắt trang web tuỳ chỉnh của riêng mình nhằm cung cấp tất cả các dịch vụ này cho cộng đồng phát triển của bạn. Khách hàng Edge có thể tạo cổng thông tin cho nhà phát triển của riêng họ trên đám mây hoặc tại cơ sở hạ tầng riêng. Hãy xem bài viết Cổng thông tin cho nhà phát triển là gì? để biết thêm thông tin.

Giao diện người dùng Edge hiển thị nút DevPortal trên trang Publish > Developers (Xuất bản > Nhà phát triển). Nút này sẽ mở ra cổng thông tin liên kết với một tổ chức khi bạn nhấp vào. Theo mặc định, nút đó sẽ mở URL sau:

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

Trong đó orgname là tên của tổ chức.

Bạn có thể đặt URL này thành một URL khác, ví dụ như nếu cổng thông tin của bạn có bản ghi DNS hoặc vô hiệu hoá hoàn toàn nút này. Sử dụng các thuộc tính sau của tổ chức để kiểm soát nút:

  • features.devportalDisabled: Đặt thành false (mặc định) để bật nút và thành true để tắt nút này.
  • features.devportalUrl: Đặt thành URL của cổng thông tin dành cho nhà phát triển.

Bạn đặt riêng các thuộc tính này cho từng tổ chức. Để thiết lập các thuộc tính này, trước tiên, bạn nên dùng lệnh gọi API sau để xác định chế độ cài đặt tài sản hiện tại trong tổ chức:

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

Lệnh gọi này trả về một đối tượng mô tả tổ chức ở dạng:

{
  "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"
}

Hãy lưu ý mọi thuộc tính hiện có trong vùng properties của đối tượng. Khi bạn đặt các thuộc tính trên tổ chức, giá trị trong các thuộc tính sẽ ghi đè mọi thuộc tính hiện tại. Do đó, nếu bạn muốn thiết lập features.devportalDisabled hoặc features.devportalUrl trong tổ chức, hãy nhớ sao chép mọi thuộc tính hiện có khi thiết lập.

Sử dụng lệnh gọi PUT sau đây để đặt các thuộc tính trong tổ chức:

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"
        }
      ]
    }
  }'

Trong lệnh gọi PUT, bạn chỉ phải chỉ định displayName, nameproperties. Xin lưu ý rằng lệnh gọi này bao gồm thuộc tính "foo" ban đầu được đặt trên tổ chức.