Import-AzApiManagementApi

참조

모듈:: Az.ApiManagement

파일 또는 URL에서 API를 가져옵니다.

구문

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

Import-AzApiManagementApi cmdlet은 파일 또는 WADL(웹 애플리케이션 설명 언어), WSDL(웹 서비스 설명 언어) 또는 Swagger 형식의 URL에서 Azure API Management API를 가져옵니다.

예제

예제 1: WADL 파일에서 API 가져오기

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

이 명령은 지정된 WADL 파일에서 API를 가져옵니다.

예제 2: Swagger 파일에서 API 가져오기

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

이 명령은 지정된 Swagger 파일에서 API를 가져옵니다.

예제 3: Swagger 파일에서 API 가져오기 및 기존 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"

이 명령은 지정된 Swagger 파일에서 API를 가져오고 기존 API를 업데이트합니다.

예제 4: WADL 링크에서 API 가져오기

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

이 명령은 지정된 WADL 링크에서 API를 가져옵니다.

예제 5: Open Api Link에서 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

이 명령은 지정된 Open 3.0 사양 링크에서 API를 가져옵니다.

예제 6: Open Api Link에서 ApiVersion 집합으로 API 가져오기

$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

이 명령은 지정된 Open 3.0 사양 문서에서 API를 가져오고 새 ApiVersion을 만듭니다.

예제 7: GraphQL 링크에서 API 가져오기

$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

이 명령은 GraphQL 링크에서 API를 가져옵니다.

매개 변수

-ApiId

가져올 API의 ID를 지정합니다. 이 매개 변수를 지정하지 않으면 ID가 생성됩니다.

형식:	String
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	True
와일드카드 문자 허용:	False

-ApiRevision

API 수정 버전의 식별자입니다. 이 매개 변수는 선택 사항입니다. 지정하지 않으면 현재 활성 버전 또는 새 API로 가져오기가 수행됩니다.

형식:	String
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	True
와일드카드 문자 허용:	False

-ApiType

이 매개 변수는 Http의 기본값을 사용하는 선택 사항입니다. Soap 옵션은 WSDL을 가져올 때만 적용되며 SOAP 통과 API를 만듭니다.

형식:	Nullable<T>[PsApiManagementApiType]
허용되는 값:	Http, Soap, WebSocket, GraphQL
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	True
와일드카드 문자 허용:	False

-ApiVersion

만들 API의 API 버전입니다. 이 매개 변수는 선택 사항입니다.

형식:	String
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	True
와일드카드 문자 허용:	False

-ApiVersionSetId

관련 Api 버전 집합에 대한 리소스 식별자입니다. 이 매개 변수는 선택 사항입니다.

형식:	String
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	True
와일드카드 문자 허용:	False

-Context

PsApiManagementContext 개체를 지정합니다.

형식:	PsApiManagementContext
Position:	Named
Default value:	None
필수:	True
파이프라인 입력 허용:	True
와일드카드 문자 허용:	False

-DefaultProfile

Azure와의 통신에 사용되는 자격 증명, 계정, 테넌트 및 구독입니다.

형식:	IAzureContextContainer
별칭:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-Path

웹 API 경로를 API 공용 URL의 마지막 부분으로 지정합니다. 이 URL은 API 소비자가 웹 서비스에 요청을 보내는 데 사용됩니다. 길이는 1~400자여야 합니다. 기본값은 $Null.

형식:	String
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	True
와일드카드 문자 허용:	False

-Protocol

Web API 프로토콜(http, https). API를 사용할 수 있는 프로토콜입니다. 이 매개 변수는 선택 사항입니다. 제공된 경우 사양 문서에 지정된 프로토콜을 재정의합니다.

형식:	PsApiManagementSchema[]
허용되는 값:	Http, Https, Ws, Wss
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	True
와일드카드 문자 허용:	False

-ServiceUrl

API를 노출하는 웹 서비스의 URL입니다. 이 URL은 Azure API Management에서만 사용되며 공개되지 않습니다. 이 매개 변수는 선택 사항입니다. 제공된 경우 사양 문서에 지정된 ServiceUrl을 재정의합니다.

형식:	String
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	True
와일드카드 문자 허용:	False

-SpecificationFormat

사양 형식을 지정합니다. psdx_paramvalues Wadl, Wsdl 및 Swagger.

형식:	PsApiManagementApiFormat
허용되는 값:	Wadl, Swagger, Wsdl, OpenApi, OpenApiJson, GraphQL
Position:	Named
Default value:	None
필수:	True
파이프라인 입력 허용:	True
와일드카드 문자 허용:	False

-SpecificationPath

사양 파일 경로를 지정합니다.

형식:	String
Position:	Named
Default value:	None
필수:	True
파이프라인 입력 허용:	True
와일드카드 문자 허용:	False

-SpecificationUrl

사양 URL을 지정합니다.

형식:	String
Position:	Named
Default value:	None
필수:	True
파이프라인 입력 허용:	True
와일드카드 문자 허용:	False

-WsdlEndpointName

가져올 WSDL 엔드포인트(포트)의 로컬 이름입니다. 길이는 1~400자여야 합니다. 이 매개 변수는 선택 사항이며 Wsdl을 가져오는 데만 필요합니다. 기본값은 $null.

형식:	String
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	True
와일드카드 문자 허용:	False

-WsdlServiceName

가져올 WSDL 서비스의 로컬 이름입니다. 길이는 1~400자여야 합니다. 이 매개 변수는 선택 사항이며 Wsdl을 가져오는 데만 필요합니다. 기본값은 $null.

형식:	String
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	True
와일드카드 문자 허용:	False

입력

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]]

출력

PsApiManagementApi

다음을 통해 공유

Import-AzApiManagementApi

구문

Description

예제

예제 1: WADL 파일에서 API 가져오기

예제 2: Swagger 파일에서 API 가져오기

예제 3: Swagger 파일에서 API 가져오기 및 기존 API 업데이트

예제 4: WADL 링크에서 API 가져오기

예제 5: Open Api Link에서 API 가져오기

예제 6: Open Api Link에서 ApiVersion 집합으로 API 가져오기

예제 7: GraphQL 링크에서 API 가져오기

매개 변수

-ApiId

-ApiRevision

-ApiType

-ApiVersion

-ApiVersionSetId

-Context

-DefaultProfile

-Path

-Protocol

-ServiceUrl

-SpecificationFormat

-SpecificationPath

-SpecificationUrl

-WsdlEndpointName

-WsdlServiceName

입력

출력

추가 리소스

다음을 통해 공유

Import-AzApiManagementApi

구문

Description

예제

예제 1: WADL 파일에서 API 가져오기

예제 2: Swagger 파일에서 API 가져오기

예제 3: Swagger 파일에서 API 가져오기 및 기존 API 업데이트

예제 4: WADL 링크에서 API 가져오기

예제 5: Open Api Link에서 API 가져오기

예제 6: Open Api Link에서 ApiVersion 집합으로 API 가져오기

예제 7: GraphQL 링크에서 API 가져오기

매개 변수

-ApiId

-ApiRevision

-ApiType

-ApiVersion

-ApiVersionSetId

-Context

-DefaultProfile

-Path

-Protocol

-ServiceUrl

-SpecificationFormat

-SpecificationPath

-SpecificationUrl

-WsdlEndpointName

-WsdlServiceName

입력

출력

관련 링크

추가 리소스