ApiCenterOnboardingPlugin

앱에 사용되는 API가 지정된 Azure API 센터 instance 등록되어 있는지 확인합니다.

플러그 인 instance 정의

{
  "name": "ApiCenterOnboardingPlugin",
  "enabled": true,
  "pluginPath": "~appFolder/plugins/dev-proxy-plugins.dll",
  "configSection": "apiCenterOnboardingPlugin"
}

구성 예

{
  "apiCenterOnboardingPlugin": {
    "subscriptionId": "aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e",
    "resourceGroupName": "resource-group-name",
    "serviceName": "apic-instance",
    "workspaceName": "default",
    "createApicEntryForNewApis": true
  }
}

구성 속성

속성	Description	기본값
createApicEntryForNewApis	true 개발자 프록시가 검색되고 아직 API 센터에 등록되지 않은 API에 대한 새 API 항목을 만들도록 으로 설정합니다. 개발자 프록시로 false 설정된 경우 명령 프롬프트에 등록되지 않은 API만 나열됩니다.	true
resourceGroupName	Azure API Center가 있는 리소스 그룹의 이름입니다.	없음
serviceName	앱에 사용되는 API가 등록된 경우 개발자 프록시가 검사 데 사용해야 하는 Azure API 센터 instance 이름입니다.	없음
subscriptionId	Azure API 센터 instance 있는 Azure 구독의 ID입니다.	없음
workspace	사용할 Azure API Center 작업 영역의 이름입니다.	default

명령줄 옵션

없음

설명

플러그 인은 ApiCenterOnboardingPlugin 앱에 사용되는 API가 지정된 Azure API 센터 instance 등록되어 있는지 확인합니다. API가 등록되지 않은 경우 플러그 인은 API 센터 instance 새 API 항목을 만들 수 있습니다.

Azure API Center에 연결하기 위해 플러그 인은 Azure 자격 증명을 사용합니다(이 순서대로).

• Environment
• 워크로드 ID
• 관리 ID
• Visual Studio
• Visual Studio Code
• Azure CLI
• Azure PowerShell
• Azure 개발자 CLI

플러그 인이 Azure에 액세스하기 위한 액세스 토큰을 얻지 못하면 오류가 표시되고 개발자 프록시가 이를 사용하지 않도록 설정합니다. 이러한 도구 중 하나를 사용하여 Azure에 로그인하고 개발자 프록시를 다시 시작하여 플러그 인을 ApiCenterOnboardingPlugin 사용합니다.

CI/CD 파이프라인에서 개발 프록시를 사용하는 경우 , , resourceGroupNameserviceName및 workspaceName 속성에 subscriptionId대한 값을 환경 변수로 전달할 수 있습니다. 환경 변수를 사용하려면 값 @이름 앞에 를 추가합니다. 예를 들면 다음과 같습니다.

{
  "apiCenterOnboardingPlugin": {
    "subscriptionId": "@AZURE_SUBSCRIPTION_ID",
    "resourceGroupName": "@AZURE_RESOURCE_GROUP_NAME",
    "serviceName": "@AZURE_APIC_INSTANCE_NAME",
    "workspaceName": "@AZURE_APIC_WORKSPACE_NAME",
    "createApicEntryForNewApis": true
  }
}

이 예제 ApiCenterOnboardingPlugin 에서 플러그 인은 , resourceGroupName, serviceName및 workspaceName 속성을 각각 , , AZURE_RESOURCE_GROUP_NAMEAZURE_APIC_INSTANCE_NAME및 AZURE_APIC_WORKSPACE_NAME 환경 변수의 AZURE_SUBSCRIPTION_ID값으로 설정합니다subscriptionId.