Api Management Service - Apply Network Configuration Updates

Référence

Service:: API Management

API Version:: 2022-08-01

Mises à jour la ressource Microsoft.ApiManagement en cours d’exécution dans le réseau virtuel pour sélectionner les modifications DNS mises à jour.

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

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
resourceGroupName	path	True	string	Nom du groupe de ressources. Le nom ne respecte pas la casse.
serviceName	path	True	string	Nom du service Gestion des API. Regex pattern: `^[a-zA-Z](?:[a-zA-Z0-9-]*[a-zA-Z0-9])?$`
subscriptionId	path	True	string	ID de l’abonnement cible.
api-version	query	True	string	Version de l’API à utiliser pour cette opération.

Corps de la demande

Nom	Type	Description
location	string	Emplacement du service Gestion des API à mettre à jour pour un service multirégion. Pour un service déployé dans une seule région, ce paramètre n’est pas obligatoire.

Réponses

Nom	Type	Description
200 OK	ApiManagementServiceResource	Les mises à jour de configuration réseau ont été appliquées avec succès sur le service Gestion des API.
202 Accepted		Accepté : l’en-tête Emplacement contient l’URL dans laquelle les status de l’opération de longue durée peuvent être vérifiées. Headers location: string
Other Status Codes	ErrorResponse	Réponse d’erreur décrivant la raison de l’échec de l’opération.

Nom

Type

Description

200 OK

ApiManagementServiceResource

Les mises à jour de configuration réseau ont été appliquées avec succès sur le service Gestion des API.

202 Accepted

Accepté : l’en-tête Emplacement contient l’URL dans laquelle les status de l’opération de longue durée peuvent être vérifiées.

Headers

location: string

Other Status Codes

ErrorResponse

Réponse d’erreur décrivant la raison de l’échec de l’opération.

Sécurité

azure_auth

Flux OAuth2 Azure Active Directory.

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

Scopes

Nom	Description
user_impersonation	Emprunter l’identité de votre compte d’utilisateur

Exemples

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
  }
}

Définitions

Nom	Description
AdditionalLocation	Description d’un emplacement de ressource Gestion des API supplémentaire.
ApiManagementServiceApplyNetworkConfigurationParameters	Paramètre fourni à l’opération de configuration Appliquer le réseau.
ApiManagementServiceIdentity	Propriétés d’identité de la ressource de service Gestion des API.
ApiManagementServiceResource	Une ressource de service Gestion des API unique dans la réponse List ou Get.
ApiManagementServiceSkuProperties	Gestion des API propriétés de la référence SKU de ressource de service.
ApimIdentityType	Type d’identité utilisé pour la ressource. Le type « SystemAssigned, UserAssigned » comprend à la fois une identité créée implicitement et un ensemble d’identités attribuées par l’utilisateur. Le type « None » supprime toutes les identités du service.
ApiVersionConstraint	Contrainte de version des API du plan de contrôle pour le service Gestion des API.
ArmIdWrapper	Wrapper pour un ID de ressource ARM
CertificateConfiguration	Configuration des certificats qui se composent d’intermédiaires non approuvés et de certificats racines.
CertificateInformation	Informations de certificat SSL.
CertificateSource	Source de certificat.
CertificateStatus	État du certificat.
createdByType	Type d’identité qui a créé la ressource.
ErrorFieldContract	Contrat champ d’erreur.
ErrorResponse	Réponse d’erreur.
HostnameConfiguration	Configuration de nom d’hôte personnalisée.
HostnameType	Type de nom d’hôte.
NatGatewayState	La propriété peut être utilisée pour activer la passerelle NAT pour ce service Gestion des API.
PlatformVersion	Version de la plateforme de calcul exécutant le service.
PrivateEndpointServiceConnectionStatus	La connexion de point de terminaison privé status.
PrivateLinkServiceConnectionState	Collection d’informations sur l’état de la connexion entre le consommateur de services et le fournisseur.
PublicNetworkAccess	Indique si l’accès au point de terminaison public est autorisé ou non pour ce service Gestion des API. La valeur est facultative, mais si elle est transmise, doit être « Enabled » ou « Disabled ». Si « Désactivé », les points de terminaison privés sont la méthode d’accès exclusif. La valeur par défaut est « Enabled »
RemotePrivateEndpointConnectionWrapper	Ressource connexion de point de terminaison privé distant.
SkuType	Nom de la référence SKU.
systemData	Métadonnées relatives à la création et à la dernière modification de la ressource.
UserIdentityProperties
VirtualNetworkConfiguration	Configuration d’un réseau virtuel sur lequel Gestion des API service est déployé.
VirtualNetworkType	Type de VPN dans lequel Gestion des API service doit être configuré. None (Valeur par défaut) signifie que le service Gestion des API ne fait partie d’aucun Réseau virtuel, External signifie que le déploiement Gestion des API est configuré à l’intérieur d’un Réseau virtuel disposant d’un point de terminaison internet, et Interne signifie que Gestion des API le déploiement est configuré à l’intérieur d’un Réseau virtuel disposant d’un point de terminaison intranet uniquement.

AdditionalLocation

Description d’un emplacement de ressource Gestion des API supplémentaire.

Nom	Type	Valeur par défaut	Description
disableGateway	boolean	False	Propriété valide uniquement pour un service Gestion des API déployé dans plusieurs emplacements. Vous pouvez l’utiliser pour désactiver la passerelle dans cet emplacement supplémentaire.
gatewayRegionalUrl	string		URL de passerelle du service Gestion des API dans la région.
location	string		Nom de l’emplacement de la région supplémentaire parmi les régions du centre de données Azure.
natGatewayState	NatGatewayState	Disabled	La propriété peut être utilisée pour activer la passerelle NAT pour ce service Gestion des API.
outboundPublicIPAddresses	string[]		Préfixes d’adresse IPV4 publics sortants associés au service déployé de passerelle NAT. Disponible uniquement pour la référence SKU Premium sur la plateforme stv2.
platformVersion	PlatformVersion		Version de la plateforme de calcul exécutant le service.
privateIPAddresses	string[]		Les adresses IP privées statiques équilibrées du service Gestion des API qui est déployé dans un Réseau virtuel interne à un emplacement supplémentaire particulier. Disponible uniquement pour les références SKU De base, Standard, Premium et Isolé.
publicIPAddresses	string[]		Adresses IP publiques statiques équilibrées du service Gestion des API à l’emplacement supplémentaire. Disponible uniquement pour les références SKU De base, Standard, Premium et Isolé.
publicIpAddressId	string		Adresse IP V4 de la référence SKU SKU publique à associer à Réseau virtuel service déployé à l’emplacement. Pris en charge uniquement pour la référence SKU Premium déployée dans Réseau virtuel.
sku	ApiManagementServiceSkuProperties		Propriétés de la référence SKU du service Gestion des API.
virtualNetworkConfiguration	VirtualNetworkConfiguration		Configuration du réseau virtuel pour l’emplacement.
zones	string[]		Liste des zones de disponibilité indiquant d’où doit provenir la ressource.

ApiManagementServiceApplyNetworkConfigurationParameters

Paramètre fourni à l’opération de configuration Appliquer le réseau.

Nom	Type	Description
location	string	Emplacement du service Gestion des API à mettre à jour pour un service multirégion. Pour un service déployé dans une seule région, ce paramètre n’est pas obligatoire.

ApiManagementServiceIdentity

Propriétés d’identité de la ressource de service Gestion des API.

Nom	Type	Description
principalId	string	ID principal de l’identité.
tenantId	string	ID de locataire client de l’identité.
type	ApimIdentityType	Type d’identité utilisé pour la ressource. Le type « SystemAssigned, UserAssigned » comprend à la fois une identité créée implicitement et un ensemble d’identités attribuées par l’utilisateur. Le type « None » supprime toutes les identités du service.
userAssignedIdentities	<string, UserIdentityProperties>	Liste des identités d’utilisateur associées à la ressource. Les références de clé de dictionnaire d’identité utilisateur sont des ID de ressource ARM au format « /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/ providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName} ».

ApiManagementServiceResource

Une ressource de service Gestion des API unique dans la réponse List ou Get.

Nom	Type	Valeur par défaut	Description
etag	string		ETag de la ressource.
id	string		ID de la ressource
identity	ApiManagementServiceIdentity		Identité de service managée du service Gestion des API.
location	string		Emplacement de la ressource.
name	string		Nom de la ressource.
properties.additionalLocations	AdditionalLocation[]		Emplacements de centre de données supplémentaires du service Gestion des API.
properties.apiVersionConstraint	ApiVersionConstraint		Contrainte de version des API du plan de contrôle pour le service Gestion des API.
properties.certificates	CertificateConfiguration[]		Liste des certificats qui doivent être installés dans le service Gestion des API. Le nombre maximal de certificats pris en charge pouvant être installés est de 10.
properties.createdAtUtc	string		Date de création UTC du service Gestion des API. La date est conforme au format suivant : `yyyy-MM-ddTHH:mm:ssZ` tel que spécifié par la norme ISO 8601.
properties.customProperties	object		Propriétés personnalisées du service Gestion des API. Le paramètre `Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Ciphers.TripleDes168` désactive le TLS_RSA_WITH_3DES_EDE_CBC_SHA de chiffrement pour tous les TLS(1.0, 1.1 et 1.2). Le paramètre `Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Protocols.Tls11` peut être utilisé pour désactiver uniquement TLS 1.1. Le paramètre `Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Protocols.Tls10` peut être utilisé pour désactiver TLS 1.0 sur un service Gestion des API. Le paramètre `Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Backend.Protocols.Tls11` peut être utilisé pour désactiver uniquement TLS 1.1 pour les communications avec les back-ends. Le paramètre `Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Backend.Protocols.Tls10` peut être utilisé pour désactiver TLS 1.0 pour les communications avec les back-ends. Le paramètre `Microsoft.WindowsAzure.ApiManagement.Gateway.Protocols.Server.Http2` peut être utilisé pour activer le protocole HTTP2 sur un service Gestion des API. Si vous ne spécifiez aucune de ces propriétés lors de l’opération PATCH, les valeurs par défaut des propriétés omises sont réinitialisées. Pour tous les paramètres à l’exception de Http2, la valeur par défaut est `True` si le service a été créé le 1er avril 2018 ou avant le 1er avril 2018, sinon `False` . La valeur par défaut du paramètre Http2 est `False`. Vous pouvez désactiver l’un des chiffrements suivants à l’aide des paramètres `Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Ciphers.[cipher_name]`suivants : 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. Par exemple, `Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Ciphers.TLS_RSA_WITH_AES_128_CBC_SHA256`:`false`. La valeur par défaut est `true` pour eux. Remarque : Les chiffrements suivants ne peuvent pas être désactivés, car ils sont requis par les composants de plateforme internes : 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		URL du point de terminaison du portail DEveloper du service Gestion des API.
properties.disableGateway	boolean	False	Propriété valide uniquement pour un service Gestion des API déployé dans plusieurs emplacements. Vous pouvez l’utiliser pour désactiver la passerelle dans master région.
properties.enableClientCertificate	boolean	False	Propriété destinée uniquement à être utilisée pour le service SKU Consommation. Cela applique un certificat client à présenter à chaque demande à la passerelle. Cela permet également d’authentifier le certificat dans la stratégie sur la passerelle.
properties.gatewayRegionalUrl	string		URL de passerelle du service Gestion des API dans la région par défaut.
properties.gatewayUrl	string		URL de passerelle du service Gestion des API.
properties.hostnameConfigurations	HostnameConfiguration[]		Configuration de nom d’hôte personnalisée du service Gestion des API.
properties.managementApiUrl	string		URL du point de terminaison de l’API de gestion du service Gestion des API.
properties.natGatewayState	NatGatewayState	Disabled	La propriété peut être utilisée pour activer la passerelle NAT pour ce service Gestion des API.
properties.notificationSenderEmail	string		Email adresse à partir de laquelle la notification sera envoyée.
properties.outboundPublicIPAddresses	string[]		Préfixes d’adresse IPV4 publics sortants associés au service déployé de passerelle NAT. Disponible uniquement pour la référence SKU Premium sur la plateforme stv2.
properties.platformVersion	PlatformVersion		Version de la plateforme de calcul exécutant le service à cet emplacement.
properties.portalUrl	string		Url du point de terminaison du portail de publication du service Gestion des API.
properties.privateEndpointConnections	RemotePrivateEndpointConnectionWrapper[]		Liste des connexions de point de terminaison privé de ce service.
properties.privateIPAddresses	string[]		Adresses IP à charge statique équilibrée privée du service Gestion des API dans la région principale qui est déployé dans un Réseau virtuel interne. Disponible uniquement pour les références SKU De base, Standard, Premium et Isolé.
properties.provisioningState	string		État d’approvisionnement actuel du service Gestion des API qui peut être l’un des suivants : Créé/Activation/Réussi/Mise à jour/Échec/Arrêté/Fin/TerminationFailed/Deleted.
properties.publicIPAddresses	string[]		Adresses IP publiques statiques équilibrées du service Gestion des API dans la région principale. Disponible uniquement pour les références SKU De base, Standard, Premium et Isolé.
properties.publicIpAddressId	string		Adresse IP V4 de la référence SKU SKU publique à associer à Réseau virtuel service déployé dans la région. Pris en charge uniquement pour les références SKU Développeur et Premium déployées dans Réseau virtuel.
properties.publicNetworkAccess	PublicNetworkAccess		Indique si l’accès au point de terminaison public est autorisé ou non pour ce service Gestion des API. La valeur est facultative, mais si elle est transmise, doit être « Enabled » ou « Disabled ». Si « Désactivé », les points de terminaison privés sont la méthode d’accès exclusif. La valeur par défaut est « Enabled »
properties.publisherEmail	string		E-mail de l’éditeur.
properties.publisherName	string		Nom de l’éditeur.
properties.restore	boolean	False	Annulez la suppression du service de gestion des API s’il a été précédemment supprimé de manière réversible. Si cet indicateur est spécifié et défini sur True, toutes les autres propriétés seront ignorées.
properties.scmUrl	string		URL du point de terminaison SCM du service Gestion des API.
properties.targetProvisioningState	string		État d’approvisionnement du service Gestion des API, qui est ciblé par l’opération de longue durée démarrée sur le service.
properties.virtualNetworkConfiguration	VirtualNetworkConfiguration		Configuration du réseau virtuel du service Gestion des API.
properties.virtualNetworkType	VirtualNetworkType	None	Type de VPN dans lequel Gestion des API service doit être configuré. None (Valeur par défaut) signifie que le service Gestion des API ne fait partie d’aucun Réseau virtuel, External signifie que le déploiement Gestion des API est configuré à l’intérieur d’un Réseau virtuel disposant d’un point de terminaison internet, et Interne signifie que Gestion des API le déploiement est configuré à l’intérieur d’un Réseau virtuel disposant d’un point de terminaison intranet uniquement.
sku	ApiManagementServiceSkuProperties		Propriétés de la référence SKU du service Gestion des API.
systemData	systemData		Métadonnées relatives à la création et à la dernière modification de la ressource.
tags	object		Balises de ressource.
type	string		Type de ressource pour Gestion des API ressource est défini sur Microsoft.ApiManagement.
zones	string[]		Liste des zones de disponibilité indiquant d’où doit provenir la ressource.

ApiManagementServiceSkuProperties

Gestion des API propriétés de la référence SKU de ressource de service.

Nom	Type	Description
capacity	integer	Capacité de la référence SKU (nombre d’unités déployées de la référence SKU). Pour Consommation, la capacité de référence SKU doit être spécifiée comme 0.
name	SkuType	Nom de la référence SKU.

ApimIdentityType

Type d’identité utilisé pour la ressource. Le type « SystemAssigned, UserAssigned » comprend à la fois une identité créée implicitement et un ensemble d’identités attribuées par l’utilisateur. Le type « None » supprime toutes les identités du service.

Nom	Type	Description
None	string
SystemAssigned	string
SystemAssigned, UserAssigned	string
UserAssigned	string

ApiVersionConstraint

Contrainte de version des API du plan de contrôle pour le service Gestion des API.

Nom	Type	Description
minApiVersion	string	Limitez les appels d’API de plan de contrôle à Gestion des API service dont la version est égale ou supérieure à cette valeur.

ArmIdWrapper

Wrapper pour un ID de ressource ARM

Nom	Type	Description
id	string

CertificateConfiguration

Configuration des certificats qui se composent d’intermédiaires non approuvés et de certificats racines.

Nom	Type	Description
certificate	CertificateInformation	Informations sur le certificat.
certificatePassword	string	Mot de passe du certificat.
encodedCertificate	string	Certificat encodé en Base64.
storeName	enum: CertificateAuthority Root	Emplacement du magasin de certificats System.Security.Cryptography.x509certificates.StoreName. Seuls root et CertificateAuthority sont des emplacements valides.

CertificateInformation

Informations de certificat SSL.

Nom	Type	Description
expiry	string	Date d’expiration du certificat. La date est conforme au format suivant : `yyyy-MM-ddTHH:mm:ssZ` tel que spécifié par la norme ISO 8601.
subject	string	Objet du certificat.
thumbprint	string	Empreinte numérique du certificat.

CertificateSource

Source de certificat.

Nom	Type	Description
BuiltIn	string
Custom	string
KeyVault	string
Managed	string

CertificateStatus

État du certificat.

Nom	Type	Description
Completed	string
Failed	string
InProgress	string

createdByType

Type d’identité qui a créé la ressource.

Nom	Type	Description
Application	string
Key	string
ManagedIdentity	string
User	string

ErrorFieldContract

Contrat champ d’erreur.

Nom	Type	Description
code	string	Code d'erreur de niveau propriété.
message	string	Représentation lisible par l’homme de l’erreur au niveau de la propriété.
target	string	Nom de propriété.

ErrorResponse

Réponse d’erreur.

Nom	Type	Description
error.code	string	Code d'erreur défini par le service. Ce code sert de sous-état pour le code d'erreur HTTP spécifié dans la réponse.
error.details	ErrorFieldContract[]	Liste des champs non valides envoyés dans la demande, en cas d’erreur de validation.
error.message	string	Représentation contrôlable de visu de l’erreur.

HostnameConfiguration

Configuration de nom d’hôte personnalisée.

Nom	Type	Valeur par défaut	Description
certificate	CertificateInformation		Informations sur le certificat.
certificatePassword	string		Mot de passe du certificat.
certificateSource	CertificateSource		Source de certificat.
certificateStatus	CertificateStatus		État du certificat.
defaultSslBinding	boolean	False	Spécifiez true pour configurer le certificat associé à ce nom d’hôte en tant que certificat SSL par défaut. Si un client n’envoie pas l’en-tête SNI, il s’agit du certificat qui sera contesté. La propriété est utile si un service a plusieurs noms d’hôte personnalisés activés et qu’il doit décider du certificat ssl par défaut. Paramètre appliqué uniquement au type de nom d’hôte de la passerelle.
encodedCertificate	string		Certificat encodé en Base64.
hostName	string		Nom d’hôte à configurer sur le service Gestion des API.
identityClientId	string		ClientId d’identité managée affectée par le système ou l’utilisateur, généré par Azure AD, qui dispose d’un accès GET au keyVault contenant le certificat SSL.
keyVaultId	string		Url du secret KeyVault contenant le certificat SSL. Si l’URL absolue contenant la version est fournie, la mise à jour automatique du certificat ssl ne fonctionnera pas. Pour cela, le service Gestion des API doit être configuré avec aka.ms/apimmsi. Le secret doit être de type application/x-pkcs12
negotiateClientCertificate	boolean	False	Spécifiez true pour toujours négocier le certificat client sur le nom d’hôte. La valeur par défaut est false.
type	HostnameType		Type de nom d’hôte.

HostnameType

Type de nom d’hôte.

Nom	Type	Description
DeveloperPortal	string
Management	string
Portal	string
Proxy	string
Scm	string

NatGatewayState

La propriété peut être utilisée pour activer la passerelle NAT pour ce service Gestion des API.

Nom	Type	Description
Disabled	string	Nat Gateway est désactivé pour le service.
Enabled	string	Nat Gateway est activé pour le service.

PlatformVersion

Version de la plateforme de calcul exécutant le service.

Nom	Type	Description
mtv1	string	Plateforme exécutant le service sur la plateforme multilocataire V1.
stv1	string	Plateforme exécutant le service sur la plateforme v1 à locataire unique.
stv2	string	Plateforme exécutant le service sur la plateforme V2 à locataire unique.
undetermined	string	Impossible de déterminer la version de la plateforme, car la plateforme de calcul n’est pas déployée.

PrivateEndpointServiceConnectionStatus

La connexion de point de terminaison privé status.

Nom	Type	Description
Approved	string
Pending	string
Rejected	string

PrivateLinkServiceConnectionState

Collection d’informations sur l’état de la connexion entre le consommateur de services et le fournisseur.

Nom	Type	Description
actionsRequired	string	Message indiquant si les modifications apportées au fournisseur de services nécessitent des mises à jour sur le consommateur.
description	string	Raison de l’approbation/du rejet de la connexion.
status	PrivateEndpointServiceConnectionStatus	Indique si la connexion a été approuvée/rejetée/supprimée par le propriétaire du service.

PublicNetworkAccess

Indique si l’accès au point de terminaison public est autorisé ou non pour ce service Gestion des API. La valeur est facultative, mais si elle est transmise, doit être « Enabled » ou « Disabled ». Si « Désactivé », les points de terminaison privés sont la méthode d’accès exclusif. La valeur par défaut est « Enabled »

Nom	Type	Description
Disabled	string
Enabled	string

RemotePrivateEndpointConnectionWrapper

Ressource connexion de point de terminaison privé distant.

Nom	Type	Description
id	string	ID de ressource de connexion de point de terminaison privé
name	string	Nom de la connexion du point de terminaison privé
properties.groupIds	string[]	Tous les ID de groupe.
properties.privateEndpoint	ArmIdWrapper	Ressource du point de terminaison privé.
properties.privateLinkServiceConnectionState	PrivateLinkServiceConnectionState	Collection d’informations sur l’état de la connexion entre le consommateur de services et le fournisseur.
properties.provisioningState	string	État d’approvisionnement de la ressource de connexion de point de terminaison privé.
type	string	Type de ressource de connexion de point de terminaison privé

SkuType

Nom de la référence SKU.

Nom	Type	Description
Basic	string	Référence SKU de base de Gestion des API.
Consumption	string	Référence SKU de consommation de Gestion des API.
Developer	string	Référence SKU développeur de Gestion des API.
Isolated	string	Référence SKU isolée de gestion des API.
Premium	string	Référence SKU Premium de gestion des API.
Standard	string	Référence SKU standard de gestion des API.

systemData

Métadonnées relatives à la création et à la dernière modification de la ressource.

Nom	Type	Description
createdAt	string	Horodatage de la création de ressources (UTC).
createdBy	string	Identité qui a créé la ressource.
createdByType	createdByType	Type d’identité qui a créé la ressource.
lastModifiedAt	string	Horodatage de la dernière modification de la ressource (UTC)
lastModifiedBy	string	Identité qui a modifié la dernière ressource.
lastModifiedByType	createdByType	Type d’identité qui a modifié la dernière ressource.

UserIdentityProperties

Nom	Type	Description
clientId	string	ID client de l’identité affectée par l’utilisateur.
principalId	string	ID principal de l’identité affectée par l’utilisateur.

VirtualNetworkConfiguration

Configuration d’un réseau virtuel sur lequel Gestion des API service est déployé.

Nom	Type	Description
subnetResourceId	string	ID de ressource complet d’un sous-réseau dans un réseau virtuel dans lequel déployer le service Gestion des API.
subnetname	string	Nom du sous-réseau.
vnetid	string	ID de réseau virtuel. Il s’agit généralement d’un GUID. Attendez-vous à un GUID null par défaut.

VirtualNetworkType

Type de VPN dans lequel Gestion des API service doit être configuré. None (Valeur par défaut) signifie que le service Gestion des API ne fait partie d’aucun Réseau virtuel, External signifie que le déploiement Gestion des API est configuré à l’intérieur d’un Réseau virtuel disposant d’un point de terminaison internet, et Interne signifie que Gestion des API le déploiement est configuré à l’intérieur d’un Réseau virtuel disposant d’un point de terminaison intranet uniquement.

Nom	Type	Description
External	string	Le service fait partie de Réseau virtuel et il est accessible à partir d’Internet.
Internal	string	Le service fait partie de Réseau virtuel et n’est accessible qu’à partir du réseau virtuel.
None	string	Le service ne fait partie d’aucune Réseau virtuel.

Share via

Api Management Service - Apply Network Configuration Updates

Paramètres URI

Corps de la demande

Réponses

Sécurité

azure_auth

Scopes

Exemples

ApiManagementApplyNetworkConfigurationUpdates

Sample Request

Sample Response

Définitions

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

Ressources supplémentaires