Import-AzApiManagementApi

Reference

Modul:: Az.ApiManagement

Importuje rozhraní API ze souboru nebo adresy URL.

Syntaxe

Import-AzApiManagementApi
      -Context <PsApiManagementContext>
      [-ApiId <String>]
      [-ApiRevision <String>]
      -SpecificationFormat <PsApiManagementApiFormat>
      -SpecificationPath <String>
      [-Path <String>]
      [-WsdlServiceName <String>]
      [-WsdlEndpointName <String>]
      [-ApiType <PsApiManagementApiType>]
      [-Protocol <PsApiManagementSchema[]>]
      [-ServiceUrl <String>]
      [-ApiVersionSetId <String>]
      [-ApiVersion <String>]
      [-DefaultProfile <IAzureContextContainer>]
      [<CommonParameters>]

Import-AzApiManagementApi
      -Context <PsApiManagementContext>
      [-ApiId <String>]
      [-ApiRevision <String>]
      -SpecificationFormat <PsApiManagementApiFormat>
      -SpecificationUrl <String>
      [-Path <String>]
      [-WsdlServiceName <String>]
      [-WsdlEndpointName <String>]
      [-ApiType <PsApiManagementApiType>]
      [-Protocol <PsApiManagementSchema[]>]
      [-ServiceUrl <String>]
      [-ApiVersionSetId <String>]
      [-ApiVersion <String>]
      [-DefaultProfile <IAzureContextContainer>]
      [<CommonParameters>]

Description

Rutina Import-AzApiManagementApi importuje rozhraní API služby Azure API Management ze souboru nebo adresy URL ve formátu WADL (Web Services Description Language), WSDL (Web Services Description Language) nebo Swagger.

Příklady

Příklad 1: Import rozhraní API ze souboru WADL

$ApiMgmtContext = New-AzApiManagementContext -ResourceGroupName "Api-Default-WestUS" -ServiceName "contoso"
Import-AzApiManagementApi -Context $ApiMgmtContext -SpecificationFormat "Wadl" -SpecificationPath "C:\contoso\specifications\echoapi.wadl" -Path "apis"

Tento příkaz naimportuje rozhraní API ze zadaného souboru WADL.

Příklad 2: Import rozhraní API ze souboru Swagger

$ApiMgmtContext = New-AzApiManagementContext -ResourceGroupName "Api-Default-WestUS" -ServiceName "contoso"
Import-AzApiManagementApi -Context $ApiMgmtContext -SpecificationFormat "Swagger" -SpecificationPath "C:\contoso\specifications\echoapi.swagger" -Path "apis"

Tento příkaz naimportuje rozhraní API ze zadaného souboru Swagger.

Příklad 3: Import rozhraní API ze souboru Swaggeru a aktualizace existujícího rozhraní API

$ApiMgmtContext = New-AzApiManagementContext -ResourceGroupName "Api-Default-WestUS" -ServiceName "contoso"
Import-AzApiManagementApi -Context $ApiMgmtContext -ApiId "26591405e27d4ff3a8d8478d7e60c7b0" -SpecificationFormat "Swagger" -SpecificationPath "C:\contoso\specifications\echoapi.swagger" -Path "apis"

Tento příkaz naimportuje rozhraní API ze zadaného souboru Swagger a aktualizuje existující rozhraní API.

Příklad 4: Import rozhraní API z odkazu WADL

$ApiMgmtContext = New-AzApiManagementContext -ResourceGroupName "Api-Default-WestUS" -ServiceName "contoso"
Import-AzApiManagementApi -Context $ApiMgmtContext -SpecificationFormat "Wadl" -SpecificationUrl "http://contoso.com/specifications/wadl/echoapi" -Path "apis"

Tento příkaz naimportuje rozhraní API ze zadaného odkazu WADL.

Příklad 5: Import rozhraní API z odkazu Open Api

$context = New-AzApiManagementContext -ResourceGroupName "Api-Default-WestUS" -ServiceName "contoso"
Import-AzApiManagementApi -Context $context -SpecificationFormat OpenApi -SpecificationUrl https://raw.githubusercontent.com/OAI/OpenAPI-Specification/master/examples/v3.0/petstore.yaml -Path "petstore30"

ApiId                         : af3f57bab399455aa875d7050654e9d1
Name                          : Swagger Petstore
Description                   :
ServiceUrl                    : http://petstore.swagger.io/v1
Path                          : petstore30
ApiType                       : http
Protocols                     : {Https}
AuthorizationServerId         :
AuthorizationScope            :
OpenidProviderId              :
BearerTokenSendingMethod      : {}
SubscriptionKeyHeaderName     : Ocp-Apim-Subscription-Key
SubscriptionKeyQueryParamName : subscription-key
ApiRevision                   : 1
ApiVersion                    :
IsCurrent                     : True
IsOnline                      : False
SubscriptionRequired          :
ApiRevisionDescription        :
ApiVersionSetDescription      :
ApiVersionSetId               :
Id                            : /subscriptions/subid/resourceGroups/Api-Default-West-US/providers/Microsoft.ApiManagement/service/contoso/apis/af3f57bab399455aa875d7050654e9d1     
ResourceGroupName             : Api-Default-West-US
ServiceName                   : contoso

Tento příkaz naimportuje rozhraní API ze zadaného odkazu specifikace Open 3.0.

Příklad 6: Import rozhraní API z odkazu Open Api do sady ApiVersion

$context = New-AzApiManagementContext -ResourceGroupName "Api-Default-WestUS" -ServiceName "contoso"
Import-AzApiManagementApi -Context $context -SpecificationPath "C:\contoso\specifications\uspto.yml" -SpecificationFormat OpenApi -Path uspostal -ApiVersionSetId 0d50e2cf-aaeb-4ea3-8a58-db9ec079c6cd -ApiVersion v2

ApiId                         : 6c3f20c66e5745b19229d06cd865948f
Name                          : USPTO Data Set API
Description                   : The Data Set API (DSAPI) allows the public users to discover and search USPTO exported data sets. This is a generic API that allows USPTO users to make any CSV based data files
                                searchable through API. With the help of GET call, it returns the list of data fields that are searchable. With the help of POST call, data can be fetched based on the filters on the    
                                field names. Please note that POST call is used to search the actual data. The reason for the POST call is that it allows users to specify any complex search criteria without worry      
                                about the GET size limitations as well as encoding of the input parameters.
ServiceUrl                    : https://developer.uspto.gov/ds-api
Path                          : uspostal
ApiType                       : http
Protocols                     : {Https}
AuthorizationServerId         :
AuthorizationScope            :
OpenidProviderId              :
BearerTokenSendingMethod      : {}
SubscriptionKeyHeaderName     : Ocp-Apim-Subscription-Key
SubscriptionKeyQueryParamName : subscription-key
ApiRevision                   : 1
ApiVersion                    : v2
IsCurrent                     : True
IsOnline                      : False
SubscriptionRequired          :
ApiRevisionDescription        :
ApiVersionSetDescription      :
ApiVersionSetId               : /subscriptions/subid/resourceGroups/Api-Default-East-US/providers/Microsoft.ApiManagement/service/contoso/apiVersionSets/0d50e2cf-aaeb-4ea3-8a58-db9ec079c6cd
Id                            : /subscriptions/subid/resourceGroups/Api-Default-East-US/providers/Microsoft.ApiManagement/service/contoso/apis/6c3f20c66e5745b19229d06cd865948f    
ResourceGroupName             : Api-Default-East-US
ServiceName                   : contoso

Tento příkaz naimportuje rozhraní API ze zadaného dokumentu specifikace Open 3.0 a vytvoří novou verzi ApiVersion.

Příklad 7: Import rozhraní API z odkazu GraphQL

$ApiMgmtContext = New-AzApiManagementContext -ResourceGroupName "Api-Default-WestUS" -ServiceName "contoso"
Import-AzApiManagementApi -Context $ApiMgmtContext -SpecificationFormat "GraphQL" -SpecificationUrl "http://contoso.com/graphql" -Path "graphqlapi"

ApiId                         : bg4g23csd067432zz853f0942341g3z1
Name                          : GraphQL Api
Description                   :
ServiceUrl                    : http://contoso.com/graphql
Path                          : graphqlapi
ApiType                       : graphql
Protocols                     : {Https}
AuthorizationServerId         :
AuthorizationScope            :
OpenidProviderId              :
BearerTokenSendingMethod      : {}
SubscriptionKeyHeaderName     : Ocp-Apim-Subscription-Key
SubscriptionKeyQueryParamName : subscription-key
ApiRevision                   : 1
ApiVersion                    :
IsCurrent                     : True
IsOnline                      : False
SubscriptionRequired          :
ApiRevisionDescription        :
ApiVersionSetDescription      :
ApiVersionSetId               :
Id                            : /subscriptions/subid/resourceGroups/Api-Default-West-US/providers/Microsoft.ApiManagement/service/contoso/apis/bg4g23csd067432zz853f0942341g3z1     
ResourceGroupName             : Api-Default-West-US
ServiceName                   : contoso

Tento příkaz naimportuje rozhraní API z odkazu GraphQL.

Parametry

-ApiId

Určuje ID, které má rozhraní API importovat. Pokud tento parametr nezadáte, vygeneruje se za vás ID.

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	False

-ApiRevision

Identifikátor revize rozhraní API. Tento parametr je volitelný. Pokud není zadaný, import se provede na aktuálně aktivní revizi nebo na nové rozhraní API.

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	False

-ApiType

Tento parametr je volitelný s výchozí hodnotou HTTP. Možnost Soap je použitelná pouze při importu WSDL a vytvoří rozhraní API passthrough PROTOKOLU SOAP.

Typ:	Nullable<T>[PsApiManagementApiType]
Přípustné hodnoty:	Http, Soap, WebSocket, GraphQL
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	False

-ApiVersion

Verze rozhraní API, která se má vytvořit. Tento parametr je volitelný.

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	False

-ApiVersionSetId

Identifikátor prostředku pro související sadu verzí rozhraní API. Tento parametr je volitelný.

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	False

-Context

Určuje PsApiManagementContext objektu.

Typ:	PsApiManagementContext
Position:	Named
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	False

-DefaultProfile

Přihlašovací údaje, účet, tenant a předplatné používané ke komunikaci s Azure.

Typ:	IAzureContextContainer
Aliasy:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-Path

Určuje cestu webového rozhraní API jako poslední část veřejné adresy URL rozhraní API. Tuto adresu URL používají příjemci rozhraní API k odesílání požadavků do webové služby. Musí mít délku 1 až 400 znaků. Výchozí hodnota je $Null.

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	False

-Protocol

Protokoly webového rozhraní API (http, https). Protokoly, u kterých je rozhraní API dostupné. Tento parametr je volitelný. Pokud je k dispozici, přepíše protokoly uvedené v dokumentu specifikace.

Typ:	PsApiManagementSchema[]
Přípustné hodnoty:	Http, Https, Ws, Wss
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	False

-ServiceUrl

Adresa URL webové služby, která rozhraní API vystavuje. Tuto adresu URL bude používat jenom azure API Management a nebude veřejná. Tento parametr je volitelný. Pokud je zadán, přepíše serviceUrl zadaný v dokumentu specifikace.

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	False

-SpecificationFormat

Určuje formát specifikace. psdx_paramvalues Wadl, Wsdl a Swagger.

Typ:	PsApiManagementApiFormat
Přípustné hodnoty:	Wadl, Swagger, Wsdl, OpenApi, OpenApiJson, GraphQL
Position:	Named
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	False

-SpecificationPath

Určuje cestu k souboru specifikace.

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	False

-SpecificationUrl

Určuje adresu URL specifikace.

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	False

-WsdlEndpointName

Místní název koncového bodu WSDL (port), který se má importovat. Musí mít délku 1 až 400 znaků. Tento parametr je volitelný a vyžaduje se pouze pro import wsdl. Výchozí hodnota je $null.

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	False

-WsdlServiceName

Místní název služby WSDL, která se má importovat. Musí mít délku 1 až 400 znaků. Tento parametr je volitelný a vyžaduje se pouze pro import wsdl . Výchozí hodnota je $null.

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	False

Vstupy

PsApiManagementContext

String

PsApiManagementApiFormat

Nullable<T>[[Microsoft.Azure.Commands.ApiManagement.ServiceManagement.Models.PsApiManagementApiType, Microsoft.Azure.PowerShell.Cmdlets.ApiManagement.ServiceManagement, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null]]

Výstupy

PsApiManagementApi

Sdílet prostřednictvím

Import-AzApiManagementApi

Syntaxe

Description

Příklady

Příklad 1: Import rozhraní API ze souboru WADL

Příklad 2: Import rozhraní API ze souboru Swagger

Příklad 3: Import rozhraní API ze souboru Swaggeru a aktualizace existujícího rozhraní API

Příklad 4: Import rozhraní API z odkazu WADL

Příklad 5: Import rozhraní API z odkazu Open Api

Příklad 6: Import rozhraní API z odkazu Open Api do sady ApiVersion

Příklad 7: Import rozhraní API z odkazu GraphQL

Parametry

-ApiId

-ApiRevision

-ApiType

-ApiVersion

-ApiVersionSetId

-Context

-DefaultProfile

-Path

-Protocol

-ServiceUrl

-SpecificationFormat

-SpecificationPath

-SpecificationUrl

-WsdlEndpointName

-WsdlServiceName

Vstupy

Výstupy

Další materiály

Sdílet prostřednictvím

Import-AzApiManagementApi

Syntaxe

Description

Příklady

Příklad 1: Import rozhraní API ze souboru WADL

Příklad 2: Import rozhraní API ze souboru Swagger

Příklad 3: Import rozhraní API ze souboru Swaggeru a aktualizace existujícího rozhraní API

Příklad 4: Import rozhraní API z odkazu WADL

Příklad 5: Import rozhraní API z odkazu Open Api

Příklad 6: Import rozhraní API z odkazu Open Api do sady ApiVersion

Příklad 7: Import rozhraní API z odkazu GraphQL

Parametry

-ApiId

-ApiRevision

-ApiType

-ApiVersion

-ApiVersionSetId

-Context

-DefaultProfile

-Path

-Protocol

-ServiceUrl

-SpecificationFormat

-SpecificationPath

-SpecificationUrl

-WsdlEndpointName

-WsdlServiceName

Vstupy

Výstupy

Související odkazy

Další materiály