Pada langkah ini, Anda akan membuat organisasi Apigee.
Untuk membuat dan menyediakan organisasi baru:
-
Pada command line, dapatkan kredensial autentikasi
gcloud
menggunakan perintah berikut:Linux / MacOS
export 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.
Windows
for /f "tokens=*" %a in ('gcloud auth print-access-token') do set TOKEN=%a
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.
-
Pada Langkah 1, Anda membuat variabel lingkungan
PROJECT_ID
. Tambahkan variabel lingkungan berikut:Linux / MacOS
export ORG_NAME=$PROJECT_ID
export ANALYTICS_REGION="ANALYTICS_REGION"
export RUNTIMETYPE=HYBRID
Windows
set ORG_NAME=$PROJECT_ID
set ANALYTICS_REGION="ANALYTICS_REGION"
set RUNTIMETYPE=HYBRID
Dengan keterangan:
ORG_NAME
(Wajib): Nilai ini harus cocok denganPROJECT_ID
.ANALYTICS_REGION
(Wajib): Wilayah utama untuk penyimpanan data analisis, dengan variabel ditetapkan ke salah satu dari berikut:asia-northeast1
asia-south1
asia-east1
asia-southeast1
australia-southeast1
us-central1
us-east1
us-west1
asia-southeast2
europe-west1
europe-west2
Pilih region yang berdekatan atau yang memenuhi persyaratan penyimpanan organisasi Anda.
-
RUNTIMETYPE
(Wajib): Harus ditetapkan keHYBRID
.
- Panggil Apigee API berikut untuk membuat organisasi:
curl -H "Authorization: Bearer $TOKEN" -X POST -H "content-type:application/json" \ -d '{ "name":"'"$ORG_NAME"'", "runtimeType":"'"$RUNTIMETYPE"'", "analyticsRegion":"'"$ANALYTICS_REGION"'" }' \ "https://apigee.googleapis.com/v1/organizations?parent=projects/$PROJECT_ID"
Pada permintaan pembuatan yang berhasil, API organisasi akan merespons dengan pesan yang mirip dengan berikut ini:
{ "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 adalahIN_PROGRESS
. Proses ini dapat memerlukan waktu beberapa menit.Jika terjadi error, lihat Memecahkan masalah pembuatan organisasi.
- 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
- Anda dapat memeriksa status operasi yang berjalan lama yang ID-nya ditampilkan oleh permintaan pembuatan. 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", "description": "", "createdAt": "1626237148461", "lastModifiedAt": "1626237149384", "properties": { "property": [ { "name": "features.hybrid.enabled", "value": "true" }, { "name": "features.mart.connect.enabled", "value": "true" } ] }, "analyticsRegion": "ANALYTICS_REGION", "runtimeType": "HYBRID", "subscriptionType": "TRIAL", "state": "ACTIVE", "billingType": "EVALUATION", "expiresAt": "1631421073171", "addonsConfig": { "advancedApiOpsConfig": {}, "integrationConfig": {}, "monetizationConfig": {} } } }
Anda dapat menggunakan Apigee organizations API untuk mengambil informasi tentang organisasi setelah dibuat. Contoh:
curl -H "Authorization: Bearer $TOKEN" \ "https://apigee.googleapis.com/v1/organizations/$ORG_NAME"
Respons terhadap permintaan Anda berisi detail tentang organisasi yang ditentukan dalam format JSON.
{ "name": "apigee-example", "createdAt": "1626237148461", "lastModifiedAt": "1626237149384", "properties": { "property": [ { "name": "features.hybrid.enabled", "value": "true" }, { "name": "features.mart.connect.enabled", "value": "true" } ] }, "analyticsRegion": "us-west1", "runtimeType": "HYBRID", "subscriptionType": "TRIAL", "projectId": "apigee-example", "state": "ACTIVE", "billingType": "EVALUATION", "expiresAt": "1631421073171", "addonsConfig": { "advancedApiOpsConfig": {}, "integrationConfig": {}, "monetizationConfig": {} } }
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" } ] } }
Tabel berikut berisi daftar error yang mungkin Anda terima dan potensi penyelesaiannya saat Anda mencoba membuat organisasi baru:
Kode Error HTTP | Kesalahan HTTP | Deskripsi |
---|---|---|
400 |
Invalid JSON payload received |
Struktur data dalam permintaan Anda berisi error sintaksis atau jalur ke endpoint salah. |
400 |
Invalid organization ID |
ID organisasi yang Anda minta tidak boleh berisi huruf besar atau karakter khusus selain tanda hubung. Nama ini hanya boleh berisi huruf kecil, angka, dan/atau tanda hubung. Deskripsi dapat berisi maksimum 32 karakter. |
400 |
Unsupported analytics region |
Anda tidak menentukan nilai analyticsRegion dalam isi permintaan, atau nilai yang Anda tentukan bukan salah satu opsi yang valid. |
400 |
Does not have an Apigee entitlement |
Project Google Cloud Anda (yang Anda buat di Langkah 2: Buat project Google Cloud) belum diaktifkan secara hybrid. Hal ini dapat menunjukkan adanya masalah pada penagihan Anda atau error lain yang terkait dengan akun Google Cloud Anda. Untuk mengetahui informasi selengkapnya, hubungi Bagian Penjualan Apigee. |
401 |
Request had invalid authentication credentials |
Token autentikasi gcloud Anda buruk atau sudah tidak berlaku, atau Anda tidak menyertakannya dalam permintaan. Buat token baru dan kirim ulang alamat tersebut. |
403 |
Permission denied on resource project project_ID |
Anda mungkin telah mengirim permintaan yang berisi project ID atau jalur yang salah. |
403 |
Unable to retrieve project information |
Organisasi belum dibuat atau disediakan. Anda dapat mengajukan permintaan ke Operations API untuk memeriksa status operasi yang berjalan lama, seperti yang dijelaskan pada langkah 5. |
409 |
Organization already exists |
Anda mencoba membuat lebih dari satu organisasi untuk project Google Cloud. Anda hanya dapat membuat satu organisasi per project. |
409 |
Org proposed_org_name already exists |
Anda mencoba membuat organisasi yang memiliki ID yang sama dengan yang sudah ada. ID organisasi harus unik di seluruh pelanggan hybrid. Kirim ulang dengan ID organisasi baru yang diusulkan; misalnya, tambahkan nilai numerik ke akhir ID sebelumnya yang telah Anda coba. |
Langkah berikutnya
Lanjutkan ke Langkah 3: Buat grup lingkungan.