Delen via


Policy Fragment - Create Or Update

Hiermee wordt een beleidsfragment gemaakt of bijgewerkt.

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

URI-parameters

Name In Vereist Type Description
id
path True

string

Een resource-id.

Regex-patroon: (^[\w]+$)|(^[\w][\w\-]+[\w]$)

resourceGroupName
path True

string

De naam van de resourcegroep. De naam is niet hoofdlettergevoelig.

serviceName
path True

string

De naam van de API Management service.

Regex-patroon: ^[a-zA-Z](?:[a-zA-Z0-9-]*[a-zA-Z0-9])?$

subscriptionId
path True

string

De id van het doelabonnement.

api-version
query True

string

De API-versie die voor deze bewerking moet worden gebruikt.

Aanvraagkoptekst

Name Vereist Type Description
If-Match

string

ETag van de entiteit. Niet vereist bij het maken van een entiteit, maar vereist bij het bijwerken van een entiteit.

Aanvraagbody

Name Vereist Type Description
properties.value True

string

Inhoud van het beleidsfragment.

properties.description

string

Beschrijving van beleidsfragment.

properties.format

PolicyFragmentContentFormat

Indeling van de inhoud van het beleidsfragment.

Antwoorden

Name Type Description
200 OK

PolicyFragmentContract

Het beleidsfragment is bijgewerkt.

Kopteksten

ETag: string

201 Created

PolicyFragmentContract

Het beleidsfragment is gemaakt.

Kopteksten

ETag: string

202 Accepted

Aanvraag voor het maken of bijwerken van het beleidsfragment is geaccepteerd. De locatieheader bevat de URL waar de status van de langdurige bewerking kan worden gecontroleerd.

Kopteksten

location: string

Other Status Codes

ErrorResponse

Foutreactie waarin wordt beschreven waarom de bewerking is mislukt.

Beveiliging

azure_auth

Azure Active Directory OAuth2-stroom.

Type: oauth2
Stroom: implicit
Autorisatie-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiken

Name Description
user_impersonation Uw gebruikersaccount imiteren

Voorbeelden

ApiManagementCreatePolicy

Voorbeeldaanvraag

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>"
  }
}

Voorbeeldrespons

{
  "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

Definities

Name Description
ErrorFieldContract

Fout veldcontract.

ErrorResponse

Foutreactie.

PolicyFragmentContentFormat

Indeling van de inhoud van het beleidsfragment.

PolicyFragmentContract

Details van het beleidsfragmentcontract.

ErrorFieldContract

Fout veldcontract.

Name Type Description
code

string

Foutcode op eigenschapsniveau.

message

string

Door mensen leesbare weergave van fout op eigenschapsniveau.

target

string

Naam van eigenschap.

ErrorResponse

Foutreactie.

Name Type Description
error.code

string

Door de service gedefinieerde foutcode. Deze code fungeert als een substatus voor de HTTP-foutcode die is opgegeven in het antwoord.

error.details

ErrorFieldContract[]

De lijst met ongeldige velden verzenden in aanvraag, in geval van een validatiefout.

error.message

string

Door mensen leesbare weergave van de fout.

PolicyFragmentContentFormat

Indeling van de inhoud van het beleidsfragment.

Name Type Description
rawxml

string

De inhoud is inline en Inhoudstype is een niet-XML-gecodeerd beleidsdocument.

xml

string

De inhoud is inline en inhoudstype is een XML-document.

PolicyFragmentContract

Details van het beleidsfragmentcontract.

Name Type Default value Description
id

string

Volledig gekwalificeerde resource-id voor de resource. Bijvoorbeeld - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

name

string

De naam van de resource

properties.description

string

Beschrijving van beleidsfragment.

properties.format

PolicyFragmentContentFormat

xml

Indeling van de inhoud van het beleidsfragment.

properties.value

string

Inhoud van het beleidsfragment.

type

string

Het type resource. Bijvoorbeeld 'Microsoft.Compute/virtualMachines' of 'Microsoft.Storage/storageAccounts'