Partager via

Api Management Service - Get

  • Référence
Service:
API Management
Version d'API:
2022-08-01

Obtient une description de ressource de service Gestion des API.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}?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.

Modèle d’expression régulière: ^[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.

Réponses

Nom Type Description
200 OK

ApiManagementServiceResource

La ressource de service Gestion des API a été correctement obtenue.
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
Flux: implicit
URL d’autorisation: https://login.microsoftonline.com/common/oauth2/authorize

Étendues

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

Exemples

ApiManagementServiceGetMultiRegionInternalVnet
ApiManagementServiceGetService
ApiManagementServiceGetServiceHavingMsi

ApiManagementServiceGetMultiRegionInternalVnet

Exemple de requête

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

Exemple de réponse

Code d’état:
200 
{
  "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": {}
  },
  "sku": {
    "name": "Premium",
    "capacity": 1
  }
}

ApiManagementServiceGetService

Exemple de requête

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

Exemple de réponse

Code d’état:
200 
{
  "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/OGF-Z3-06162021-Premium",
  "name": "OGF-Z3-06162021-Premium",
  "type": "Microsoft.ApiManagement/service",
  "tags": {
    "owner": "v-aswmoh",
    "ReleaseName": "Z3"
  },
  "location": "East US",
  "etag": "AAAAAAAWN/4=",
  "properties": {
    "publisherEmail": "string",
    "publisherName": "Test Premium",
    "notificationSenderEmail": "apimgmt-noreply@mail.windowsazure.com",
    "provisioningState": "Succeeded",
    "targetProvisioningState": "",
    "createdAtUtc": "2021-06-16T09:40:00.9453556Z",
    "gatewayUrl": "https://ogf-z3-06162021-premium.azure-api.net",
    "gatewayRegionalUrl": "https://ogf-z3-06162021-premium-eastus-01.regional.azure-api.net",
    "portalUrl": "https://ogf-z3-06162021-premium.portal.azure-api.net",
    "developerPortalUrl": "https://ogf-z3-06162021-premium.developer.azure-api.net",
    "managementApiUrl": "https://ogf-z3-06162021-premium.management.azure-api.net",
    "scmUrl": "https://ogf-z3-06162021-premium.scm.azure-api.net",
    "hostnameConfigurations": [
      {
        "type": "Proxy",
        "hostName": "ogf-z3-06162021-premium.azure-api.net",
        "negotiateClientCertificate": false,
        "defaultSslBinding": false,
        "certificateSource": "BuiltIn"
      },
      {
        "type": "Proxy",
        "hostName": "gateway.current.int-azure-api.net",
        "keyVaultId": "https://ogf-testing.vault.azure.net/secrets/current-ssl",
        "negotiateClientCertificate": true,
        "certificate": {
          "expiry": "2022-01-08T22:32:32+00:00",
          "thumbprint": "BA0C286XXXXXXXX58A4A507E3DBD51",
          "subject": "CN=*.current.int-azure-api.net, O=Microsoft Corporation, L=Redmond, S=WA, C=US"
        },
        "defaultSslBinding": true,
        "certificateSource": "Custom"
      },
      {
        "type": "DeveloperPortal",
        "hostName": "developer.current.int-azure-api.net",
        "keyVaultId": "https://ogf-testing.vault.azure.net/secrets/current-ssl",
        "negotiateClientCertificate": false,
        "certificate": {
          "expiry": "2022-01-08T22:32:32+00:00",
          "thumbprint": "BA0C286XXXXXXXX58A4A507E3DBD51",
          "subject": "CN=*.current.int-azure-api.net, O=Microsoft Corporation, L=Redmond, S=WA, C=US"
        },
        "defaultSslBinding": false,
        "certificateSource": "Custom"
      },
      {
        "type": "Management",
        "hostName": "mgmt.current.int-azure-api.net",
        "keyVaultId": "https://ogf-testing.vault.azure.net/secrets/current-ssl",
        "negotiateClientCertificate": false,
        "certificate": {
          "expiry": "2022-01-08T22:32:32+00:00",
          "thumbprint": "BA0C286XXXXXXXX58A4A507E3DBD51",
          "subject": "CN=*.current.int-azure-api.net, O=Microsoft Corporation, L=Redmond, S=WA, C=US"
        },
        "defaultSslBinding": false,
        "certificateSource": "Custom"
      }
    ],
    "publicIPAddresses": [
      "13.92.130.49"
    ],
    "additionalLocations": [
      {
        "location": "East US 2",
        "sku": {
          "name": "Premium",
          "capacity": 1
        },
        "zones": [],
        "publicIPAddresses": [
          "40.70.24.106"
        ],
        "gatewayRegionalUrl": "https://ogf-z3-06162021-premium-eastus2-01.regional.azure-api.net",
        "disableGateway": false,
        "platformVersion": "stv2"
      }
    ],
    "customProperties": {
      "Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Ciphers.TripleDes168": "false",
      "Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Protocols.Tls11": "false",
      "Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Protocols.Tls10": "false",
      "Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Protocols.Ssl30": "false",
      "Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Backend.Protocols.Tls11": "false",
      "Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Backend.Protocols.Tls10": "false",
      "Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Backend.Protocols.Ssl30": "false",
      "Microsoft.WindowsAzure.ApiManagement.Gateway.Protocols.Server.Http2": "false"
    },
    "virtualNetworkType": "None",
    "certificates": [],
    "disableGateway": false,
    "apiVersionConstraint": {
      "minApiVersion": "2019-12-01"
    },
    "publicNetworkAccess": "Enabled",
    "privateEndpointConnections": [
      {
        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/privateEndpointConnections/privateEndpointProxyName",
        "type": "Microsoft.ApiManagement/service/privateEndpointConnections",
        "name": "privateEndpointProxyName",
        "properties": {
          "provisioningState": "Pending",
          "privateEndpoint": {
            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/privateEndpoints/privateEndpointName"
          },
          "privateLinkServiceConnectionState": {
            "status": "Pending",
            "description": "Please approve my request, thanks",
            "actionsRequired": "None"
          },
          "groupIds": [
            "Gateway"
          ]
        }
      }
    ],
    "platformVersion": "stv2"
  },
  "sku": {
    "name": "Premium",
    "capacity": 1
  },
  "identity": {
    "type": "SystemAssigned, UserAssigned",
    "principalId": "306205e7-b21a-41bf-92e2-3e28af30041e",
    "tenantId": "f686d426-8d16-42db-81b7-ab578e110ccd",
    "userAssignedIdentities": {
      "/subscriptions/subid/resourcegroups/rg1/providers/Microsoft.ManagedIdentity/userAssignedIdentities/ogf-identity": {
        "principalId": "713784d2-ee37-412a-95f0-3768f397f82d",
        "clientId": "8d9791f2-0cdf-41f4-9e66-cdc39b496789"
      }
    }
  },
  "systemData": {
    "createdBy": "string",
    "createdByType": "User",
    "createdAt": "2021-06-16T09:40:00.7106733Z",
    "lastModifiedBy": "foo@contoso.com",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2021-06-20T06:33:09.6159006Z"
  }
}

ApiManagementServiceGetServiceHavingMsi

Exemple de requête

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

Exemple de réponse

Code d’état:
200 
{
  "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1",
  "name": "apimService1",
  "type": "Microsoft.ApiManagement/service",
  "tags": {},
  "location": "West Europe",
  "etag": "AAAAAAAENfI=",
  "properties": {
    "publisherEmail": "foo@contoso.com",
    "publisherName": "Contoso",
    "notificationSenderEmail": "apimgmt-noreply@mail.windowsazure.com",
    "provisioningState": "Succeeded",
    "targetProvisioningState": "",
    "createdAtUtc": "2016-04-12T00:20:15.6018952Z",
    "gatewayUrl": "https://apimService1.azure-api.net",
    "gatewayRegionalUrl": "https://apimService1-westeurope-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": "proxy.msitesting.net",
        "keyVaultId": "https://samir-msi-keyvault.vault.azure.net/secrets/msicertificate",
        "negotiateClientCertificate": false,
        "certificate": {
          "expiry": "2020-12-18T11:11:47+00:00",
          "thumbprint": "9833D531D7A45XXXXXA85908BD3692E0BD3F",
          "subject": "CN=*.msitesting.net"
        },
        "defaultSslBinding": true,
        "certificateSource": "KeyVault"
      }
    ],
    "publicIPAddresses": [
      "13.94.xxx.188"
    ],
    "virtualNetworkConfiguration": {
      "subnetResourceId": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/virtualNetworks/dfVirtualNetwork/subnets/backendSubnet"
    },
    "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",
      "Microsoft.WindowsAzure.ApiManagement.Gateway.Protocols.Server.Http2": "False"
    },
    "virtualNetworkType": "External",
    "disableGateway": false
  },
  "sku": {
    "name": "Premium",
    "capacity": 1
  },
  "identity": {
    "type": "SystemAssigned, UserAssigned",
    "principalId": "ca1d33f7-0000-42ec-0000-d526a1ee953a",
    "tenantId": "72f988bf-0000-41af-0000-2d7cd011db47",
    "userAssignedIdentities": {
      "/subscriptions/subid/resourcegroups/rg1/providers/Microsoft.ManagedIdentity/userAssignedIdentities/apimService1": {
        "principalId": "95194df2-9208-0000-0000-a10d2af9b5a3",
        "clientId": "aaff9c7d-0000-4db2-0000-ab0e3e7806cf"
      }
    }
  }
}

Définitions

Nom Description
AdditionalLocation

Description d’un emplacement de ressource Gestion des API supplémentaire.
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 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 du certificat.
CertificateStatus

État du certificat.
createdByType

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

Contrat de 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é pour ce service Gestion des API. La valeur est facultative, mais si elle est transmise, doit être « Activé » ou « Désactivé ». 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 de 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é. Aucun (valeur par défaut) signifie que le service Gestion des API ne fait partie d’aucun Réseau virtuel, externe signifie que le déploiement Gestion des API est configuré à l’intérieur d’un Réseau virtuel ayant un point de terminaison accessible sur Internet, et interne signifie que Gestion des API Le déploiement est configuré à l’intérieur d’un Réseau virtuel ayant 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 la 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[]

Adresses IP d’équilibrage de charge statique privée du service Gestion des API déployé dans un Réseau virtuel interne dans un emplacement supplémentaire particulier. Disponible uniquement pour les références SKU De base, Standard, Premium et Isolé.
publicIPAddresses

string[]

Adresses IP publiques à charge statique équilibrée 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 Standard 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.

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 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 plus récente que 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 codé 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 du 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 de 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 des propriétés.
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 du 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 une plateforme multilocataire V1.
stv1

string

Plateforme exécutant le service sur une plateforme V1 à locataire unique.
stv2

string

Plateforme exécutant le service sur une plateforme v2 à locataire unique.
undetermined

string

La version de la plateforme ne peut pas être déterminée, 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

Motif 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é pour ce service Gestion des API. La valeur est facultative, mais si elle est transmise, doit être « Activé » ou « Désactivé ». 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 de 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 de 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 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 un GUID Null par défaut.

VirtualNetworkType

Type de VPN dans lequel Gestion des API service doit être configuré. Aucun (valeur par défaut) signifie que le service Gestion des API ne fait partie d’aucun Réseau virtuel, externe signifie que le déploiement Gestion des API est configuré à l’intérieur d’un Réseau virtuel ayant un point de terminaison accessible sur Internet, et interne signifie que Gestion des API Le déploiement est configuré à l’intérieur d’un Réseau virtuel ayant un point de terminaison intranet uniquement.

Nom Type Description
External

string

Le service fait partie de Réseau virtuel et 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’aucun Réseau virtuel.