Memindahkan resource API di Ruang Apigee

Halaman ini berlaku untuk Apigee dan Apigee hybrid.

Lihat dokumentasi Apigee Edge.

Topik ini menjelaskan cara memindahkan resource API (proxy API, alur bersama, dan produk API) di antara Ruang Apigee dalam organisasi Apigee. Pengguna dapat memindahkan resource antar-tingkat organisasi dan Ruang atau memindahkan resource antar-Ruang. Untuk memindahkan, mengelola, atau melihat resource API di organisasi atau Ruang, pengguna harus memiliki izin yang sesuai untuk organisasi atau Ruang yang relevan.

Memindahkan resource API dari organisasi ke Ruang

Resource API yang dibuat di organisasi Apigee dapat dipindahkan dari tingkat organisasi ke Ruang atau sebaliknya. Resource API yang dipindahkan ke Ruang mewarisi kebijakan IAM Ruang tersebut. Untuk memindahkan resource API dari tingkat organisasi ke Ruang, pengguna harus memiliki izin berikut:

  • apigee.RESOURCE_TYPE.move pada cakupan sumber (organisasi atau Ruang tempat resource saat ini berada).

    Nilai yang valid untuk RESOURCE_TYPE mencakup proxies, sharedflows, atau apiproducts, bergantung pada jenis resource API yang dipindahkan.

  • apigee.RESOURCE_TYPE.create pada cakupan target (organisasi atau Ruang tempat resource akan dipindahkan).

    Nilai yang valid untuk RESOURCE_TYPE mencakup proxies, sharedflows, atau apiproducts, bergantung pada jenis resource API yang dipindahkan.

Untuk memindahkan resource API tingkat organisasi ke Ruang, gunakan perintah berikut: 

curl "https://apigee.googleapis.com/v1/organizations/ORG_NAME/RESOURCE_TYPE/RESOURCE_ID:move?space=SPACE_NAME" \
  -X POST -H "Authorization: Bearer $TOKEN"

Dengan keterangan:

  • ORG_NAME adalah nama organisasi Apigee Anda.
  • RESOURCE_TYPE adalah jenis resource yang Anda cantumkan. Nilai yang valid mencakup:
    • apis
    • sharedflows
    • apiproducts
  • RESOURCE_ID adalah nama proxy API, alur bersama, atau produk API yang ingin Anda pindahkan.
  • SPACE_NAME adalah nama Ruang tempat Anda memindahkan resource.

Misalnya, dengan perintah berikut, pengguna dengan peran Apigee Organization Admin untuk organisasi acme akan memindahkan proxy API bernama demo dari tingkat organisasi ke Ruang red: 

curl "https://apigee.googleapis.com/v1/organizations/acme/apis/demo:move?space=red" \
  -X POST -H "Authorization: Bearer $TOKEN"

Responsnya akan terlihat seperti berikut: 

{
  "metaData": {
    "createdAt": "1739489725993",
    "lastModifiedAt": "1741724822852",
    "subType": "Proxy"
  },
  "name": "demo",
  "revision": [
    "1",
    "2"
  ],
  "apiProxyType": "PROGRAMMABLE",
  "space": "red"
}

Setelah proxy API demo dipindahkan ke Ruang merah, anggota Ruang merah dapat mengakses proxy, meskipun mereka tidak memiliki izin untuk mengakses resource tingkat organisasi. Anggota Ruang lain, yang bukan anggota Ruang merah, tidak dapat melihat atau mengakses proxy demo.

Mencoba mengakses proxy demo tanpa izin tingkat organisasi atau Ruang yang benar akan mengakibatkan error berikut: 

  {
    "error": {
      "code": 403,
      "message": "Permission denied on resource \"organizations\/acme\/apis\/demo\" (or it may not exist).",
      "status": "PERMISSION_DENIED"
    }
  }

Untuk memindahkan resource API dari Ruang ke tingkat organisasi, gunakan perintah berikut, yang menghilangkan parameter kueri space: 

curl "https://apigee.googleapis.com/v1/organizations/ORG_NAME/RESOURCE_TYPE/RESOURCE_ID:move" \
  -X POST -H "Authorization: Bearer $TOKEN"

Dengan keterangan:

  • ORG_NAME adalah nama organisasi Apigee Anda.
  • RESOURCE_TYPE adalah jenis resource yang Anda cantumkan. Nilai yang valid mencakup:
    • apis
    • sharedflows
    • apiproducts
  • RESOURCE_ID adalah nama proxy API, alur bersama, atau produk API yang ingin Anda pindahkan.

Memindahkan resource API antar-Ruang

Resource API dapat dipindahkan antar-Ruang di organisasi Apigee. Resource API yang dipindahkan ke Ruang mewarisi kebijakan IAM Ruang tersebut. Untuk memindahkan resource API di antara Ruang di organisasi Apigee, pengguna harus memiliki izin berikut:

  • apigee.RESOURCE_TYPE.move untuk Ruang tempat resource API saat ini ada.

    Nilai yang valid untuk RESOURCE_TYPE mencakup proxies, sharedflows, atau apiproducts, bergantung pada jenis resource API yang dipindahkan.

  • apigee.RESOURCE_TYPE.create untuk Ruang tempat resource API akan dipindahkan.

    Nilai yang valid untuk RESOURCE_TYPE mencakup proxies, sharedflows, atau apiproducts, bergantung pada jenis resource API yang dipindahkan.

Pengguna yang diberi peran apigee.spaceContentEditor untuk kedua Ruang akan memiliki izin yang diperlukan.

Untuk memindahkan resource API antar-Ruang di organisasi Apigee, gunakan perintah berikut: 

curl "https://apigee.googleapis.com/v1/organizations/ORG_NAME/RESOURCE_TYPE/RESOURCE_ID:move?space=SPACE_NAME" \
  -X POST -H "Authorization: Bearer $TOKEN"

Dengan keterangan:

  • ORG_NAME adalah nama organisasi Apigee Anda.
  • RESOURCE_TYPE adalah jenis resource yang Anda cantumkan. Nilai yang valid mencakup:
    • apis
    • sharedflows
    • apiproducts
  • RESOURCE_ID adalah nama proxy API, alur bersama, atau produk API yang ingin Anda pindahkan.
  • SPACE_NAME adalah nama Ruang baru.

Misalnya, pengguna dengan izin apigee.proxies.move untuk Ruang red dan izin apigee.proxies.create untuk Ruang blue dapat menggunakan perintah berikut untuk memindahkan proxy API demo dari Ruang red ke Ruang blue: 

curl "https://apigee.googleapis.com/v1/organizations/acme/apis/demo:move?space=blue" \
  -X POST -H "Authorization: Bearer $TOKEN"

Responsnya akan terlihat seperti berikut: 

{
  "basepaths": ["/demo"],
  "revision": 1,
  "apiProxyId": "demo",
  "space_id": "blue",
  "createTime": ...,
  "updateTime": ...
}

Dalam contoh ini, pengguna tidak perlu memiliki izin di tingkat organisasi, hanya izin yang diperlukan yang ditetapkan oleh setiap binding setIamPolicy Ruang.

Mencoba memindahkan proxy API demo tanpa izin yang benar untuk kedua Ruang akan mengakibatkan error berikut: 

  {
    "error": {
      "code": 403,
      "message": "Permission denied on resource \"organizations\/acme\/apis\/demo\" (or it may not exist).",
      "status": "PERMISSION_DENIED"
    }
  }