Api Management Service - Apply Network Configuration Updates

リファレンス

Service:: API Management

API Version:: 2022-08-01

仮想ネットワークで実行されている Microsoft.ApiManagement リソースを更新して、更新された DNS の変更を選択します。

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

URI パラメーター

名前	/	必須	型	説明
resourceGroupName	path	True	string	リソースグループの名前。名前の大文字と小文字は区別されます。
serviceName	path	True	string	API Management サービスの名前。 Regex pattern: `^[a-zA-Z](?:[a-zA-Z0-9-]*[a-zA-Z0-9])?$`
subscriptionId	path	True	string	ターゲットサブスクリプションの ID。
api-version	query	True	string	この操作に使用する API バージョン。

要求本文

名前	型	説明
location	string	マルチリージョンサービス用に更新する Api Management サービスの場所。 1 つのリージョンにデプロイされたサービスの場合、このパラメーターは必要ありません。

応答

名前	型	説明
200 OK	ApiManagementServiceResource	ネットワーク構成の更新が Api Management サービスに正常に適用されました。
202 Accepted		受け入れ可能: Location ヘッダーには、実行時間の長い操作の状態を確認できる URL が含まれています。 Headers location: string
Other Status Codes	ErrorResponse	操作に失敗した理由を説明するエラー応答。

名前

型

説明

200 OK

ApiManagementServiceResource

ネットワーク構成の更新が Api Management サービスに正常に適用されました。

202 Accepted

受け入れ可能: Location ヘッダーには、実行時間の長い操作の状態を確認できる URL が含まれています。

Headers

location: string

Other Status Codes

ErrorResponse

操作に失敗した理由を説明するエラー応答。

セキュリティ

azure_auth

Azure Active Directory OAuth2 フロー。

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

名前	説明
user_impersonation	ユーザーアカウントの借用

例

ApiManagementApplyNetworkConfigurationUpdates

Sample Request

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

{
  "location": "west us"
}

import com.azure.resourcemanager.apimanagement.models.ApiManagementServiceApplyNetworkConfigurationParameters;

/** Samples for ApiManagementService ApplyNetworkConfigurationUpdates. */
public final class Main {
    /*
     * x-ms-original-file: specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2022-08-01/examples/ApiManagementApplyNetworkConfigurationUpdates.json
     */
    /**
     * Sample code: ApiManagementApplyNetworkConfigurationUpdates.
     *
     * @param manager Entry point to ApiManagementManager.
     */
    public static void apiManagementApplyNetworkConfigurationUpdates(
        com.azure.resourcemanager.apimanagement.ApiManagementManager manager) {
        manager
            .apiManagementServices()
            .applyNetworkConfigurationUpdates(
                "rg1",
                "apimService1",
                new ApiManagementServiceApplyNetworkConfigurationParameters().withLocation("west us"),
                com.azure.core.util.Context.NONE);
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

from azure.identity import DefaultAzureCredential
from azure.mgmt.apimanagement import ApiManagementClient

"""
# PREREQUISITES
    pip install azure-identity
    pip install azure-mgmt-apimanagement
# USAGE
    python api_management_apply_network_configuration_updates.py

    Before run the sample, please set the values of the client ID, tenant ID and client secret
    of the AAD application as environment variables: AZURE_CLIENT_ID, AZURE_TENANT_ID,
    AZURE_CLIENT_SECRET. For more info about how to get the value, please see:
    https://docs.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal
"""


def main():
    client = ApiManagementClient(
        credential=DefaultAzureCredential(),
        subscription_id="subid",
    )

    response = client.api_management_service.begin_apply_network_configuration_updates(
        resource_group_name="rg1",
        service_name="apimService1",
    ).result()
    print(response)


# x-ms-original-file: specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2022-08-01/examples/ApiManagementApplyNetworkConfigurationUpdates.json
if __name__ == "__main__":
    main()

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

package armapimanagement_test

import (
	"context"
	"log"

	"github.com/Azure/azure-sdk-for-go/sdk/azcore/to"
	"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
	"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/apimanagement/armapimanagement/v2"
)

// Generated from example definition: https://github.com/Azure/azure-rest-api-specs/blob/4cd95123fb961c68740565a1efcaa5e43bd35802/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2022-08-01/examples/ApiManagementApplyNetworkConfigurationUpdates.json
func ExampleServiceClient_BeginApplyNetworkConfigurationUpdates() {
	cred, err := azidentity.NewDefaultAzureCredential(nil)
	if err != nil {
		log.Fatalf("failed to obtain a credential: %v", err)
	}
	ctx := context.Background()
	clientFactory, err := armapimanagement.NewClientFactory("<subscription-id>", cred, nil)
	if err != nil {
		log.Fatalf("failed to create client: %v", err)
	}
	poller, err := clientFactory.NewServiceClient().BeginApplyNetworkConfigurationUpdates(ctx, "rg1", "apimService1", &armapimanagement.ServiceClientBeginApplyNetworkConfigurationUpdatesOptions{Parameters: &armapimanagement.ServiceApplyNetworkConfigurationParameters{
		Location: to.Ptr("west us"),
	},
	})
	if err != nil {
		log.Fatalf("failed to finish the request: %v", err)
	}
	res, err := poller.PollUntilDone(ctx, nil)
	if err != nil {
		log.Fatalf("failed to pull the result: %v", err)
	}
	// You could use response here. We use blank identifier for just demo purposes.
	_ = res
	// If the HTTP response code is 200 as defined in example definition, your response structure would look as follows. Please pay attention that all the values in the output are fake values for just demo purposes.
	// res.ServiceResource = armapimanagement.ServiceResource{
	// 	Name: to.Ptr("apimService1"),
	// 	Type: to.Ptr("Microsoft.ApiManagement/service"),
	// 	ID: to.Ptr("/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1"),
	// 	Tags: map[string]*string{
	// 		"UID": to.Ptr("52ed5986-717b-45b4-b17c-3df8db372cff"),
	// 	},
	// 	Etag: to.Ptr("AAAAAAAXX6Y="),
	// 	Location: to.Ptr("East Asia"),
	// 	Properties: &armapimanagement.ServiceProperties{
	// 		CreatedAtUTC: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2015-09-22T01:50:34.792Z"); return t}()),
	// 		GatewayURL: to.Ptr("https://apimService1.azure-api.net"),
	// 		HostnameConfigurations: []*armapimanagement.HostnameConfiguration{
	// 		},
	// 		ManagementAPIURL: to.Ptr("https://apimService1.management.azure-api.net"),
	// 		PortalURL: to.Ptr("https://apimService1.portal.azure-api.net"),
	// 		ProvisioningState: to.Ptr("Succeeded"),
	// 		PublicIPAddresses: []*string{
	// 			to.Ptr("207.46.155.24")},
	// 			ScmURL: to.Ptr("https://apimService1.scm.azure-api.net"),
	// 			TargetProvisioningState: to.Ptr(""),
	// 			VirtualNetworkConfiguration: &armapimanagement.VirtualNetworkConfiguration{
	// 				SubnetResourceID: to.Ptr("/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/virtualNetworks/eastUsVirtualNetwork/subnets/apimSubnet"),
	// 			},
	// 			VirtualNetworkType: to.Ptr(armapimanagement.VirtualNetworkTypeExternal),
	// 			PublisherEmail: to.Ptr("admin@live.com"),
	// 			PublisherName: to.Ptr("Contoso"),
	// 		},
	// 		SKU: &armapimanagement.ServiceSKUProperties{
	// 			Name: to.Ptr(armapimanagement.SKUTypePremium),
	// 			Capacity: to.Ptr[int32](1),
	// 		},
	// 	}
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

const { ApiManagementClient } = require("@azure/arm-apimanagement");
const { DefaultAzureCredential } = require("@azure/identity");

/**
 * This sample demonstrates how to Updates the Microsoft.ApiManagement resource running in the Virtual network to pick the updated DNS changes.
 *
 * @summary Updates the Microsoft.ApiManagement resource running in the Virtual network to pick the updated DNS changes.
 * x-ms-original-file: specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2022-08-01/examples/ApiManagementApplyNetworkConfigurationUpdates.json
 */
async function apiManagementApplyNetworkConfigurationUpdates() {
  const subscriptionId = process.env["APIMANAGEMENT_SUBSCRIPTION_ID"] || "subid";
  const resourceGroupName = process.env["APIMANAGEMENT_RESOURCE_GROUP"] || "rg1";
  const serviceName = "apimService1";
  const parameters = {
    location: "west us",
  };
  const options = {
    parameters,
  };
  const credential = new DefaultAzureCredential();
  const client = new ApiManagementClient(credential, subscriptionId);
  const result = await client.apiManagementService.beginApplyNetworkConfigurationUpdatesAndWait(
    resourceGroupName,
    serviceName,
    options
  );
  console.log(result);
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Sample Response

Status code:: 202

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

Status code:: 200

{
  "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1",
  "name": "apimService1",
  "type": "Microsoft.ApiManagement/service",
  "tags": {
    "UID": "52ed5986-717b-45b4-b17c-3df8db372cff"
  },
  "location": "East Asia",
  "etag": "AAAAAAAXX6Y=",
  "properties": {
    "publisherEmail": "admin@live.com",
    "publisherName": "Contoso",
    "provisioningState": "Succeeded",
    "targetProvisioningState": "",
    "createdAtUtc": "2015-09-22T01:50:34.7921566Z",
    "gatewayUrl": "https://apimService1.azure-api.net",
    "portalUrl": "https://apimService1.portal.azure-api.net",
    "managementApiUrl": "https://apimService1.management.azure-api.net",
    "scmUrl": "https://apimService1.scm.azure-api.net",
    "hostnameConfigurations": [],
    "publicIPAddresses": [
      "207.46.155.24"
    ],
    "virtualNetworkConfiguration": {
      "subnetResourceId": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/virtualNetworks/eastUsVirtualNetwork/subnets/apimSubnet"
    },
    "virtualNetworkType": "External"
  },
  "sku": {
    "name": "Premium",
    "capacity": 1
  }
}

定義

名前	説明
AdditionalLocation	追加のAPI Management リソースの場所の説明。
ApiManagementServiceApplyNetworkConfigurationParameters	ネットワーク構成の適用操作に指定されたパラメーター。
ApiManagementServiceIdentity	Api Management サービスリソースの ID プロパティ。
ApiManagementServiceResource	List または Get 応答の 1 つの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 ゲートウェイを有効にすることができます。
PlatformVersion	サービスを実行しているコンピューティングプラットフォームのバージョン。
PrivateEndpointServiceConnectionStatus	プライベートエンドポイント接続の状態。
PrivateLinkServiceConnectionState	サービスコンシューマーとプロバイダー間の接続の状態に関する情報のコレクション。
PublicNetworkAccess	このAPI Management サービスに対してパブリックエンドポイントアクセスが許可されるかどうか。値は省略可能ですが、渡される場合は、'Enabled' または 'Disabled' である必要があります。 "無効" の場合、プライベートエンドポイントは排他アクセス方法です。既定値は 'Enabled' です
RemotePrivateEndpointConnectionWrapper	リモートプライベートエンドポイント接続リソース。
SkuType	Sku の名前。
systemData	リソースの作成と最後の変更に関連するメタデータ。
UserIdentityProperties
VirtualNetworkConfiguration	API Management サービスがデプロイされる仮想ネットワークの構成。
VirtualNetworkType	API Management サービスを構成する必要がある VPN の種類。 None (既定値) は、API Management サービスがVirtual Networkに含まれていないことを意味し、External はインターネットに接続するエンドポイントを持つVirtual Network内にAPI Management展開が設定されていることを意味し、内部はAPI Management展開は、イントラネットに接続するエンドポイントのみを持つVirtual Network内で設定されます。

AdditionalLocation

追加のAPI Management リソースの場所の説明。

名前	型	既定値	説明
disableGateway	boolean	False	プロパティは、複数の場所にデプロイされた Api Management サービスに対してのみ有効です。これを使用して、この追加の場所でゲートウェイを無効にすることができます。
gatewayRegionalUrl	string		リージョン内のAPI Management サービスのゲートウェイ URL。
location	string		Azure データセンターリージョン間の追加リージョンの場所名。
natGatewayState	NatGatewayState	Disabled	プロパティを使用して、このAPI Management サービスの NAT ゲートウェイを有効にすることができます。
outboundPublicIPAddresses	string[]		NAT Gateway によってデプロイされたサービスに関連付けられている送信パブリック IPV4 アドレスプレフィックス。 stv2 プラットフォームの Premium SKU でのみ使用できます。
platformVersion	PlatformVersion		サービスを実行しているコンピューティングプラットフォームのバージョン。
privateIPAddresses	string[]		特定の追加の場所にある内部Virtual NetworkにデプロイされるAPI Management サービスのプライベート静的負荷分散 IP アドレス。 Basic、Standard、Premium、Isolated SKU でのみ使用できます。
publicIPAddresses	string[]		追加の場所にあるAPI Management サービスのパブリック静的負荷分散 IP アドレス。 Basic、Standard、Premium、Isolated SKU でのみ使用できます。
publicIpAddressId	string		場所にデプロイされたサービスVirtual Network関連付けるパブリック Standard SKU IP V4 ベースの IP アドレス。 Virtual Networkにデプロイされている Premium SKU でのみサポートされます。
sku	ApiManagementServiceSkuProperties		API Management サービスの SKU プロパティ。
virtualNetworkConfiguration	VirtualNetworkConfiguration		場所の仮想ネットワーク構成。
zones	string[]		リソースの取得元を表す可用性ゾーンの一覧。

ApiManagementServiceApplyNetworkConfigurationParameters

ネットワーク構成の適用操作に指定されたパラメーター。

名前	型	説明
location	string	マルチリージョンサービス用に更新する Api Management サービスの場所。 1 つのリージョンにデプロイされたサービスの場合、このパラメーターは必要ありません。

ApiManagementServiceIdentity

Api Management サービスリソースの ID プロパティ。

名前	型	説明
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

List または Get 応答の 1 つのAPI Management サービスリソース。

名前	型	既定値	説明
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 を除くすべての設定の既定値は、サービスが `True` 2018 年 4 月 1 日以前に作成された場合、 `False` それ以外の場合です。 Http2 設定の既定値はです `False`。設定を使用して、次のいずれかの暗号を `Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Ciphers.[cipher_name]`無効にすることができます: 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、 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 サービスに対してのみ有効です。これは、マスターリージョンのゲートウェイを無効にするために使用できます。
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 ゲートウェイを有効にすることができます。
properties.notificationSenderEmail	string		通知の送信先となるアドレスをEmailします。
properties.outboundPublicIPAddresses	string[]		NAT Gateway によってデプロイされたサービスに関連付けられている送信パブリック IPV4 アドレスプレフィックス。 stv2 プラットフォームの Premium SKU でのみ使用できます。
properties.platformVersion	PlatformVersion		この場所でサービスを実行しているコンピューティングプラットフォームのバージョン。
properties.portalUrl	string		API Management サービスのパブリッシャーポータルエンドポイント URL。
properties.privateEndpointConnections	RemotePrivateEndpointConnectionWrapper[]		このサービスのプライベートエンドポイント接続の一覧。
properties.privateIPAddresses	string[]		内部Virtual NetworkにデプロイされるプライマリリージョンのAPI Management サービスのプライベート静的負荷分散 IP アドレス。 Basic、Standard、Premium、Isolated SKU でのみ使用できます。
properties.provisioningState	string		API Management サービスの現在のプロビジョニング状態。次のいずれかになります。Created/Activating/Succeeded/Updating/Failed/Stopped/Terminating/TerminationFailed/Deleted。
properties.publicIPAddresses	string[]		プライマリリージョンのAPI Management サービスのパブリック静的負荷分散 IP アドレス。 Basic、Standard、Premium、Isolated SKU でのみ使用できます。
properties.publicIpAddressId	string		リージョンにデプロイされたサービスVirtual Network関連付けるパブリック Standard SKU IP V4 ベースの IP アドレス。 Virtual Networkにデプロイされている Developer SKU と Premium SKU でのみサポートされます。
properties.publicNetworkAccess	PublicNetworkAccess		このAPI Management サービスに対してパブリックエンドポイントアクセスが許可されるかどうか。値は省略可能ですが、渡される場合は、'Enabled' または '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 の種類。 None (既定値) は、API Management サービスがVirtual Networkに含まれていないことを意味し、External はインターネットに接続するエンドポイントを持つVirtual Network内にAPI Management展開が設定されていることを意味し、内部は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します。

名前	型	説明
capacity	integer	SKU の容量 (SKU のデプロイされたユニットの数)。従量課金 SKU の容量は 0 として指定する必要があります。
name	SkuType	Sku の名前。

ApimIdentityType

リソースに使用される ID の種類。種類 "SystemAssigned、UserAssigned" には、暗黙的に作成された ID とユーザー割り当て ID のセットの両方が含まれます。型 'None' は、サービスからすべての ID を削除します。

名前	型	説明
None	string
SystemAssigned	string
SystemAssigned, UserAssigned	string
UserAssigned	string

ApiVersionConstraint

API Management サービスのコントロールプレーン Api のバージョン制約。

名前	型	説明
minApiVersion	string	コントロールプレーン API 呼び出しを、この値以上のバージョンAPI Managementサービスに制限します。

ArmIdWrapper

ARM リソース ID のラッパー

名前	型	説明
id	string

CertificateConfiguration

信頼されていない中間証明書とルート証明書で構成される証明書の構成。

名前	型	説明
certificate	CertificateInformation	証明書情報。
certificatePassword	string	証明書のパスワード。
encodedCertificate	string	Base64 でエンコードされた証明書。
storeName	enum: CertificateAuthority Root	System.Security.Cryptography.x509certificates.StoreName 証明書ストアの場所。 Root と CertificateAuthority のみが有効な場所です。

CertificateInformation

SSL 証明書情報。

名前	型	説明
expiry	string	証明書の有効期限。日付は、ISO 8601 標準で指定されている形式 `yyyy-MM-ddTHH:mm:ssZ` に準拠しています。
subject	string	証明書のサブジェクト。
thumbprint	string	証明書の拇印。

CertificateSource

証明書のソース。

名前	型	説明
BuiltIn	string
Custom	string
KeyVault	string
Managed	string

CertificateStatus

証明書の状態。

名前	型	説明
Completed	string
Failed	string
InProgress	string

createdByType

リソースを作成した ID の種類。

名前	型	説明
Application	string
Key	string
ManagedIdentity	string
User	string

ErrorFieldContract

エラーフィールドコントラクト。

名前	型	説明
code	string	プロパティレベルのエラーコード。
message	string	プロパティレベルエラーの人間が判読できる表現。
target	string	プロパティ名。

ErrorResponse

エラー応答。

名前	型	説明
error.code	string	サービスによって定義されたエラーコード。このコードは、応答に指定された HTTP エラーコードのサブステータスとして機能します。
error.details	ErrorFieldContract[]	検証エラーが発生した場合に要求で送信される無効なフィールドの一覧。
error.message	string	人が判読できるエラーの表現。

HostnameConfiguration

カスタムホスト名の構成。

名前	型	既定値	説明
certificate	CertificateInformation		証明書情報。
certificatePassword	string		証明書のパスワード。
certificateSource	CertificateSource		証明書のソース。
certificateStatus	CertificateStatus		証明書の状態。
defaultSslBinding	boolean	False	このホスト名に関連付けられている証明書を既定の SSL 証明書として設定するには、true を指定します。クライアントが SNI ヘッダーを送信しない場合、これはチャレンジされる証明書になります。プロパティは、サービスで複数のカスタムホスト名が有効になっており、既定の ssl 証明書を決定する必要がある場合に便利です。設定は、ゲートウェイのホスト名の種類にのみ適用されます。
encodedCertificate	string		Base64 でエンコードされた証明書。
hostName	string		Api Management サービスで構成するホスト名。
identityClientId	string		Azure AD によって生成されたシステムまたはユーザー割り当てマネージド ID clientId。SSL 証明書を含む keyVault への GET アクセス権を持ちます。
keyVaultId	string		Ssl 証明書を含む KeyVault シークレットの URL。バージョンを含む絶対 URL が指定されている場合、ssl 証明書の自動更新は機能しません。そのためには、api Management サービスを aka.ms/apimmsi で構成する必要があります。シークレットの種類は application/x-pkcs12 である必要があります
negotiateClientCertificate	boolean	False	ホスト名のクライアント証明書を常にネゴシエートするには、true を指定します。既定値は false です。
type	HostnameType		ホスト名の種類。

HostnameType

ホスト名の種類。

名前	型	説明
DeveloperPortal	string
Management	string
Portal	string
Proxy	string
Scm	string

NatGatewayState

プロパティを使用して、このAPI Management サービスの NAT ゲートウェイを有効にすることができます。

名前	型	説明
Disabled	string	サービスに対して Nat Gateway が無効になっています。
Enabled	string	サービスに対して Nat Gateway が有効になっています。

PlatformVersion

サービスを実行しているコンピューティングプラットフォームのバージョン。

名前	型	説明
mtv1	string	マルチテナント V1 プラットフォームでサービスを実行しているプラットフォーム。
stv1	string	シングルテナント V1 プラットフォームでサービスを実行しているプラットフォーム。
stv2	string	シングルテナント V2 プラットフォームでサービスを実行しているプラットフォーム。
undetermined	string	コンピューティングプラットフォームがデプロイされていないため、プラットフォームのバージョンを特定できません。

PrivateEndpointServiceConnectionStatus

プライベートエンドポイント接続の状態。

名前	型	説明
Approved	string
Pending	string
Rejected	string

PrivateLinkServiceConnectionState

サービスコンシューマーとプロバイダー間の接続の状態に関する情報のコレクション。

名前	型	説明
actionsRequired	string	サービスプロバイダーの変更にコンシューマーに対する更新が必要かどうかを示すメッセージ。
description	string	接続の承認/拒否の理由。
status	PrivateEndpointServiceConnectionStatus	サービスの所有者によって接続が承認/拒否/削除されたかどうかを示します。

PublicNetworkAccess

このAPI Management サービスに対してパブリックエンドポイントアクセスが許可されるかどうか。値は省略可能ですが、渡される場合は、'Enabled' または 'Disabled' である必要があります。 "無効" の場合、プライベートエンドポイントは排他アクセス方法です。既定値は 'Enabled' です

名前	型	説明
Disabled	string
Enabled	string

RemotePrivateEndpointConnectionWrapper

リモートプライベートエンドポイント接続リソース。

名前	型	説明
id	string	プライベートエンドポイント接続リソース ID
name	string	プライベートエンドポイント接続名
properties.groupIds	string[]	すべてのグループ ID。
properties.privateEndpoint	ArmIdWrapper	プライベートエンドポイントのリソース。
properties.privateLinkServiceConnectionState	PrivateLinkServiceConnectionState	サービスコンシューマーとプロバイダー間の接続の状態に関する情報のコレクション。
properties.provisioningState	string	プライベートエンドポイント接続リソースのプロビジョニング状態。
type	string	プライベートエンドポイント接続リソースの種類

SkuType

Sku の名前。

名前	型	説明
Basic	string	Api Management の基本 SKU。
Consumption	string	Api Management の従量課金 SKU。
Developer	string	Api Management の開発者 SKU。
Isolated	string	Api Management の分離された SKU。
Premium	string	Api Management の Premium SKU。
Standard	string	Api Management の Standard SKU。

systemData

リソースの作成と最後の変更に関連するメタデータ。

名前	型	説明
createdAt	string	リソース作成のタイムスタンプ (UTC)。
createdBy	string	リソースを作成した ID。
createdByType	createdByType	リソースを作成した ID の種類。
lastModifiedAt	string	リソースの最終変更のタイムスタンプ (UTC)
lastModifiedBy	string	リソースを最後に変更した ID。
lastModifiedByType	createdByType	リソースを最後に変更した ID の種類。

UserIdentityProperties

名前	型	説明
clientId	string	ユーザー割り当て ID のクライアント ID。
principalId	string	ユーザー割り当て ID のプリンシパル ID。

VirtualNetworkConfiguration

API Management サービスがデプロイされる仮想ネットワークの構成。

名前	型	説明
subnetResourceId	string	API Management サービスをデプロイする仮想ネットワーク内のサブネットの完全なリソース ID。
subnetname	string	サブネットの名前。
vnetid	string	仮想ネットワーク ID。これは通常、GUID です。既定では null GUID が必要です。

VirtualNetworkType

API Management サービスを構成する必要がある VPN の種類。 None (既定値) は、API Management サービスがVirtual Networkに含まれていないことを意味し、External はインターネットに接続するエンドポイントを持つVirtual Network内にAPI Management展開が設定されていることを意味し、内部はAPI Management展開は、イントラネットに接続するエンドポイントのみを持つVirtual Network内で設定されます。

名前	型	説明
External	string	このサービスはVirtual Networkの一部であり、インターネットからアクセスできます。
Internal	string	サービスはVirtual Networkの一部であり、仮想ネットワーク内からのみアクセスできます。
None	string	サービスは、Virtual Networkの一部ではありません。

Api Management Service - Apply Network Configuration Updates

URI パラメーター

要求本文

応答

セキュリティ

azure_auth

Scopes

例

ApiManagementApplyNetworkConfigurationUpdates

Sample Request

Sample Response

定義

AdditionalLocation

ApiManagementServiceApplyNetworkConfigurationParameters

ApiManagementServiceIdentity

ApiManagementServiceResource

ApiManagementServiceSkuProperties

ApimIdentityType

ApiVersionConstraint

ArmIdWrapper

CertificateConfiguration

CertificateInformation

CertificateSource

CertificateStatus

createdByType

ErrorFieldContract

ErrorResponse

HostnameConfiguration

HostnameType

NatGatewayState

PlatformVersion

PrivateEndpointServiceConnectionStatus

PrivateLinkServiceConnectionState

PublicNetworkAccess

RemotePrivateEndpointConnectionWrapper

SkuType

systemData

UserIdentityProperties

VirtualNetworkConfiguration

VirtualNetworkType

その他のリソース