GraphQL API 가져오기

1. Azure Portal에서 API Management 인스턴스로 이동합니다.

2. 왼쪽 메뉴에서 API>+ API 추가를 선택합니다.

3. 새 API 정의 아래에서 GraphQL 아이콘을 선택합니다.

   

4. 대화 상자에서 전체를 선택하고 필요한 양식 필드를 작성합니다.

   

   필드	Description
   표시 이름	GraphQL API가 표시되는 이름입니다.
   이름	GraphQL API의 원시 이름입니다. 표시 이름을 입력하면 자동으로 채워집니다.
   GraphQL 형식	기존 GraphQL API 엔드포인트에서 가져오려면 통과 GraphQL을 선택합니다.
   GraphQL API 엔드포인트	GraphQL API 엔드포인트 이름이 있는 기준 URL입니다. 예: https://example.com/your-GraphQL-name https://swapi-graphql.azure-api.net/graphql과 같은 일반적인 "swapi" GraphQL 엔드포인트를 데모로 사용할 수도 있습니다.
   스키마 업로드	필요에 따라 스키마 파일을 찾아 업로드하여 GraphQL 엔드포인트에서 검색된 스키마를 바꿉니다(사용 가능한 경우).
   설명	API에 대한 설명을 추가합니다.
   URL 구성표	GraphQL 엔드포인트를 기반으로 선택합니다. GraphQL API에 구독 유형이 포함된 경우 WebSocket 구성표(WS 또는 WSS)가 포함된 옵션 중 하나를 선택합니다. 기본 선택: HTTP(S).
   API URL 접미사	URL 접미사를 추가하여 이 API Management 인스턴스에서 이 API를 식별합니다. 접미사는 이 API Management 인스턴스에서 고유해야 합니다.
   기준 URL	API 기준 URL을 표시하는 편집 불가능한 필드입니다.
   태그	GraphQL API를 새 태그 또는 기존 태그와 연결합니다.
   제품	GraphQL API를 제품과 연결하여 게시합니다.
   API 버전 관리	GraphQL API에 버전 관리 체계를 적용하려면 선택합니다.

5. 만들기를 실행합니다.

6. API가 만들어진 후 디자인 탭에서 스키마를 찾아보거나 수정합니다.

다음 예에서는 az apim api import 명령을 사용하여 지정된 URL에서 apim-hello-world라는 API Management 인스턴스로 GraphQL 통과 API를 가져옵니다.

# API Management service-specific details
APIMServiceName="apim-hello-world"
ResourceGroupName="myResourceGroup"

# API-specific details
APIId="my-graphql-api"
APIPath="myapi"
DisplayName="MyGraphQLAPI"
SpecificationFormat="GraphQL"
SpecificationURL="<GraphQL backend endpoint>"

# Import API
az apim api import --path $APIPath --resource-group $ResourceGroupName \
    --service-name $APIMServiceName --api-id $APIId \
    --display-name $DisplayName --specification-format $SpecificationFormat --specification-url $SpecificationURL

API를 가져온 후 필요한 경우 az apim api update 명령을 사용하여 설정을 업데이트할 수 있습니다.

다음 예에서는 Import-AzApiManagementApi Azure PowerShell cmdlet을 사용하여 지정된 URL에서 apim-hello-world라는 API Management 인스턴스로 GraphQL 통과 API를 가져옵니다.

# API Management service-specific details
$apimServiceName = "apim-hello-world"
$resourceGroupName = "myResourceGroup"

# API-specific details
$apiId = "my-graphql-api"
$apiPath = "myapi"
$specificationFormat = "GraphQL"
$specificationUrl = "<GraphQL backend endpoint>"

# Get context of the API Management instance. 
$context = New-AzApiManagementContext -ResourceGroupName $resourceGroupName -ServiceName $apimServiceName

# Import API
Import-AzApiManagementApi -Context $context -ApiId $apiId -SpecificationFormat $specificationFormat -SpecificationUrl $specificationUrl -Path $apiPath

API를 가져온 후 필요한 경우 Set-AzApiManagementApi cmdlet을 사용하여 설정을 업데이트할 수 있습니다.