Bagikan melalui


Policy Fragment - Create Or Update

Membuat atau memperbarui fragmen kebijakan.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/policyFragments/{id}?api-version=2022-08-01

Parameter URI

Nama Dalam Diperlukan Jenis Deskripsi
id
path True

string

Pengidentifikasi sumber daya.

Pola regex: (^[\w]+$)|(^[\w][\w\-]+[\w]$)

resourceGroupName
path True

string

Nama grup sumber daya. Nama tidak peka huruf besar/kecil.

serviceName
path True

string

Nama layanan API Management.

Pola regex: ^[a-zA-Z](?:[a-zA-Z0-9-]*[a-zA-Z0-9])?$

subscriptionId
path True

string

ID langganan target.

api-version
query True

string

Versi API yang digunakan untuk operasi ini.

Header Permintaan

Nama Diperlukan Jenis Deskripsi
If-Match

string

ETag Entitas. Tidak diperlukan saat membuat entitas, tetapi diperlukan saat memperbarui entitas.

Isi Permintaan

Nama Diperlukan Jenis Deskripsi
properties.value True

string

Isi fragmen kebijakan.

properties.description

string

Deskripsi fragmen kebijakan.

properties.format

PolicyFragmentContentFormat

Format konten fragmen kebijakan.

Respons

Nama Jenis Deskripsi
200 OK

PolicyFragmentContract

Fragmen kebijakan berhasil diperbarui.

Header

ETag: string

201 Created

PolicyFragmentContract

Fragmen kebijakan berhasil dibuat.

Header

ETag: string

202 Accepted

Permintaan untuk membuat atau memperbarui fragmen kebijakan diterima. Header lokasi berisi URL tempat status operasi jangka panjang dapat diperiksa.

Header

location: string

Other Status Codes

ErrorResponse

Respons kesalahan yang menjelaskan mengapa operasi gagal.

Keamanan

azure_auth

Alur OAuth2 Azure Active Directory.

Jenis: oauth2
Alur: implicit
URL Otorisasi: https://login.microsoftonline.com/common/oauth2/authorize

Cakupan

Nama Deskripsi
user_impersonation meniru akun pengguna Anda

Contoh

ApiManagementCreatePolicy

Permintaan sampel

PUT https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/policyFragments/policyFragment1?api-version=2022-08-01

{
  "properties": {
    "format": "xml",
    "description": "A policy fragment example",
    "value": "<fragment><json-to-xml apply=\"always\" consider-accept-header=\"false\" /></fragment>"
  }
}

Respon sampel

{
  "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/policyFragments/policyFragment1",
  "type": "Microsoft.ApiManagement/service/policyFragments",
  "name": "policyFragment1",
  "properties": {
    "format": "xml",
    "description": "A policy fragment example",
    "value": "<json-to-xml apply=\"always\" consider-accept-header=\"false\" />"
  }
}
{
  "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/policyFragments/policyFragment1",
  "type": "Microsoft.ApiManagement/service/policyFragments",
  "name": "policyFragment1",
  "properties": {
    "format": "xml",
    "description": "A policy fragment example",
    "value": "<json-to-xml apply=\"always\" consider-accept-header=\"false\" />"
  }
}
location: https://management.azure.com/subscriptions/subid/resourcegroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/policyFragments/policyFragment1?api-version=2022-08-01&asyncId=5c730e343244df1b9cb56e85&asyncCode=201

Definisi

Nama Deskripsi
ErrorFieldContract

Kontrak Bidang Kesalahan.

ErrorResponse

Respons Kesalahan.

PolicyFragmentContentFormat

Format konten fragmen kebijakan.

PolicyFragmentContract

Detail kontrak fragmen kebijakan.

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

ErrorFieldContract[]

Daftar bidang yang tidak valid dikirim dalam permintaan, jika terjadi kesalahan validasi.

error.message

string

Representasi kesalahan yang dapat dibaca manusia.

PolicyFragmentContentFormat

Format konten fragmen kebijakan.

Nama Jenis Deskripsi
rawxml

string

Konten sebaris dan Tipe konten adalah dokumen kebijakan yang dikodekan non XML.

xml

string

Konten sebaris dan Tipe konten adalah dokumen XML.

PolicyFragmentContract

Detail kontrak fragmen kebijakan.

Nama Jenis Nilai default 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.description

string

Deskripsi fragmen kebijakan.

properties.format

PolicyFragmentContentFormat

xml

Format konten fragmen kebijakan.

properties.value

string

Isi fragmen kebijakan.

type

string

Jenis sumber daya. Misalnya, "Microsoft.Compute/virtualMachines" atau "Microsoft.Storage/storageAccounts"