Taal

DownstreamApiOptionsReadOnlyHttpMethod Klas

Definitie

Specialisatie van DownstreamApiOptions waar de HttpMethod niet kan worden ingesteld buiten de constructie.

public class DownstreamApiOptionsReadOnlyHttpMethod : Microsoft.Identity.Abstractions.DownstreamApiOptions
type DownstreamApiOptionsReadOnlyHttpMethod = class
    inherit DownstreamApiOptions
Public Class DownstreamApiOptionsReadOnlyHttpMethod
Inherits DownstreamApiOptions
Overname
DownstreamApiOptionsReadOnlyHttpMethod

Opmerkingen

Deze klasse is handig om een betere ontwikkelaarservaring te bieden voor de gespecialiseerde methoden waar IDownstreamApi de HTTP-methode al wordt geleverd door de naam van de methode en mag niet worden overschreven door de opties. U hoeft deze niet rechtstreeks te gebruiken.

Constructors

Naam Description
DownstreamApiOptionsReadOnlyHttpMethod(DownstreamApiOptions, String)

Constructor van een DownstreamApiOptions en een HTTP-methode.

Eigenschappen

Naam Description
AcceptHeader

De HTTP Accept-header wordt gebruikt om de server te informeren over het inhoudstype dat de client verwacht in het antwoord.

(Overgenomen van DownstreamApiOptions)
AcquireTokenOptions

Opties met betrekking tot het verkrijgen van tokens.

(Overgenomen van AuthorizationHeaderProviderOptions)
BaseUrl

Basis-URL voor de aangeroepen downstream-web-API. Bijvoorbeeld "https://graph.microsoft.com/beta/".

(Overgenomen van AuthorizationHeaderProviderOptions)
ContentType

Inhoudstype van de hoofdtekst van de aanvraag.

(Overgenomen van DownstreamApiOptions)
CustomizeHttpRequestMessage

Biedt een mogelijkheid voor de aanroeper-app om de HttpRequestMessage aan te passen. Bijvoorbeeld om de kopteksten aan te passen. Dit wordt aangeroepen nadat het bericht is gevormd, inclusief de autorisatieheader en net voordat het bericht wordt verzonden.

(Overgenomen van AuthorizationHeaderProviderOptions)
Deserializer

Optionele de-serializer. Hiermee wordt de uitvoer van de web-API (indien van toepassing) gedeserialiseerd. Wanneer deze niet is opgegeven, wordt het volgende geretourneerd: JsonSerializer.Deserialize<TOutput>(content, new JsonSerializerOptions { PropertyNameCaseInsensitive = true });

(Overgenomen van DownstreamApiOptions)
ExtraHeaderParameters

Hiermee stelt u extra headers in de HTTP-aanvraag in op de downstream-web-API. Dit moet niet worden verward met een andere optie om de headers in de aanvraag in te stellen op de id-provider. Zie ExtraHeadersParameters voor dat scenario.

(Overgenomen van DownstreamApiOptions)
ExtraQueryParameters

Hiermee stelt u queryparameters voor de queryreeks in de HTTP-aanvraag in op de downstream-web-API. Dit moet niet worden verward met een andere optie om de queryparameters in de aanvraag in te stellen op de id-provider. Zie ExtraQueryParameters voor dat scenario.

(Overgenomen van DownstreamApiOptions)
HttpMethod

Http-methode kan alleen openbaar worden gelezen.

OnAfterAuthHeaderCreation

Biedt een mogelijkheid om de aanroeper-app aan te passen HttpRequestMessagenadat de autorisatieheader (inclusief de Authorization header) is ingesteld en net voordat het bericht wordt verzonden, het punt waarop de voltooide aanvraag kan worden gelezen of aangepast. Voorzien voor naamgeving van symmetrie met OnBeforeAuthHeaderCreation; het deelt deze timing met de bestaande CustomizeHttpRequestMessage, die nog steeds wordt aangeroepen voor achterwaartse compatibiliteit. Wanneer beide zijn ingesteld, worden ze op hetzelfde punt uitgevoerd, dus bellers mogen niet afhankelijk zijn van hun relatieve volgorde. Wijzig hier geen materiaal dat is gebonden door een aanvraagbindingsprotocol (SHRq//hb), omdat het wordt uitgevoerd na ondertekening; gebruik OnBeforeAuthHeaderCreation hiervoor.

(Overgenomen van AuthorizationHeaderProviderOptions)
OnBeforeAuthHeaderCreation

Biedt een mogelijkheid voor de aanroeper-app om de HttpRequestMessage autorisatieheader aan te passen voordat de autorisatieheader wordt gemaakt. Op dit moment is de Authorization koptekst nog niet aanwezig. Gebruik deze om de aanvraag vorm te geven die een aanvraagbindingsprotocol ondertekent, bijvoorbeeld een SignedHttpRequest (SHR) waarmee de query, headers of de hoofdtekst (de q//hb claims) aan het token worden gekoppeld, zodat de handtekening de voltooide aanvraag bedekt. Als u de aanvraag wilt bekijken of aanpassen nadat de header is gemaakt, gebruikt OnAfterAuthHeaderCreation u (of CustomizeHttpRequestMessage).

(Overgenomen van AuthorizationHeaderProviderOptions)
ProtocolScheme

Naam van het protocolschema dat wordt gebruikt om de autorisatieheader te maken. Standaard: Bearer.

(Overgenomen van AuthorizationHeaderProviderOptions)
RelativePath

Pad ten opzichte van ( BaseUrl bijvoorbeeld 'ik').

(Overgenomen van AuthorizationHeaderProviderOptions)
RequestAppToken

Hierin wordt beschreven of de downstream-API wordt aangeroepen namens de aanroepende service zelf (App-token) of namens een gebruiker die door de service wordt verwerkt (gebruikerstoken). Als truehet token namens de app wordt aangevraagd. Anders wordt deze namens de gebruiker gebruikt.

(Overgenomen van AuthorizationHeaderProviderOptions)
Scopes

Bereiken die nodig zijn om de downstream-web-API aan te roepen. Bijvoorbeeld user.read mail.read. Voor Microsoft identiteit, in het geval van toepassingstokens (token aangevraagd door de app namens zichzelf), moet er slechts één bereik zijn en moet deze eindigen op './default'.

(Overgenomen van DownstreamApiOptions)
Serializer

Optionele serializer. Hiermee wordt de invoer naar de web-API geserialiseerd (indien van toepassing). Wanneer deze standaard niet is opgegeven:

  • Als de invoer is afgeleid van HttpInput, wordt deze gebruikt zoals
  • Als de invoer een tekenreeks is die wordt gebruikt als een mediatype json.
  • Anders wordt het object geserialiseerd in JSON, met een UTF8-codering en een mediatype toepassing/json:
    new StringContent(JsonSerializer.Serialize(input), Encoding.UTF8, "application/json")
    
(Overgenomen van DownstreamApiOptions)

Methoden

Naam Description
Clone()

De opties klonen

CloneInternal()

Kloon de opties (om ze te kunnen negeren).

GetApiUrl()

Retourneer de URL van de downstream-web-API.

(Overgenomen van AuthorizationHeaderProviderOptions)

Van toepassing op