Langkah 4: Buat organisasi

Anda telah membuat akun dan project Google Cloud serta mengaktifkan API. Sekarang Anda dapat membuat organisasi.

Prasyarat

Untuk membuat organisasi, Anda harus memenuhi salah satu ketentuan berikut:

• Memiliki akun evaluasi. Akun evaluasi akan habis masa berlakunya setelah 60 hari. Pada saat itu, organisasi akan dihapus.
• Memiliki akun berbayar

Jika kedua hal tersebut tidak benar, Anda harus menghubungi Bagian Penjualan Apigee sebelum dapat melanjutkan.

Untuk membuat dan menyediakan organisasi baru:

1. Pada command line, dapatkan kredensial autentikasi gcloud, seperti yang ditunjukkan contoh berikut:

   TOKEN=$(gcloud auth print-access-token)

   Untuk memeriksa apakah token Anda sudah diisi, gunakan echo, seperti yang ditunjukkan contoh berikut:

   echo $TOKEN

   Ini akan menampilkan token Anda sebagai string yang dienkode.

   Untuk mengetahui informasi selengkapnya, baca ringkasan alat command line gcloud.

2. Buat variabel lingkungan berikut untuk elemen-elemen organisasi. Anda akan menggunakannya dalam perintah untuk membuat organisasi.
   • PROJECT_ID (Wajib) adalah project Google Cloud yang ingin Anda kaitkan dengan organisasi baru yang mendukung hybrid. Ini adalah ID yang dibuat oleh Google untuk Anda pada Langkah 2: Buat project Google Cloud.

     export PROJECT_ID=your_project_id

     

   • ORG_NAME (Wajib) adalah ID terprogram yang Anda inginkan untuk organisasi yang mendukung hybrid.

     export ORG_NAME=$PROJECT_ID

   • ORG_DISPLAY_NAME (Opsional) adalah nama yang mudah digunakan untuk organisasi Anda. Nilai ini tidak harus unik, dan dapat berisi spasi serta karakter khusus. Misalnya, "Organisasi Hybrid Saya".

     ORG_DISPLAY_NAME="friendly_name"

     Konten nama variabel yang mengandung spasi harus diapit dalam tanda kutip ganda. Misalnya: "Organisasi Saya"

   • ORGANIZATION_DESCRIPTION (Opsional) adalah informasi tentang organisasi yang ingin Anda gunakan sebagai pengingat tujuannya. Misalnya, "Organisasi pertama saya".

     ORGANIZATION_DESCRIPTION="description_text"

   • ANALYTICS_REGION (Wajib) adalah region utama untuk penyimpanan data analisis.

     export ANALYTICS_REGION=analytics_region

     Dengan analytics_region adalah salah satu dari yang berikut:

     asia-northeast1	asia-south1	australia-southeast1
     us-central1	us-east1	us-west1
     europe-west2	europe-west1

     Pilih region yang berdekatan atau yang memenuhi persyaratan penyimpanan organisasi Anda.

   • RUNTIMETYPE (Wajib) adalah jenis runtime organisasi Apigee, dengan HYBRID adalah runtime hybrid Apigee yang dikelola pengguna.

     export RUNTIMETYPE=HYBRID

3. Kirim permintaan POST yang diautentikasi ke Create organizations API.

   Contoh berikut menunjukkan struktur permintaan yang membuat organisasi:

   curl -H "Authorization: Bearer $TOKEN" -X POST -H "content-type:application/json" \
     -d '{
       "name":"'"$ORG_NAME"'",
       "displayName":"'"$ORG_DISPLAY_NAME"'",
       "description":"'"$ORGANIZATION_DESCRIPTION"'",
       "runtimeType":"'"$RUNTIMETYPE"'",
       "analyticsRegion":"'"$ANALYTICS_REGION"'"
     }' \
     "https://apigee.googleapis.com/v1/organizations?parent=projects/$PROJECT_ID"

   Pada permintaan pembuatan yang berhasil, API organisasi harus merespons dengan pesan yang serupa seperti berikut:

   {
     "name": "organizations/org_name/operations/long_running_operation_ID",
     "metadata": {
       "@type": "type.googleapis.com/google.cloud.apigee.v1.OperationMetadata",
       "operationType": "INSERT",
       "targetResourceName": "organizations/org_name",
       "state": "IN_PROGRESS"
     }
   }

   Dengan keterangan:

   • long_running_operation_ID adalah UUID dari operasi asinkron yang berjalan lama. Anda dapat menggunakan ID ini untuk memeriksa status permintaan pembuatan organisasi (dijelaskan pada langkah 5).
   • org_name adalah ID organisasi baru Anda yang sedang dibuat.

   Seperti yang ditunjukkan oleh properti state dalam respons, Apigee sudah mulai membuat organisasi baru, sehingga statusnya adalah IN_PROGRESS. Proses ini dapat memerlukan waktu beberapa menit.

   Jika terjadi error, lihat Memecahkan masalah pembuatan organisasi.

4. Simpan ID operasi yang berjalan lama ke variabel lingkungan. Hal ini akan berguna untuk tugas manajemen di masa mendatang.

   Sintaksis

   export LONG_RUNNING_OPERATION_ID=long_running_operation_ID

   Contoh

   export LONG_RUNNING_OPERATION_ID=6abc8a72-46de-f9da-bcfe-70d9ab347e4f

5. Anda dapat memeriksa status operasi yang berjalan lama yang ID-nya ditampilkan Apigee pada permintaan pembuatan awal. Untuk melakukannya, gunakan Operations API. Contoh:

   curl -H "Authorization: Bearer $TOKEN" \
     "https://apigee.googleapis.com/v1/organizations/$ORG_NAME/operations/$LONG_RUNNING_OPERATION_ID"

   Contoh berikut menunjukkan kemungkinan respons untuk permintaan ini:

   IN_PROGRESS

   Jika Apigee masih membuat organisasi, Apigee akan merespons dengan status IN_PROGRESS. Contoh:

   {
       "name": "organizations/org_name/operations/long_running_operation_ID",
       "metadata": {
         "@type": "type.googleapis.com/google.cloud.apigee.v1.OperationMetadata",
         "operationType": "INSERT",
         "targetResourceName": "organizations/org_name",
         "state": "IN_PROGRESS"
       }
     }

   Sebaiknya tunggu lebih lama sebelum mencoba memverifikasi bahwa proses pembuatan telah selesai.

   SELESAI

   Setelah organisasi disediakan, status operasi yang berjalan lama adalah FINISHED. Contoh:

   {
     "name": "organizations/org_name/operations/long_running_operation_ID",
     "metadata": {
       "@type": "type.googleapis.com/google.cloud.apigee.v1.OperationMetadata",
       "operationType": "INSERT",
       "targetResourceName": "organizations/org_name",
       "state": "FINISHED"
     },
     "done": true,
     "response": {
       "@type": "type.googleapis.com/google.cloud.apigee.v1.Organization",
       "name": "org_name",
       "displayName": "display_name",
       "description": "description",
       "createdAt": "1600817805771",
       "lastModifiedAt": "1600817805771",
       "properties": {
         "property": [
           {
             "name": "features.hybrid.enabled",
             "value": "true"
           },
           {
             "name": "features.mart.connect.enabled",
             "value": "true"
           }
         ]
       },
       "analyticsRegion": "us-central1",
       "runtimeType": "HYBRID",
       "subscriptionType": "TRIAL"
     }
   }

   Jika Anda tidak memasukkan deskripsi, maka kolom tersebut tidak akan muncul dalam respons.

Lihat detail organisasi

Anda dapat melihat detail metadata untuk organisasi yang Anda buat menggunakan Apigee API. Anda juga dapat menggunakan API untuk menampilkan daftar semua organisasi yang dapat diakses oleh akun Google Cloud Anda. Untuk melakukan tindakan ini, gunakan organizations API.

Sebelum mencoba API, muat ulang token otorisasi Anda:

TOKEN=$(gcloud auth print-access-token)

https://apigee.googleapis.com/v1/organizations/org_name

curl -H "Authorization: Bearer $TOKEN" \
  "https://apigee.googleapis.com/v1/organizations/hybrid-example"

{
  "name": "organizations/org_name/operations/long_running_operation_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.apigee.v1.OperationMetadata",
    "operationType": "INSERT",
    "targetResourceName": "org_name",
    "state": "FINISHED"
  },
  "done": true,
  "response": {
    "@type": "type.googleapis.com/google.cloud.apigee.v1.Organization",
    "name": "org_name",
    "displayName": "display_name",
    "description": "description",
    "createdAt": "1600817805771",
    "lastModifiedAt": "1600817805771",
    "properties": {
      "property": [
        {
          "name": "features.hybrid.enabled",
          "value": "true"
        },
        {
          "name": "features.mart.connect.enabled",
          "value": "true"
        }
      ]
    },
    "analyticsRegion": "us-central1",
    "runtimeType": "HYBRID",
    "subscriptionType": "TRIAL"
  }
}

https://apigee.googleapis.com/v1/organizations

curl -H "Authorization: Bearer $TOKEN" "https://apigee.googleapis.com/v1/organizations"

{
  "organizations": [
    {
      "organization": "hybrid-example",
      "projectIds": [
        "hybrid-example"
      ]
    }
  ]
}

Memecahkan masalah pembuatan organisasi

Saat membuat organisasi dengan Create organizations API, Anda mungkin mendapatkan respons error. Responsnya akan terlihat seperti berikut:

{
  "error": {
    "code": HTTP_error_code,
    "message": "short_error_message",
    "status": "high_level_error_type",
    "details": [
      {
        "@type": "specific_error_type",
        "detail": "expanded_error_description"
      }
    ]
  }
}

Contoh berikut menunjukkan respons terhadap error umum—ID organisasi berisi karakter ilegal (karakter huruf besar tidak diizinkan di ID organisasi):

{
  "error": {
    "code": 400,
    "message": "invalid Organization ID \"MY-ORG\": \"MY-ORG\" is an invalid Organization ID",
    "status": "INVALID_ARGUMENT",
    "details": [
      {
        "@type": "",
        "detail": "[ORIGINAL ERROR] generic::invalid_argument: invalid Organization ID \"MY-ORG\":
          \"My-ORG\" is an invalid Organization ID [google.rpc.error_details_ext]
          { message: \"invalid Organization ID \\\"MY-ORG\\\": \\\"MY-ORG\\\" is an invalid
          Organization ID\" }"
      }
    ]
  }
}

Dalam hal ini, Anda dapat mengganti nama organisasi dengan huruf kecil dan mengirim ulang permintaan.

Tabel berikut berisi daftar error yang mungkin Anda terima dan potensi penyelesaiannya saat Anda mencoba membuat organisasi baru: