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

Edge for Private Cloud phiên bản 4.16.05

Apigee cung cấp cho bạn cổng thông tin Dịch vụ dành cho nhà phát triển mà bạn có thể dùng để xây dựng và ra mắt cổng thông tin trang web được tuỳ chỉnh của riêng mình để 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. Cạnh khách hàng có thể tạo cổng thông tin dành cho nhà phát triển của riêng mình trên đám mây hoặc tại cơ sở hạ tầng riêng. Tìm hiểu khái niệm cổng thông tin cho nhà phát triển? để 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 > Trang dành cho nhà phát triển sẽ mở ra cổng thông tin được liên kết với một tổ chức khi được 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ụ: 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à đặt thành true để tắt nút.
  • features.devportalUrl: Đặt vào 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. Để đặt các thuộc tính này, trước tiên sử dụng lệnh gọi API sau để xác định chế độ cài đặt tài sản 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 trong biểu mẫu:

{
  "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 phần thuộc tính của đối tượng. Khi bạn đặt các thuộc tính trên tổ chức, thì 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 đặt features.devportalDisabled hoặc features.devportalUrl trong tổ chức, đảm bảo bạn sao chép mọi thuộc tính hiện có khi đặt chúng.

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ỉ cần chỉ định displayName, nameproperties. Lưu ý rằng cuộc gọi này bao gồm "foo" được thiết lập ban đầu cho tổ chức.