Update atribut layanan endpoint PrivateLink - PrivateLink - Alibaba Cloud - PrivateLink

Mengubah atribut layanan titik akhir.

Deskripsi operasi

Sebelum Anda mengubah atribut layanan titik akhir, pastikan layanan titik akhir berada dalam status Active. Anda dapat memanggil operasi GetVpcEndpointServiceAttribute untuk mengkueri status layanan titik akhir.
Operasi UpdateVpcEndpointServiceAttribute tidak mendukung modifikasi atribut layanan titik akhir secara bersamaan dalam satu akun Alibaba Cloud.

Coba sekarang

Coba API ini di OpenAPI Explorer tanpa perlu penandatanganan manual. Panggilan yang berhasil akan secara otomatis menghasilkan contoh kode SDK sesuai dengan parameter Anda. Unduh kode tersebut dengan kredensial bawaan yang aman untuk penggunaan lokal.

Test

RAM authorization

Tabel berikut menjelaskan otorisasi yang diperlukan untuk memanggil API ini. Anda dapat menentukannya dalam kebijakan Resource Access Management (RAM). Kolom pada tabel dijelaskan sebagai berikut:

Action: Aksi yang dapat digunakan dalam elemen Action pada pernyataan kebijakan izin RAM untuk memberikan izin guna melakukan operasi tersebut.
API: API yang dapat Anda panggil untuk melakukan aksi tersebut.
Access level: Tingkat akses yang telah ditentukan untuk setiap API. Nilai yang valid: create, list, get, update, dan delete.
Resource type: Jenis resource yang mendukung otorisasi untuk melakukan aksi tersebut. Ini menunjukkan apakah aksi tersebut mendukung izin tingkat resource. Resource yang ditentukan harus kompatibel dengan aksi tersebut. Jika tidak, kebijakan tersebut tidak akan berlaku.
- Untuk API dengan izin tingkat resource, jenis resource yang diperlukan ditandai dengan tanda bintang (*). Tentukan Nama Sumber Daya Alibaba Cloud (ARN) yang sesuai dalam elemen Resource pada kebijakan.
- Untuk API tanpa izin tingkat resource, ditampilkan sebagai All Resources. Gunakan tanda bintang (*) dalam elemen Resource pada kebijakan.
Condition key: Kunci kondisi yang didefinisikan oleh layanan. Kunci ini memungkinkan kontrol granular, berlaku baik hanya untuk aksi maupun untuk aksi yang terkait dengan resource tertentu. Selain kunci kondisi spesifik layanan, Alibaba Cloud menyediakan serangkaian common condition keys yang berlaku di semua layanan yang didukung RAM.
Dependent action: Aksi dependen yang diperlukan untuk menjalankan aksi tersebut. Untuk menyelesaikan aksi tersebut, pengguna RAM atau role RAM harus memiliki izin untuk melakukan semua aksi dependen.

Action

Access level

Resource type

Condition key

Dependent action

privatelink:UpdateVpcEndpointServiceAttribute

update

*VpcEndpointService

acs:privatelink:{#regionId}:{#accountId}:vpcendpointservice/{#ServiceId}

None

Parameter permintaan

Parameter	Type	Required	Description	Example
RegionId	string	Yes	ID wilayah layanan titik akhir. Anda dapat memanggil operasi DescribeRegions untuk mengkueri daftar wilayah terbaru.	cn-hangzhou
ClientToken	string	No	Token klien yang digunakan untuk memastikan idempotensi permintaan. Anda dapat menggunakan klien untuk menghasilkan token, tetapi Anda harus memastikan token tersebut unik di antara permintaan yang berbeda. Parameter ClientToken hanya mendukung karakter ASCII.	0c593ea1-3bea-11e9-b96b-88e9fe637760
DryRun	boolean	No	Apakah akan menjalankan dry run saja, tanpa menjalankan permintaan aktual. Nilai valid: true: Hanya menjalankan dry run. Sistem memeriksa permintaan untuk potensi masalah, termasuk nilai parameter yang hilang, sintaks permintaan yang salah, dan batas layanan. Jika permintaan gagal dalam dry run, kode kesalahan akan dikembalikan. Jika permintaan berhasil dalam dry run, kode kesalahan `DryRunOperation` akan dikembalikan. false (default): Menjalankan dry run dan menjalankan permintaan aktual. Jika permintaan berhasil dalam dry run, kode status HTTP 2xx akan dikembalikan dan atribut Sumber daya akan diubah.	false
ServiceId	string	Yes	ID layanan titik akhir.	epsrv-hp3vpx8yqxblby3i****
ServiceDescription	string	No	Deskripsi layanan titik akhir.	This is my EndpointService.
AutoAcceptEnabled	boolean	No	Apakah akan menerima koneksi Titik akhir secara otomatis. Nilai valid: true: Menerima koneksi Titik akhir secara otomatis. false: Tidak menerima koneksi Titik akhir secara otomatis.	false
ConnectBandwidth	integer	No	Batas bandwidth default. Nilai default: 3072. Unit: Mbit/s. Nilai valid: 100 hingga 10240. Catatan Pengaturan untuk batas bandwidth default didukung ketika sumber daya layanan adalah instans Classic Load Balancer (CLB) atau instans Application Load Balancer (ALB). Ketika sumber daya layanan adalah instans Network Load Balancer (NLB), bandwidth koneksi tidak dapat dikonfigurasi.	3072
ZoneAffinityEnabled	boolean	No	Apakah akan resolve nama domain endpoint yang terhubung ke layanan titik akhir ke titik akses terdekat. Nilai valid: true (default): Ya. false: Tidak.	true
RegionId	string	Yes	ID wilayah layanan titik akhir. Anda dapat memanggil operasi DescribeRegions untuk mengkueri daftar wilayah terbaru.	cn-hangzhou
ServiceSupportIPv6 `deprecated`	boolean	No	Apakah layanan titik akhir mendukung IPv6. Nilai valid: true: Ya. false (default): Tidak.	false
AddressIpVersion	string	No	Versi protokol. Nilai valid: IPv4: IPv4. DualStack: dual-stack. Catatan Saat ini, hanya layanan titik akhir yang tipe Sumber daya backend-nya adalah NLB atau GWLB yang mendukung pengaturan protokol alamat IP ke DualStack.	IPv4
AddSupportedRegionSet	array	No	Daftar wilayah jarak jauh yang akan ditambahkan untuk layanan titik akhir.
	string	No	ID wilayah jarak jauh yang akan ditambahkan untuk layanan titik akhir.	cn-huhehaote
DeleteSupportedRegionSet	array	No	Daftar wilayah jarak jauh yang akan dihapus dari layanan titik akhir.
	string	No	ID wilayah jarak jauh yang akan dihapus dari layanan titik akhir.	cn-beijing

Elemen respons

Element	Type	Description	Example
	object	ID permintaan.
RequestId	string	ID permintaan.	8D8992C1-6712-423C-BAC5-E5E817484C6B

Contoh

Respons sukses

JSONformat

{
  "RequestId": "8D8992C1-6712-423C-BAC5-E5E817484C6B"
}

Kode kesalahan

HTTP status code	Error code	Error message
400	EndpointServiceNotFound	The specified Service does not exist.
400	EndpointServiceLocked	The specified Service is locked.
400	EndpointServiceOperationDenied	The specified operation of endpoint service is not allowed.
400	IllegalParamFormat.%s	The param format of %s is illegal.
400	OperationDenied.PrivateServiceDomainBusinessStatus	The operation is not allowed because of PrivateServiceDomainBusinessStatus.
400	MissingParam.%s	The param of %s is missing.
400	ServiceResourceNotSupportIpv6	The resource is not support ipv6.
400	EndpointServiceDowngradeNotAllowed	The EndpointService is not allowed for downgrade.
400	DependencyViolation.PrivateDnsName	The specified resource of %s depends on %s, so the operation cannot be completed.
400	OperationDenied.PrivateDomainNotSupport	The operation is not allowed because of PrivateDomainNotSupport.
400	OperationDenied.PrivateDomainStatusNotSupport	The operation is not allowed because of %s.
400	Conflict.ServiceName	The ServiceName %s is conflict.
400	InvalidParam.PrivateDnsName	The parameter of PrivateDnsName is illegal, which needs to end with aliyun.com, aliyun-inc.com, or aliyuncs.com.
400	OperationDenied.ResourceTypeNotSupportDualStack	The specified resource type does not support dualstack.
400	OperationDenied.ServiceResourceIpVersionMismatch	The endpoint service and service resource AddressIpVersion do not match.
400	EndpointServiceConnectionDependence	There are connections between the endpoint service and the dualstack endpoint, the endpoint service address ip version not support switching from dualstack to ipv4.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.