다음을 통해 공유


Api Management Service - MigrateToStv2

API Management 서비스를 Stv2 플랫폼으로 업그레이드합니다. 자세한 내용은 을 참조하세요 https://aka.ms/apim-migrate-stv2. 이 변경은 되돌릴 수 없습니다. 이 작업은 장기 실행 작업이며 완료하는 데 몇 분 정도 걸릴 수 있습니다.

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/migrateToStv2?api-version=2022-08-01

URI 매개 변수

Name In(다음 안에) 필수 형식 Description
resourceGroupName
path True

string

리소스 그룹의 이름. 이름은 대소문자를 구분하지 않습니다.

serviceName
path True

string

API Management 서비스의 이름입니다.

regex 패턴: ^[a-zA-Z](?:[a-zA-Z0-9-]*[a-zA-Z0-9])?$

subscriptionId
path True

string

대상 구독의 ID입니다.

api-version
query True

string

이 작업에 사용할 API 버전입니다.

응답

Name 형식 Description
200 OK

ApiManagementServiceResource

서비스가 성공적으로 마이그레이션되었습니다.

202 Accepted

마이그레이션 요청이 제출되었습니다.

헤더

location: string

Other Status Codes

ErrorResponse

작업이 실패한 이유를 설명하는 오류 응답입니다.

보안

azure_auth

Azure Active Directory OAuth2 Flow.

형식: oauth2
Flow: implicit
권한 부여 URL: https://login.microsoftonline.com/common/oauth2/authorize

범위

Name Description
user_impersonation 사용자 계정 가장

예제

ApiManagementMigrateService

샘플 요청

POST https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/migrateToStv2?api-version=2022-08-01

샘플 응답

location: https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/operationresults/dGVjaGVkX01hbmFnZVJvbGVfNWRiNGI3Ng==?api-version=2022-08-01
{
  "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimservice1",
  "name": "apimservice1",
  "type": "Microsoft.ApiManagement/service",
  "tags": {},
  "location": "West US",
  "etag": "AAAAAADqC0c=",
  "properties": {
    "publisherEmail": "abcs@contoso.com",
    "publisherName": "contoso publisher",
    "notificationSenderEmail": "apimgmt-noreply@mail.windowsazure.com",
    "provisioningState": "Succeeded",
    "targetProvisioningState": "",
    "createdAtUtc": "2019-12-02T01:42:09.1268424Z",
    "gatewayUrl": "https://apimservice1.azure-api.net",
    "gatewayRegionalUrl": "https://apimservice1-westus-01.regional.azure-api.net",
    "portalUrl": "https://apimservice1.portal.azure-api.net",
    "developerPortalUrl": "https://apimService1.developer.azure-api.net",
    "managementApiUrl": "https://apimservice1.management.azure-api.net",
    "scmUrl": "https://apimservice1.scm.azure-api.net",
    "hostnameConfigurations": [
      {
        "type": "Proxy",
        "hostName": "apimService1.azure-api.net",
        "negotiateClientCertificate": false,
        "defaultSslBinding": false,
        "certificateSource": "BuiltIn"
      },
      {
        "type": "Proxy",
        "hostName": "apimgatewaytest.preview.net",
        "negotiateClientCertificate": false,
        "certificate": {
          "expiry": "2019-08-16T16:51:34+00:00",
          "thumbprint": "B4330123DBAXXXXXXXXX1F35E84493476",
          "subject": "CN=*.preview.net"
        },
        "defaultSslBinding": true,
        "certificateSource": "Custom"
      }
    ],
    "publicIPAddresses": [
      "137.XXX.11.74"
    ],
    "privateIPAddresses": [
      "172.XX.0.5"
    ],
    "additionalLocations": [
      {
        "location": "West US 2",
        "sku": {
          "name": "Premium",
          "capacity": 1
        },
        "publicIPAddresses": [
          "40.XXX.79.187"
        ],
        "privateIPAddresses": [
          "10.0.X.6"
        ],
        "virtualNetworkConfiguration": {
          "subnetResourceId": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/virtualNetworks/APIMVNet/subnets/apim-internal-sub"
        },
        "gatewayRegionalUrl": "https://apimservice1-westus2-01.regional.azure-api.net",
        "disableGateway": false
      }
    ],
    "virtualNetworkConfiguration": {
      "subnetResourceId": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/virtualNetworks/apim-appGateway-vnet/subnets/apim-subnet"
    },
    "customProperties": {
      "Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Protocols.Tls10": "True",
      "Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Protocols.Tls11": "True",
      "Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Protocols.Ssl30": "False",
      "Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Ciphers.TripleDes168": "True",
      "Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Backend.Protocols.Tls10": "True",
      "Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Backend.Protocols.Tls11": "True",
      "Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Backend.Protocols.Ssl30": "False"
    },
    "virtualNetworkType": "Internal",
    "disableGateway": false,
    "apiVersionConstraint": {},
    "platformVersion": "stv1"
  },
  "sku": {
    "name": "Premium",
    "capacity": 1
  }
}

정의

Name Description
AdditionalLocation

추가 API Management 리소스 위치에 대한 설명입니다.

ApiManagementServiceIdentity

Api Management 서비스 리소스의 ID 속성입니다.

ApiManagementServiceResource

응답 나열 또는 가져오기의 단일 API Management 서비스 리소스입니다.

ApiManagementServiceSkuProperties

서비스 리소스 SKU 속성을 API Management.

ApimIdentityType

리소스에 사용되는 ID 유형입니다. ‘SystemAssigned, UserAssigned’ 유형에는 암시적으로 만들어진 ID와 사용자 할당 ID 세트가 모두 포함되어 있습니다. 'None' 형식은 서비스에서 모든 ID를 제거합니다.

ApiVersionConstraint

API Management 서비스에 대한 컨트롤 플레인 API 버전 제약 조건입니다.

ArmIdWrapper

ARM 리소스 ID에 대한 래퍼

CertificateConfiguration

신뢰할 수 없는 중간 및 루트 인증서로 구성된 인증서 구성입니다.

CertificateInformation

SSL 인증서 정보입니다.

CertificateSource

인증서 원본입니다.

CertificateStatus

인증서 상태.

createdByType

리소스를 만든 ID의 형식입니다.

ErrorFieldContract

오류 필드 계약.

ErrorResponse

오류 응답.

HostnameConfiguration

사용자 지정 호스트 이름 구성.

HostnameType

호스트 이름 형식입니다.

NatGatewayState

속성을 사용하여 이 API Management 서비스에 NAT Gateway를 사용하도록 설정할 수 있습니다.

PlatformVersion

서비스를 실행하는 컴퓨팅 플랫폼 버전입니다.

PrivateEndpointServiceConnectionStatus

프라이빗 엔드포인트 연결 상태.

PrivateLinkServiceConnectionState

서비스 소비자와 공급자 간의 연결 상태에 대한 정보 컬렉션입니다.

PublicNetworkAccess

이 API Management 서비스에 대한 퍼블릭 엔드포인트 액세스가 허용되는지 여부입니다. 값은 선택 사항이지만 전달되는 경우 '사용' 또는 '사용 안 함'이어야 합니다. 'Disabled'인 경우 프라이빗 엔드포인트는 전용 액세스 방법입니다. 기본값은 'Enabled'입니다.

RemotePrivateEndpointConnectionWrapper

원격 프라이빗 엔드포인트 연결 리소스.

SkuType

Sku의 이름입니다.

systemData

리소스 만들기 및 마지막 수정과 관련된 메타데이터입니다.

UserIdentityProperties
VirtualNetworkConfiguration

API Management 서비스가 배포되는 가상 네트워크의 구성입니다.

VirtualNetworkType

API Management 서비스를 구성해야 하는 VPN의 유형입니다. 없음(기본값)은 API Management 서비스가 Virtual Network 포함되지 않음을 의미하고, 외부는 API Management 배포가 인터넷 연결 엔드포인트가 있는 Virtual Network 내에 설정됨을 의미하며 내부는 API Management 배포는 인트라넷 연결 엔드포인트만 있는 Virtual Network 내에서 설정됩니다.

AdditionalLocation

추가 API Management 리소스 위치에 대한 설명입니다.

Name 형식 Default value Description
disableGateway

boolean

False

속성은 여러 위치에 배포된 Api Management 서비스에만 유효합니다. 이 추가 위치에서 게이트웨이를 사용하지 않도록 설정하는 데 사용할 수 있습니다.

gatewayRegionalUrl

string

지역에서 API Management 서비스의 게이트웨이 URL입니다.

location

string

Azure 데이터 센터 지역 중 추가 지역의 위치 이름입니다.

natGatewayState

NatGatewayState

Disabled

속성을 사용하여 이 API Management 서비스에 NAT Gateway를 사용하도록 설정할 수 있습니다.

outboundPublicIPAddresses

string[]

NAT Gateway 배포 서비스와 연결된 아웃바운드 공용 IPV4 주소 접두사입니다. stv2 플랫폼의 프리미엄 SKU에만 사용할 수 있습니다.

platformVersion

PlatformVersion

서비스를 실행하는 컴퓨팅 플랫폼 버전입니다.

privateIPAddresses

string[]

특정 추가 위치의 내부 Virtual Network 배포되는 API Management 서비스의 프라이빗 정적 부하 분산 IP 주소입니다. 기본, 표준, 프리미엄 및 격리된 SKU에만 사용할 수 있습니다.

publicIPAddresses

string[]

추가 위치에 있는 API Management 서비스의 공용 정적 부하 분산 IP 주소입니다. 기본, 표준, 프리미엄 및 격리된 SKU에만 사용할 수 있습니다.

publicIpAddressId

string

위치에 Virtual Network 배포된 서비스와 연결할 공용 표준 SKU IP V4 기반 IP 주소입니다. Virtual Network 배포되는 프리미엄 SKU에 대해서만 지원됩니다.

sku

ApiManagementServiceSkuProperties

API Management 서비스의 SKU 속성입니다.

virtualNetworkConfiguration

VirtualNetworkConfiguration

위치에 대한 가상 네트워크 구성입니다.

zones

string[]

리소스의 원본 위치를 나타내는 가용성 영역 목록입니다.

ApiManagementServiceIdentity

Api Management 서비스 리소스의 ID 속성입니다.

Name 형식 Description
principalId

string

ID의 보안 주체 ID입니다.

tenantId

string

ID의 클라이언트 테넌트 ID입니다.

type

ApimIdentityType

리소스에 사용되는 ID 유형입니다. ‘SystemAssigned, UserAssigned’ 유형에는 암시적으로 만들어진 ID와 사용자 할당 ID 세트가 모두 포함되어 있습니다. 'None' 형식은 서비스에서 ID를 제거합니다.

userAssignedIdentities

<string,  UserIdentityProperties>

리소스와 연결된 사용자 ID 목록입니다. 사용자 ID 사전 키 참조는 '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/ providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}' 형식의 ARM 리소스 ID입니다.

ApiManagementServiceResource

응답 나열 또는 가져오기의 단일 API Management 서비스 리소스입니다.

Name 형식 Default value Description
etag

string

리소스의 ETag입니다.

id

string

리소스 ID입니다.

identity

ApiManagementServiceIdentity

Api Management 서비스의 관리 서비스 ID입니다.

location

string

리소스 위치.

name

string

리소스 이름입니다.

properties.additionalLocations

AdditionalLocation[]

API Management 서비스의 추가 데이터 센터 위치입니다.

properties.apiVersionConstraint

ApiVersionConstraint

API Management 서비스에 대한 컨트롤 플레인 API 버전 제약 조건입니다.

properties.certificates

CertificateConfiguration[]

API Management 서비스에 설치해야 하는 인증서 목록입니다. 설치할 수 있는 최대 지원 인증서는 10입니다.

properties.createdAtUtc

string

API Management 서비스의 UTC 생성 날짜입니다. 날짜는 ISO 8601 표준에 지정된 형식 yyyy-MM-ddTHH:mm:ssZ 을 따릅니다.

properties.customProperties

object

API Management 서비스의 사용자 지정 속성입니다.
설정 Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Ciphers.TripleDes168 은 모든 TLS(1.0, 1.1 및 1.2)에 대해 암호화 TLS_RSA_WITH_3DES_EDE_CBC_SHA 사용하지 않도록 설정합니다.
설정 Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Protocols.Tls11 은 TLS 1.1만 사용하지 않도록 설정하는 데 사용할 수 있습니다.
설정을 Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Protocols.Tls10 사용하여 API Management 서비스에서 TLS 1.0을 사용하지 않도록 설정할 수 있습니다.
설정 Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Backend.Protocols.Tls11 은 백 엔드와의 통신에 TLS 1.1만 사용하지 않도록 설정하는 데 사용할 수 있습니다.
설정을 Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Backend.Protocols.Tls10 사용하여 백 엔드와의 통신에 TLS 1.0을 사용하지 않도록 설정할 수 있습니다.
설정을 Microsoft.WindowsAzure.ApiManagement.Gateway.Protocols.Server.Http2 사용하여 API Management 서비스에서 HTTP2 프로토콜을 사용하도록 설정할 수 있습니다.
PATCH 작업에서 이러한 속성을 지정하지 않으면 생략된 속성의 값이 기본값으로 다시 설정됩니다. Http2를 제외한 모든 설정의 경우 기본값은 서비스가 2018년 4월 1일 또는 그 이전에 만들어진 경우 이고False, 그렇지 않으면 입니다True. Http2 설정의 기본값은 입니다 False.

TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA, TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA, TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA, TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA, TLS_RSA_WITH_AES_128_GCM_SHA256, TLS_RSA_WITH_AES_256_CBC_SHA256 설정을 Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Ciphers.[cipher_name]사용하여 다음 암호화를 사용하지 않도록 설정할 수 있습니다. TLS_RSA_WITH_AES_128_CBC_SHA256, TLS_RSA_WITH_AES_256_CBC_SHA, TLS_RSA_WITH_AES_128_CBC_SHA. 예: Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Ciphers.TLS_RSA_WITH_AES_128_CBC_SHA256:false. 기본값은 해당 값입니다 true .
참고: 내부 플랫폼 구성 요소에 필요하므로 다음 암호화를 사용하지 않도록 설정할 수 없습니다. TLS_AES_256_GCM_SHA384,TLS_AES_128_GCM_SHA256,TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384,TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256,TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384,TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256 TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA384,TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA256,TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384,TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256

properties.developerPortalUrl

string

API Management 서비스의 DEveloper 포털 엔드포인트 URL입니다.

properties.disableGateway

boolean

False

속성은 여러 위치에 배포된 Api Management 서비스에만 유효합니다. master 지역에서 게이트웨이를 사용하지 않도록 설정하는 데 사용할 수 있습니다.

properties.enableClientCertificate

boolean

False

사용량 SKU 서비스에만 사용되는 속성입니다. 이렇게 하면 게이트웨이에 대한 각 요청에 대해 클라이언트 인증서가 표시됩니다. 이렇게 하면 게이트웨이의 정책에서 인증서를 인증하는 기능도 사용할 수 있습니다.

properties.gatewayRegionalUrl

string

기본 지역에 있는 API Management 서비스의 게이트웨이 URL입니다.

properties.gatewayUrl

string

API Management 서비스의 게이트웨이 URL입니다.

properties.hostnameConfigurations

HostnameConfiguration[]

API Management 서비스의 사용자 지정 호스트 이름 구성입니다.

properties.managementApiUrl

string

API Management 서비스의 관리 API 엔드포인트 URL입니다.

properties.natGatewayState

NatGatewayState

Disabled

속성을 사용하여 이 API Management 서비스에 NAT Gateway를 사용하도록 설정할 수 있습니다.

properties.notificationSenderEmail

string

알림을 보낼 Email 주소입니다.

properties.outboundPublicIPAddresses

string[]

NAT Gateway 배포 서비스와 연결된 아웃바운드 공용 IPV4 주소 접두사입니다. stv2 플랫폼의 프리미엄 SKU에만 사용할 수 있습니다.

properties.platformVersion

PlatformVersion

이 위치에서 서비스를 실행하는 컴퓨팅 플랫폼 버전입니다.

properties.portalUrl

string

API Management 서비스의 게시자 포털 엔드포인트 URL입니다.

properties.privateEndpointConnections

RemotePrivateEndpointConnectionWrapper[]

이 서비스의 프라이빗 엔드포인트 연결 목록입니다.

properties.privateIPAddresses

string[]

내부 Virtual Network 배포되는 주 지역의 API Management 서비스의 개인 정적 부하 분산 IP 주소입니다. 기본, 표준, 프리미엄 및 격리된 SKU에만 사용할 수 있습니다.

properties.provisioningState

string

생성/활성화/성공/업데이트/실패/중지/종료/종료/종료/삭제 중 하나일 수 있는 API Management 서비스의 현재 프로비전 상태입니다.

properties.publicIPAddresses

string[]

주 지역의 API Management 서비스의 공용 정적 부하 분산 IP 주소입니다. 기본, 표준, 프리미엄 및 격리된 SKU에만 사용할 수 있습니다.

properties.publicIpAddressId

string

지역에서 Virtual Network 배포된 서비스와 연결할 공용 표준 SKU IP V4 기반 IP 주소입니다. Virtual Network 배포되는 개발자 및 프리미엄 SKU에 대해서만 지원됩니다.

properties.publicNetworkAccess

PublicNetworkAccess

이 API Management 서비스에 대해 퍼블릭 엔드포인트 액세스가 허용되는지 여부입니다. 값은 선택 사항이지만 전달된 경우 '사용' 또는 '사용 안 함'이어야 합니다. 'Disabled'인 경우 프라이빗 엔드포인트는 전용 액세스 방법입니다. 기본값은 'Enabled'입니다.

properties.publisherEmail

string

게시자 전자 메일.

properties.publisherName

string

게시자 이름입니다.

properties.restore

boolean

False

이전에 일시 삭제된 경우 Api Management 서비스를 삭제 취소합니다. 이 플래그를 지정하고 True로 설정하면 다른 모든 속성은 무시됩니다.

properties.scmUrl

string

API Management 서비스의 SCM 엔드포인트 URL입니다.

properties.targetProvisioningState

string

서비스에서 시작된 장기 실행 작업의 대상이 되는 API Management 서비스의 프로비전 상태입니다.

properties.virtualNetworkConfiguration

VirtualNetworkConfiguration

API Management 서비스의 가상 네트워크 구성입니다.

properties.virtualNetworkType

VirtualNetworkType

None

API Management 서비스를 구성해야 하는 VPN 유형입니다. 없음(기본값)은 API Management 서비스가 Virtual Network 일부가 아님을 의미하고, 외부는 API Management 배포가 인터넷 연결 엔드포인트가 있는 Virtual Network 내에 설정됨을 의미하며 내부는 API Management 배포는 인트라넷 연결 엔드포인트만 있는 Virtual Network 내에서 설정됩니다.

sku

ApiManagementServiceSkuProperties

API Management 서비스의 SKU 속성입니다.

systemData

systemData

리소스 만들기 및 마지막 수정과 관련된 메타데이터입니다.

tags

object

리소스 태그.

type

string

API Management 리소스의 리소스 종류는 Microsoft.ApiManagement로 설정됩니다.

zones

string[]

리소스의 원본을 나타내는 가용성 영역 목록입니다.

ApiManagementServiceSkuProperties

서비스 리소스 SKU 속성을 API Management.

Name 형식 Description
capacity

integer

SKU의 용량(SKU의 배포된 단위 수)입니다. 소비 SKU 용량의 경우 0으로 지정해야 합니다.

name

SkuType

Sku의 이름입니다.

ApimIdentityType

리소스에 사용되는 ID 유형입니다. ‘SystemAssigned, UserAssigned’ 유형에는 암시적으로 만들어진 ID와 사용자 할당 ID 세트가 모두 포함되어 있습니다. 'None' 형식은 서비스에서 모든 ID를 제거합니다.

Name 형식 Description
None

string

SystemAssigned

string

SystemAssigned, UserAssigned

string

UserAssigned

string

ApiVersionConstraint

API Management 서비스에 대한 컨트롤 플레인 API 버전 제약 조건입니다.

Name 형식 Description
minApiVersion

string

컨트롤 플레인 API 호출을 이 값보다 같거나 최신 버전인 API Management 서비스로 제한합니다.

ArmIdWrapper

ARM 리소스 ID에 대한 래퍼

Name 형식 Description
id

string

CertificateConfiguration

신뢰할 수 없는 중간 및 루트 인증서로 구성된 인증서 구성입니다.

Name 형식 Description
certificate

CertificateInformation

인증서 정보입니다.

certificatePassword

string

인증서 암호입니다.

encodedCertificate

string

Base64 인코딩된 인증서입니다.

storeName enum:
  • CertificateAuthority
  • Root

System.Security.Cryptography.x509certificates.StoreName 인증서 저장소 위치입니다. 루트 및 CertificateAuthority만 유효한 위치입니다.

CertificateInformation

SSL 인증서 정보입니다.

Name 형식 Description
expiry

string

인증서의 만료 날짜입니다. 날짜는 ISO 8601 표준에 지정된 형식 yyyy-MM-ddTHH:mm:ssZ 을 따릅니다.

subject

string

인증서의 주체입니다.

thumbprint

string

인증서의 지문입니다.

CertificateSource

인증서 원본입니다.

Name 형식 Description
BuiltIn

string

Custom

string

KeyVault

string

Managed

string

CertificateStatus

인증서 상태.

Name 형식 Description
Completed

string

Failed

string

InProgress

string

createdByType

리소스를 만든 ID의 형식입니다.

Name 형식 Description
Application

string

Key

string

ManagedIdentity

string

User

string

ErrorFieldContract

오류 필드 계약.

Name 형식 Description
code

string

속성 수준 오류 코드입니다.

message

string

사람이 읽을 수 있는 속성 수준 오류 표현입니다.

target

string

속성 이름입니다.

ErrorResponse

오류 응답.

Name 형식 Description
error.code

string

서비스에서 정의한 오류 코드입니다. 이 코드는 응답에 지정된 HTTP 오류 코드의 하위 상태로 사용됩니다.

error.details

ErrorFieldContract[]

유효성 검사 오류가 발생할 경우 잘못된 필드 목록이 요청에 전송됩니다.

error.message

string

사람이 읽을 수 있는 오류 표현입니다.

HostnameConfiguration

사용자 지정 호스트 이름 구성.

Name 형식 Default value Description
certificate

CertificateInformation

인증서 정보입니다.

certificatePassword

string

인증서 암호입니다.

certificateSource

CertificateSource

인증서 원본입니다.

certificateStatus

CertificateStatus

인증서 상태.

defaultSslBinding

boolean

False

true를 지정하여 이 호스트 이름과 연결된 인증서를 기본 SSL 인증서로 설정합니다. 클라이언트가 SNI 헤더를 보내지 않으면 이 문제가 발생하는 인증서가 됩니다. 속성은 서비스에 여러 사용자 지정 호스트 이름을 사용하도록 설정하고 기본 ssl 인증서를 결정해야 하는 경우에 유용합니다. 게이트웨이 호스트 이름 형식에만 적용되는 설정입니다.

encodedCertificate

string

Base64 인코딩된 인증서입니다.

hostName

string

Api Management 서비스에서 구성할 호스트 이름입니다.

identityClientId

string

SSL 인증서를 포함하는 keyVault에 대한 GET 액세스 권한이 있는 Azure AD 생성된 시스템 또는 사용자 할당 관리 ID clientId입니다.

keyVaultId

string

Ssl 인증서를 포함하는 KeyVault 비밀에 대한 URL입니다. 버전이 포함된 절대 URL이 제공되면 ssl 인증서의 자동 업데이트가 작동하지 않습니다. 이렇게 하려면 Api Management 서비스를 aka.ms/apimmsi 구성해야 합니다. 비밀은 application/x-pkcs12 형식이어야 합니다.

negotiateClientCertificate

boolean

False

호스트 이름에서 항상 클라이언트 인증서를 협상하려면 true를 지정합니다. 기본값은 false입니다.

type

HostnameType

호스트 이름 형식입니다.

HostnameType

호스트 이름 형식입니다.

Name 형식 Description
DeveloperPortal

string

Management

string

Portal

string

Proxy

string

Scm

string

NatGatewayState

속성을 사용하여 이 API Management 서비스에 NAT Gateway를 사용하도록 설정할 수 있습니다.

Name 형식 Description
Disabled

string

서비스에 대해 Nat Gateway를 사용할 수 없습니다.

Enabled

string

Nat Gateway는 서비스에 대해 사용하도록 설정됩니다.

PlatformVersion

서비스를 실행하는 컴퓨팅 플랫폼 버전입니다.

Name 형식 Description
mtv1

string

다중 테넌트 V1 플랫폼에서 서비스를 실행하는 플랫폼입니다.

stv1

string

단일 테넌트 V1 플랫폼에서 서비스를 실행하는 플랫폼입니다.

stv2

string

단일 테넌트 V2 플랫폼에서 서비스를 실행하는 플랫폼입니다.

undetermined

string

컴퓨팅 플랫폼이 배포되지 않으므로 플랫폼 버전을 확인할 수 없습니다.

PrivateEndpointServiceConnectionStatus

프라이빗 엔드포인트 연결 상태.

Name 형식 Description
Approved

string

Pending

string

Rejected

string

PrivateLinkServiceConnectionState

서비스 소비자와 공급자 간의 연결 상태에 대한 정보 컬렉션입니다.

Name 형식 Description
actionsRequired

string

서비스 공급자의 변경 내용에 소비자에 대한 업데이트가 필요한지 여부를 나타내는 메시지입니다.

description

string

연결의 승인/거부 이유입니다.

status

PrivateEndpointServiceConnectionStatus

서비스 소유자가 연결을 승인/거부/제거했는지 여부를 나타냅니다.

PublicNetworkAccess

이 API Management 서비스에 대한 퍼블릭 엔드포인트 액세스가 허용되는지 여부입니다. 값은 선택 사항이지만 전달되는 경우 '사용' 또는 '사용 안 함'이어야 합니다. 'Disabled'인 경우 프라이빗 엔드포인트는 전용 액세스 방법입니다. 기본값은 'Enabled'입니다.

Name 형식 Description
Disabled

string

Enabled

string

RemotePrivateEndpointConnectionWrapper

원격 프라이빗 엔드포인트 연결 리소스.

Name 형식 Description
id

string

프라이빗 엔드포인트 연결 리소스 ID

name

string

프라이빗 엔드포인트 연결 이름

properties.groupIds

string[]

모든 그룹 ID입니다.

properties.privateEndpoint

ArmIdWrapper

프라이빗 엔드포인트의 리소스입니다.

properties.privateLinkServiceConnectionState

PrivateLinkServiceConnectionState

서비스 소비자와 공급자 간의 연결 상태에 대한 정보 컬렉션입니다.

properties.provisioningState

string

프라이빗 엔드포인트 연결 리소스의 프로비저닝 상태입니다.

type

string

프라이빗 엔드포인트 연결 리소스 종류

SkuType

Sku의 이름입니다.

Name 형식 Description
Basic

string

Api Management의 기본 SKU입니다.

Consumption

string

Api Management의 소비 SKU입니다.

Developer

string

Api Management의 개발자 SKU입니다.

Isolated

string

Api Management의 격리된 SKU입니다.

Premium

string

Api Management의 프리미엄 SKU입니다.

Standard

string

Api Management의 표준 SKU입니다.

systemData

리소스 만들기 및 마지막 수정과 관련된 메타데이터입니다.

Name 형식 Description
createdAt

string

UTC(리소스 만들기)의 타임스탬프입니다.

createdBy

string

리소스를 만든 ID입니다.

createdByType

createdByType

리소스를 만든 ID 유형입니다.

lastModifiedAt

string

리소스 마지막 수정의 타임스탬프(UTC)

lastModifiedBy

string

리소스를 마지막으로 수정한 ID입니다.

lastModifiedByType

createdByType

리소스를 마지막으로 수정한 ID 유형입니다.

UserIdentityProperties

Name 형식 Description
clientId

string

사용자 할당 ID의 클라이언트 ID입니다.

principalId

string

사용자 할당 ID의 보안 주체 ID입니다.

VirtualNetworkConfiguration

API Management 서비스가 배포되는 가상 네트워크의 구성입니다.

Name 형식 Description
subnetResourceId

string

API Management 서비스를 배포할 가상 네트워크에 있는 서브넷의 전체 리소스 ID입니다.

subnetname

string

서브넷의 이름입니다.

vnetid

string

가상 네트워크 ID입니다. 일반적으로 GUID입니다. 기본적으로 null GUID를 예상합니다.

VirtualNetworkType

API Management 서비스를 구성해야 하는 VPN의 유형입니다. 없음(기본값)은 API Management 서비스가 Virtual Network 포함되지 않음을 의미하고, 외부는 API Management 배포가 인터넷 연결 엔드포인트가 있는 Virtual Network 내에 설정됨을 의미하며 내부는 API Management 배포는 인트라넷 연결 엔드포인트만 있는 Virtual Network 내에서 설정됩니다.

Name 형식 Description
External

string

이 서비스는 Virtual Network 일부이며 인터넷에서 액세스할 수 있습니다.

Internal

string

이 서비스는 Virtual Network 일부이며 가상 네트워크 내에서만 액세스할 수 있습니다.

None

string

서비스는 Virtual Network 일부가 아닙니다.