다음을 통해 공유

New-AzApiManagementApi

  • 참조
모듈:
Az.ApiManagement

API를 만듭니다.

구문

New-AzApiManagementApi
   -Context <PsApiManagementContext>
   [-ApiId <String>]
   -Name <String>
   [-Description <String>]
   -ServiceUrl <String>
   -Path <String>
   -Protocols <PsApiManagementSchema[]>
   [-AuthorizationServerId <String>]
   [-AuthorizationScope <String>]
   [-OpenIdProviderId <String>]
   [-BearerTokenSendingMethod <String[]>]
   [-SubscriptionKeyHeaderName <String>]
   [-SubscriptionKeyQueryParamName <String>]
   [-ProductIds <String[]>]
   [-SubscriptionRequired]
   [-ApiVersionDescription <String>]
   [-ApiVersionSetId <String>]
   [-ApiVersion <String>]
   [-SourceApiId <String>]
   [-SourceApiRevision <String>]
   [-ApiType <PsApiManagementApiType>]
   [-TermsOfServiceUrl <String>]
   [-ContactName <String>]
   [-ContactUrl <String>]
   [-ContactEmail <String>]
   [-LicenseName <String>]
   [-LicenseUrl <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Description

New-AzApiManagementApi cmdlet은 Azure API Management API를 만듭니다.

예제

예제 1: API 만들기

$ApiMgmtContext = New-AzApiManagementContext -ResourceGroupName "Api-Default-WestUS" -ServiceName "contoso"
New-AzApiManagementApi -Context $ApiMgmtContext -Name "Echo api" -ServiceUrl "https://contoso.com/apis/echo" -Protocols @("http", "https") -Path "testapi"

이 명령은 지정된 URL을 사용하여 EchoApi라는 API를 만듭니다.

예제 2: echo-api에서 ApiVersionSet으로 모든 작업, 태그, 제품 및 정책을 복사하여 API 만들기

$context = New-AzApiManagementContext -ResourceId /subscriptions/subid/resourceGroups/Api-Default-West-US/providers/Microsoft.ApiManagement/service/contoso
$versionSet = Get-AzApiManagementApiVersionSet -Context $context -ApiVersionSetId "xmsVersionSet"
New-AzApiManagementApi -Context $context -Name "echoapiv4" -Description "Create Echo Api V4" -SubscriptionRequired -ServiceUrl "https://echoapi.cloudapp.net/v4" -Path "echov3" -Protocols @("http", "https") -ApiVersionSetId $versionSet.ApiVersionSetId -SourceApiId "echo-api" -ApiVersion "v4"

ApiId                         : 691b7d410125414a929c108541c60e06
Name                          : echoapiv4
Description                   : Create Echo Api V4
ServiceUrl                    : https://echoapi.cloudapp.net/v4
Path                          : echov3
ApiType                       : http
Protocols                     : {Http, Https}
AuthorizationServerId         :
AuthorizationScope            :
OpenidProviderId              :
BearerTokenSendingMethod      : {}
SubscriptionKeyHeaderName     : Ocp-Apim-Subscription-Key
SubscriptionKeyQueryParamName : subscription-key
ApiRevision                   : 1
ApiVersion                    : v4
IsCurrent                     : True
IsOnline                      : False
SubscriptionRequired          : True
ApiRevisionDescription        :
ApiVersionSetDescription      :
ApiVersionSetId               : /subscriptions/subid/resourceGroups/Api-Default-West-US/providers/Microsoft.ApiManagement/service/contoso/apiVersionSets/xmsVersionSet
Id                            : /subscriptions/subid/resourceGroups/Api-Default-West-US/providers/Microsoft.ApiManagement/service/contoso/apis/691b7d410125414a929c108541c60e06
ResourceGroupName             : Api-Default-West-US
ServiceName                   : contoso

이 명령은 ApiVersionSet xmsVersionSet API echoapiv3 만들고 원본 Api echo-api모든 작업, 태그 및 정책을 복사합니다. SubscriptionRequired, ServiceUrl, Path, Protocols를 재정의합니다.

예제 3

API를 만듭니다. (자동 생성됨)

New-AzApiManagementApi -ApiId '0001' -Context <PsApiManagementContext> -Name 'Echo api' -Path 'echov3' -Protocols Http -ServiceUrl 'https://contoso.com/apis/echo'

매개 변수

-ApiId

만들 API의 ID를 지정합니다. 이 매개 변수를 지정하지 않으면 이 cmdlet은 ID를 생성합니다.

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

-ApiType

만들 API 유형(http, soap, websocket, graphql)입니다. 이 매개 변수는 선택 사항입니다.

형식: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

-ApiVersionDescription

API 버전 설명입니다. 이 매개 변수는 선택 사항입니다.

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

-ApiVersionSetId

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

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

-AuthorizationScope

OAuth 작업 범위를 지정합니다. 기본값은 $Null.

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

-AuthorizationServerId

OAuth 권한 부여 서버 ID를 지정합니다. 기본값은 $Null. AuthorizationScope 지정된 경우 이 매개 변수를 지정해야 합니다.

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

-BearerTokenSendingMethod

액세스 토큰이 API에 전달되는 OpenId 권한 부여 서버 메커니즘입니다. https://datatracker.ietf.org/doc/html/rfc6749#section-4참조하세요. 이 매개 변수는 선택 사항입니다. 기본값은 $null.

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

-ContactEmail

연락처/조직의 전자 메일 주소입니다. 전자 메일 주소 형식이어야 합니다. 이 매개 변수는 선택 사항입니다.

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

-ContactName

연락처/조직의 식별 이름입니다. 이 매개 변수는 선택 사항입니다.

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

-ContactUrl

연락처 정보를 가리키는 URL입니다. URL 형식이어야 합니다. 이 매개 변수는 선택 사항입니다.

형식: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

-Description

웹 API에 대한 설명을 지정합니다.

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

-LicenseName

API에 사용되는 라이선스 이름입니다. 이 매개 변수는 선택 사항입니다.

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

-LicenseUrl

API에 대한 서비스 약관에 대한 URL입니다. 이 매개 변수는 선택 사항입니다.

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

-Name

웹 API의 이름을 지정합니다. 개발자 및 관리 포털에 표시되는 API의 공용 이름입니다.

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

-OpenIdProviderId

OpenId 권한 부여 서버 식별자입니다. 이 매개 변수는 선택 사항입니다. 기본값은 $null. BearerTokenSendingMethods가 지정된 경우 지정해야 합니다.

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

-Path

API 공용 URL의 마지막 부분이며 관리 포털의 Web API URL 접미사 필드에 해당하는 웹 API 경로를 지정합니다. 이 URL은 API 소비자가 웹 서비스에 요청을 보내는 데 사용되며 길이는 1~400자여야 합니다. 기본값은 $Null.

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

-ProductIds

새 API를 추가할 제품 ID의 배열을 지정합니다.

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

-Protocols

웹 API 프로토콜의 배열을 지정합니다. 유효한 값은 http, https입니다. API를 사용할 수 있게 되는 웹 프로토콜입니다. 기본값은 $Null.

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

-ServiceUrl

API를 노출하는 웹 서비스의 URL을 지정합니다. 이 URL은 Azure API Management에서만 사용되며 공개되지 않습니다. URL 길이는 1~2000자여야 합니다.

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

-SourceApiId

원본 API의 API 식별자입니다. 이 매개 변수는 선택 사항입니다.

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

-SourceApiRevision

원본 API의 API 수정 버전입니다. 이 매개 변수는 선택 사항입니다.

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

-SubscriptionKeyHeaderName

구독 키 헤더 이름을 지정합니다. 기본값은 $Null.

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

-SubscriptionKeyQueryParamName

구독 키 쿼리 문자열 매개 변수 이름을 지정합니다. 기본값은 $Null.

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

-SubscriptionRequired

API에 대한 요청에 SubscriptionRequired를 적용하는 플래그입니다. 이 매개 변수는 선택 사항입니다.

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

-TermsOfServiceUrl

API에 대한 서비스 약관에 대한 URL입니다. 이 매개 변수는 선택 사항입니다.

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

입력

PsApiManagementContext

String

PsApiManagementSchema[]

String[]

출력

PsApiManagementApi