Perbarui Organisasi - Alibaba Cloud Model Studio

Prasyarat

Anda telah memperoleh AccessKey dari akun Alibaba Cloud atau pengguna RAM, dan identitas tersebut telah diberikan izin RAM yang diperlukan untuk memanggil operasi ini. Kami menyarankan Anda menetapkan AccessKey sebagai variabel lingkungan ALIBABA_CLOUD_ACCESS_KEY_ID dan ALIBABA_CLOUD_ACCESS_KEY_SECRET alih-alih meng-hardcode-nya.

Deskripsi permintaan

Metode HTTP: POST
URL Permintaan
Wilayah
Endpoint
Singapura
POST https://modelstudio.ap-southeast-1.aliyuncs.com/tokenplan/organization
Autentikasi Operasi ini adalah operasi Alibaba Cloud OpenAPI yang menggunakan tanda tangan berbasis AccessKey (algoritma ACS3-HMAC-SHA256). Skema Authorization: Bearer {API_KEY} tidak didukung. Permintaan harus menyertakan header umum x-acs-action: UpdateOrganization, x-acs-version: 2026-02-10, x-acs-date, x-acs-content-sha256, x-acs-signature-nonce, dan Authorization. Kami menyarankan Anda memanggil operasi ini dengan Alibaba Cloud SDK atau OpenAPI Explorer sehingga Anda tidak perlu menghitung tanda tangan sendiri.

Wilayah	Endpoint
Singapura	`POST https://modelstudio.ap-southeast-1.aliyuncs.com/tokenplan/organization`

Parameter permintaan

Semua parameter diteruskan dalam query string.

Parameter	Tipe	Wajib	Deskripsi
Name	string	Tidak	Nama organisasi.
Description	string	Tidak	Deskripsi organisasi.

Parameter respons

Parameter	Tipe	Deskripsi
Success	boolean	Apakah panggilan API berhasil: true: berhasil false: gagal
Code	string	Kode status respons.
Message	string	Pesan respons.
Data	object	Data bisnis.
OrgId	string	ID Organisasi.
NamespaceId	string	ID namespace produk.
Name	string	Nama organisasi.
Description	string	Deskripsi organisasi.
Status	string	Status ACTIVE FROZEN
OwnerId	string	ID akun UAC pemilik organisasi.
OwnerBizAccountId	string	Pengenal akun bisnis pemilik organisasi (tipe ALIYUN: aliyunUid, tipe SSO: userIdentifier).
GmtCreate	string	Waktu pembuatan.
GmtModified	string	Waktu modifikasi.
HttpStatusCode	integer	Kode status HTTP.
RequestId	string	ID permintaan unik.

Contoh permintaan

Operasi ini menggunakan tanda tangan Alibaba Cloud OpenAPI. Dalam contoh berikut, ${SIGNATURE} harus dihitung dengan algoritma ACS3-HMAC-SHA256, dan x-acs-date serta x-acs-signature-nonce harus diganti dengan nilai aktual.

curl -X POST "https://modelstudio.ap-southeast-1.aliyuncs.com/tokenplan/organization?Name=New%20organization%20name&Description=New%20organization%20description" \
    --header "x-acs-action: UpdateOrganization" \
    --header "x-acs-version: 2026-02-10" \
    --header "x-acs-date: 2026-01-01T12:00:00Z" \
    --header "x-acs-content-sha256: e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855" \
    --header "x-acs-signature-nonce: 3e3b2a9f0c7d4f8e9a1b2c3d4e5f6a7b" \
    --header "Authorization: ACS3-HMAC-SHA256 Credential=${ALIBABA_CLOUD_ACCESS_KEY_ID},SignedHeaders=host;x-acs-action;x-acs-content-sha256;x-acs-date;x-acs-signature-nonce;x-acs-version,Signature=${SIGNATURE}"

Contoh respons

{
  "Success": true,
  "Data": {
    "OrgId": "org_123456789",
    "NamespaceId": "namespace-1",
    "Name": "组织名称",
    "Description": "组织描述",
    "Status": "ACTIVE",
    "OwnerId": "acc_123456789",
    "OwnerBizAccountId": "1269388320468566",
    "GmtCreate": "2025-12-11T02:19:27Z",
    "GmtModified": "2025-07-08 13:59:11"
  }
}

Kode kesalahan

Jika pemanggilan gagal, pesan kesalahan akan dikembalikan. Untuk kode kesalahan dan solusi selengkapnya, lihat Kode kesalahan.

​Prasyarat

​Deskripsi permintaan

​Parameter permintaan

​Parameter respons

​Contoh permintaan

​Contoh respons