Đặt URL của cổng Dịch vụ dành cho nhà phát triển

Edge for Private Cloud v. 4.16.09

Apigee cung cấp cho bạn một cổng thông tin Dịch vụ dành cho nhà phát triển mà bạn có thể sử dụng để 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. Khách hàng của Edge có thể tạo cổng thông tin dành cho nhà phát triển của riêng họ, trên đám mây hoặc tại chỗ. Hãy xem bài viết Cổng thông tin dành 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 (Cổng thông tin dành cho nhà phát triển) trên trang Publish > Developers (Xuất bản > Nhà phát triển). Khi nhấp vào nút này, cổng thông tin liên kết với một tổ chức sẽ mở ra. 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, chẳng hạn như nếu cổng thông tin của bạn có bản ghi DNS hoặc tắt 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.
  • features.devportalUrl: Đặt thành URL của cổng thông tin dành cho nhà phát triển.

Bạn đặt các thuộc tính này riêng cho từng tổ chức. Để đặt các thuộc tính này, trước tiên, bạn hãy sử dụng lệnh gọi API sau đây để xác định chế độ cài đặt thuộc tính hiện tại trên 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"
}

Lưu ý mọi thuộc tính hiện có trong khu vực properties (thuộc tính) của đối tượng. Khi bạn đặt thuộc tính cho tổ chức, giá trị trong thuộc tính sẽ ghi đè mọi thuộc tính hiện tại. Do đó, nếu bạn muốn đặt 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 bạn đặt các thuộc tính đó.

Sử dụng lệnh gọi PUT sau đây để đặt các thuộc tính trên 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ỉ cần 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.