Tenant Configuration - Save
Operasi ini membuat penerapan dengan rekam jepret konfigurasi saat ini ke cabang yang ditentukan di repositori. Ini adalah operasi yang berjalan lama dan bisa memakan waktu beberapa menit untuk diselesaikan.
POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/tenant/configuration/save?api-version=2022-08-01
Parameter URI
Nama | Dalam | Diperlukan | Jenis | Deskripsi |
---|---|---|---|---|
configuration
|
path | True |
Pengidentifikasi Operasi Konfigurasi Git. |
|
resource
|
path | True |
string |
Nama grup sumber daya. Nama tidak peka huruf besar/kecil. |
service
|
path | True |
string |
Nama layanan API Management. Regex pattern: |
subscription
|
path | True |
string |
ID langganan target. |
api-version
|
query | True |
string |
Versi API yang digunakan untuk operasi ini. |
Isi Permintaan
Nama | Diperlukan | Jenis | Deskripsi |
---|---|---|---|
properties.branch | True |
string |
Nama cabang Git untuk menerapkan rekam jepret konfigurasi saat ini. |
properties.force |
boolean |
Nilai jika true, database konfigurasi saat ini diterapkan ke repositori Git, bahkan jika repositori Git memiliki perubahan yang lebih baru yang akan ditimpa. |
Respons
Nama | Jenis | Deskripsi |
---|---|---|
200 OK |
Hasil pembuatan penerapan di repositori. |
|
202 Accepted |
Diterima: Header lokasi berisi URL tempat status operasi yang berjalan lama dapat diperiksa. |
|
Other Status Codes |
Respons kesalahan yang menjelaskan mengapa operasi gagal. |
Keamanan
azure_auth
Alur OAuth2 Azure Active Directory.
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
Nama | Deskripsi |
---|---|
user_impersonation | meniru akun pengguna Anda |
Contoh
ApiManagementTenantConfigurationSave
Sample Request
POST https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/tenant/configuration/save?api-version=2022-08-01
{
"properties": {
"branch": "master"
}
}
Sample Response
location: https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/tenant/operationResults/5a1af57d2a6d2e0b688d751b?api-version=2022-08-01
{
"id": "6074e652093a9d0dac3d733c",
"type": "Microsoft.ApiManagement/service/tenant/operationResults",
"name": "6074e652093a9d0dac3d733c",
"properties": {
"status": "Succeeded",
"started": "2021-04-13T00:31:14.94Z",
"updated": "2021-04-13T00:31:27.59Z",
"resultInfo": "The configuration was successfully saved to master as commit c0ae274f6046912107bad734834cbf65918668b6.",
"actionLog": []
}
}
Definisi
Nama | Deskripsi |
---|---|
Async |
Status operasi asinkron. |
configuration |
Pengidentifikasi Operasi Konfigurasi Git. |
Error |
Kontrak Bidang Kesalahan. |
Error |
Respons Kesalahan. |
Error |
Kontrak Isi Kesalahan. |
Operation |
Hasil Operasi Git yang Berjalan Lama. |
Operation |
Log entitas yang dibuat, diperbarui, atau dihapus. |
Save |
Simpan detail Kontrak Konfigurasi Penyewa. |
AsyncOperationStatus
Status operasi asinkron.
Nama | Jenis | Deskripsi |
---|---|---|
Failed |
string |
|
InProgress |
string |
|
Started |
string |
|
Succeeded |
string |
configurationIdName
Pengidentifikasi Operasi Konfigurasi Git.
Nama | Jenis | Deskripsi |
---|---|---|
configuration |
string |
ErrorFieldContract
Kontrak Bidang Kesalahan.
Nama | Jenis | Deskripsi |
---|---|---|
code |
string |
Kode kesalahan tingkat properti. |
message |
string |
Representasi kesalahan tingkat properti yang dapat dibaca manusia. |
target |
string |
Nama properti. |
ErrorResponse
Respons Kesalahan.
Nama | Jenis | Deskripsi |
---|---|---|
error.code |
string |
Kode kesalahan yang ditentukan layanan. Kode ini berfungsi sebagai sub-status untuk kode kesalahan HTTP yang ditentukan dalam respons. |
error.details |
Daftar bidang yang tidak valid dikirim dalam permintaan, jika terjadi kesalahan validasi. |
|
error.message |
string |
Representasi kesalahan yang dapat dibaca manusia. |
ErrorResponseBody
Kontrak Isi Kesalahan.
Nama | Jenis | Deskripsi |
---|---|---|
code |
string |
Kode kesalahan yang ditentukan layanan. Kode ini berfungsi sebagai sub-status untuk kode kesalahan HTTP yang ditentukan dalam respons. |
details |
Daftar bidang yang tidak valid dikirim dalam permintaan, jika terjadi kesalahan validasi. |
|
message |
string |
Representasi kesalahan yang dapat dibaca manusia. |
OperationResultContract
Hasil Operasi Git yang Berjalan Lama.
Nama | Jenis | Deskripsi |
---|---|---|
id |
string |
ID sumber daya yang sepenuhnya memenuhi syarat untuk sumber daya. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
name |
string |
Nama sumber daya. |
properties.actionLog |
Properti ini jika hanya disediakan sebagai bagian dari operasi TenantConfiguration_Validate. Ini berisi log entitas yang akan diperbarui/dibuat/dihapus sebagai bagian dari operasi TenantConfiguration_Deploy. |
|
properties.error |
Kontrak Isi Kesalahan |
|
properties.id |
string |
Pengidentifikasi hasil operasi. |
properties.resultInfo |
string |
Info hasil opsional. |
properties.started |
string |
Waktu mulai operasi asinkron. Tanggal sesuai dengan format berikut: |
properties.status |
Status operasi asinkron. |
|
properties.updated |
string |
Waktu pembaruan terakhir operasi asinkron. Tanggal sesuai dengan format berikut: |
type |
string |
Jenis sumber daya. Misalnya, "Microsoft.Compute/virtualMachines" atau "Microsoft.Storage/storageAccounts" |
OperationResultLogItemContract
Log entitas yang dibuat, diperbarui, atau dihapus.
Nama | Jenis | Deskripsi |
---|---|---|
action |
string |
Tindakan seperti membuat/memperbarui/menghapus. |
objectKey |
string |
Pengidentifikasi entitas yang dibuat/diperbarui/dihapus. |
objectType |
string |
Jenis kontrak entitas. |
SaveConfigurationParameter
Simpan detail Kontrak Konfigurasi Penyewa.
Nama | Jenis | Deskripsi |
---|---|---|
properties.branch |
string |
Nama cabang Git untuk menerapkan rekam jepret konfigurasi saat ini. |
properties.force |
boolean |
Nilai jika true, database konfigurasi saat ini diterapkan ke repositori Git, bahkan jika repositori Git memiliki perubahan yang lebih baru yang akan ditimpa. |