Otomatisasi prohibit status domain dengan Gateway OTE API - Alibaba Cloud DNS - Alibaba Cloud - Alibaba Cloud DNS

Memperbarui status sisi server nama domain.

Deskripsi operasi

This operation updates the server-side status of a domain name.

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

alidns:UpdateRspDomainServerProhibitStatusForGatewayOte

update

*全部资源

*

None

Sintaks permintaan

POST  HTTP/1.1

Parameter permintaan

Parameter	Type	Required	Description	Example
ClientToken	string	Yes	Token idempotensi.	qwoefasdf
DomainName	string	Yes	Nama domain.	example.com
AddStatusList	array<object>	No	Daftar status nama domain yang akan ditambahkan.
	object	No	The collection of domain statuses to add.
Status	string	No	Domain name status.	serverDeleteProhibited
StatusMsg	string	No	Description of the status.	实名认证未通过，增加serverUpdateProhibited状态
DeleteStatusList	array<object>	No	Daftar status nama domain yang akan dihapus.
	object	No	The collection of domain statuses to delete.
Status	string	No	Domain name status.	serverDeleteProhibited
StatusMsg	string	No	Description of the status.	实名认证通过，删除serverUpdateProhibited状态

Elemen respons

Element	Type	Description	Example
	object	Response schema.
RequestId	string	Unique ID of the request.	0629502C-6224-5DC9-A8ED-2ED73A2E3931
Success	boolean	Indicates whether the request succeeded. `true`: succeeded. `false`: failed.	true
RecoverableError	boolean	Indicates whether you can retry the request after failure. `true`: retry is allowed. `false`: retry is not allowed.	true
Data	object	List of returned data items.
DomainName	string	Domain name.	example.com
StatusList	array<object>	Status information for the task
	object	Status information for the task
DomainName	string	Domain name.	example.com
Status	string	Current domain name status.	serverUpdateProhibited
StatusMsg	string	Description of the domain name status.	实名认证未通过，增加serverUpdateProhibited状态
AccessDeniedDetail	object	Detailed access-denied information. This field appears only when RAM authentication fails.
AuthAction	string	The unauthorized operation that was attempted.	UpdateRspDomainServerProhibitStatusForGatewayOte
AuthPrincipalDisplayName	string	Display name of the authenticated entity.	2015555733387XXXX
AuthPrincipalOwnerId	string	Owner ID of the authenticated entity.	10469733312XXX
AuthPrincipalType	string	Identity type.	SubUser
EncodedDiagnosticMessage	string	Encrypted diagnostic message.	AQFohtp4aIbaeEXXXXQxNjFDLUIzMzgtNTXXXX05NkFCLUI2RkY5XXXXzAzQQ==
NoPermissionType	string	Reason for authentication failure. Valid values: ExplicitDeny ImplicitDeny	ImplicitDeny
PolicyType	string	Policy type.	DlpSend

Contoh

Respons sukses

JSONformat

{
  "RequestId": "0629502C-6224-5DC9-A8ED-2ED73A2E3931",
  "Success": true,
  "RecoverableError": true,
  "Data": {
    "DomainName": "example.com",
    "StatusList": [
      {
        "DomainName": "example.com",
        "Status": "serverUpdateProhibited",
        "StatusMsg": "实名认证未通过，增加serverUpdateProhibited状态"
      }
    ]
  },
  "AccessDeniedDetail": {
    "AuthAction": "UpdateRspDomainServerProhibitStatusForGatewayOte",
    "AuthPrincipalDisplayName": "2015555733387XXXX",
    "AuthPrincipalOwnerId": "10469733312XXX",
    "AuthPrincipalType": "SubUser",
    "EncodedDiagnosticMessage": "AQFohtp4aIbaeEXXXXQxNjFDLUIzMzgtNTXXXX05NkFCLUI2RkY5XXXXzAzQQ==",
    "NoPermissionType": "ImplicitDeny",
    "PolicyType": "DlpSend"
  }
}

Kode kesalahan

HTTP status code	Error code	Error message	Description
400	Alirs.Operator.NotAuthorized	The operator does not belong to the cloud account.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.